skill-tag-taxonomist

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.json or 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.