Skill Tag Taxonomist
Propose and audit tag assignments for repository skills and catalog entries.
Scope: Tag inference and reporting only. Does not edit generated catalog indexes or authoring MDX.
Dispatch
| $ARGUMENTS | Action |
|---|---|
<name> |
Tag report for one skill |
repo / --all |
Tag matrix for all repo skills |
--format json |
Machine-readable report |
| Empty | Show tag heuristics and example commands |
Tag Heuristics
| Tag | Signal |
|---|---|
conventions |
Name or description mentions conventions, standards, lint |
orchestration |
orchestrator, delegate, ensemble, workflow |
security |
security, audit, scanner, quarantine |
docs |
docs, readme, steward, catalog |
mcp |
mcp, server, registry |
eval |
eval, scaffold, adequacy |
Workflow
uv run python skills/skill-tag-taxonomist/scripts/tag_report.py <name>
uv run python skills/skill-tag-taxonomist/scripts/tag_report.py --all --format json
Apply tag changes in docs/src/authoring/skills/<id>.mdx or skill metadata — not via generated catalog pages.
Validation Contract
uv run python skills/skill-tag-taxonomist/scripts/check.py
Critical Rules
- Treat inferred tags as proposals until a maintainer confirms them.
- Never hand-edit
skills-catalog-index.jsonor generated catalog MDX. - Prefer kebab-case tag ids aligned with docs catalog routes.
- Pair tag audits with skill-compat-matrix for harness-specific caveats.
- Route catalog authoring edits to docs-steward after human review.