maintainer-label-system
Automates the maintenance and auditing of repository labels and label-based workflow rules.
Install
mkdir -p .claude/skills/maintainer-label-system && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10646" && unzip -o skill.zip -d .claude/skills/maintainer-label-system && rm skill.zipInstalls to .claude/skills/maintainer-label-system
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Maintain iccDEV repository labels, path labeler rules, issue triage labels, PR CI status labels, and label workflow governance.Key capabilities
- →Update repository labels
- →Configure path-based labeler rules
- →Manage issue triage labels
- →Audit PR CI status labels
- →Govern label workflow policies
How it works
The system uses shell scripts to synchronize label definitions and path-based rules with the repository configuration. It enforces security by keeping workflows on trusted metadata and avoiding direct execution of PR-provided code.
Inputs & outputs
When to use maintainer-label-system
- →Updating label taxonomy
- →Configuring labeler rules
- →Auditing label automation
- →Managing PR status labels
About this skill
Maintainer Label System
Use this skill when adding, removing, or auditing labels and label automation.
Required Inputs
- The branch or PR being changed.
- Whether the change is taxonomy-only, path-label automation, issue triage, PR status labeling, or CodeQL label routing.
- Any labels that must remain stable for existing issues, PRs, or workflows.
Workflow
- Read
../../../docs/label-system.md. - Audit the managed manifest against live labels before changing taxonomy.
.github/labels.ymlis not destructive: classify undeclared live labels as legacy or migrate them deliberately. - Update
.github/labels.ymlbefore changing workflow or labeler behavior. - Add
.github/labeler.ymlrules only for deterministic file paths or branch names. Do not classify severity, exploitability, or maintainer judgment from PR text. - Keep privileged label workflows on trusted metadata:
- no checkout of PR head code in
pull_request_target; - explicit
zizmorrationale for any retainedpull_request_targetlabeler; - least-privilege job permissions;
- pinned third-party actions;
- no direct
${{ }}expressions inside shell.
- no checkout of PR head code in
- Keep issue triage and PR-status labeling independent of taxonomy synchronization; neither may issue manifest-wide label writes for every issue or PR event.
- If issue triage logic changes, keep it conservative and make labels easy for maintainers to override.
- If PR status labels change, preserve mutual exclusion among
passed,failed, andpending. Require a completed successfulPR Summarycheck run on the current head or a verified explicit commit status from a successful trustedmasterdispatch; lightweight checks are not validation. Skip unchanged labels, recheck the head before writes, and expose write failures. Runpython3 .github/tests/test_ci_rebase_policy.py. - If PR CI control labels change, keep them maintainer-only and restricted
to open same-repository PRs targeting
master. Recheck the actor's current repository permission and event head, then dispatchci-pr-actionfrom the trustedmasterworkflow with PR number and expected head SHA.ci:run-auto,ci:full,ci:fast-lane, and bounded option labels select their documented scopes. The separateci-codeql-securityworkflow handlesci:codeqlandcodeql-readyand runs full CodeQL;ci:skipmust not publish successfulPR Summary. Clear one-shot labels only after their authorized dispatch or skip action succeeds. A same-repositorysynchronizeevent starts the bounded fast lane; a trusted metadata-onlyworkflow_runrefreshes status labels after validation. It must never check out or execute PR head content. - Update docs, prompts, agents, and the inventory artifact when policy or maintainer workflow changes.
- For a new scope label, add its canonical
.github/labels.ymlentry before issue-text or path automation. Keep deletion manual after checking all active label consumers.
Validation
bash -n .github/scripts/sync-labels.sh
GH_REPOSITORY=InternationalColorConsortium/iccDEV \
.github/scripts/sync-labels.sh --dry-run
yamllint -d '{extends: default, rules: {document-start: disable, truthy: disable, line-length: {max: 120}}}' .github/labels.yml .github/labeler.yml
jactionlint --profile correctness --no-color .github/workflows/pr-labeler.yml .github/workflows/sync-labels.yml .github/workflows/label.yml .github/workflows/update-labels.yml .github/workflows/ci-maintainer-pr-dispatch.yml .github/workflows/ci-pr-action.yml .github/workflows/ci-codeql-security.yml
zizmor .github/workflows/pr-labeler.yml .github/workflows/sync-labels.yml .github/workflows/label.yml .github/workflows/update-labels.yml .github/workflows/ci-maintainer-pr-dispatch.yml .github/workflows/ci-pr-action.yml .github/workflows/ci-codeql-security.yml
python3 -m pytest .github/tests/test_ci_maintainer_label_dispatch.py
python3 .github/tests/test_ci_rebase_policy.py
python3 -m pytest .github/tests/test_ci_status_labeler_dispatch.py
git diff --check
For workflow governance changes, also run:
.github/scripts/preflight-safety-checks.sh
Review Checklist
.github/labels.ymlcontains every automated label.- Managed labels are reconciled with the live inventory without deleting legacy labels or rewriting unchanged metadata.
.github/labeler.ymlpaths are specific enough to avoid noisy labels.- Large PR safeguards still exist.
- Label workflows do not execute untrusted PR content.
- Completion-triggered status labeling uses only default-branch metadata and
verifies current-head validation before
Merge Ready. - Status labels remain machine-managed and mutually exclusive.
- PR CI control labels are documented, canonical in
.github/labels.yml, and unavailable to fork PR fast lanes. bump-sha-pinsis documented as a maintainer follow-up label for pinned GitHub Action, Docker, or container SHA refreshes.ci:codeqlandcodeql-readyroute to the full CodeQL workflow.ci:skipcannot satisfy the protectedPR Summarycontext.- Documentation, skills, and prompts point to the same canonical files.
- The label-triage agent and inventory artifact match the managed manifest.
References
../../../docs/label-system.md../../labeler.yml../../labels.yml../../workflows/pr-labeler.yml../../workflows/sync-labels.yml../../workflows/label.yml../../workflows/update-labels.yml../../workflows/ci-maintainer-pr-dispatch.yml../../workflows/ci-pr-action.yml../../workflows/ci-codeql-security.yml../../instructions/workflow-governance.instructions.md../../prompts/maintainer-label-triage.prompt.md
When not to use it
- →Classifying severity or exploitability from PR text
- →Executing untrusted PR content in label workflows
Prerequisites
Limitations
- →Requires maintainer-only control for CI labels
- →Labeler rules must be deterministic
How it compares
Unlike manual label management, this system automates label taxonomy and routing through version-controlled YAML files and pre-flight safety checks.
Compared to similar skills
maintainer-label-system side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| maintainer-label-system (this skill) | 0 | 6mo | Review | Intermediate |
| glab | 6 | 6mo | Review | Intermediate |
| azure-devops-cli | 4 | 8mo | Review | Beginner |
| gitlab-ci-patterns | 10 | 7mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by InternationalColorConsortium
View all by InternationalColorConsortium →You might also like
glab
NikiforovAll
Expert guidance for using the GitLab CLI (glab) to manage GitLab issues, merge requests, CI/CD pipelines, repositories, and other GitLab operations from the command line. Use this skill when the user needs to interact with GitLab resources or perform GitLab workflows.
azure-devops-cli
github
Manage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoints. Use when working with Azure DevOps, az commands, devops automation, CI/CD, or when user mentions Azure DevOps CLI.
gitlab-ci-patterns
wshobson
Build GitLab CI/CD pipelines with multi-stage workflows, caching, and distributed runners for scalable automation. Use when implementing GitLab CI/CD, optimizing pipeline performance, or setting up automated testing and deployment.
update-go-version
grafana
Update Go version across the Tempo codebase (go.mod, tools/go.mod, Dockerfile, CI workflows, tools image tag)
repository-module-architecture
TencentBlueKing
Repository 代码库管理模块架构指南,涵盖 Git/SVN 代码库接入、Webhook 配置、代码库授权、触发器管理。当用户开发代码库功能、配置 Webhook、处理代码库授权或实现触发器逻辑时使用。
agent-ops-cicd-github
ruvnet
Agent skill for ops-cicd-github - invoke with $agent-ops-cicd-github