What's broken
Summary
The validator tool was renamed from skill-validator (CLI skill-validate)
to skill-and-tool-validator (CLI skill-and-tool-validate), but several
docs and specs under tools/spec-loop/ still use the old name. The commands
they print no longer run. Update the stale references to the new name.
Background
tools/skill-validator/ no longer exists; the tool now lives at
tools/skill-and-tool-validator/ and its CLI is skill-and-tool-validate
(see tools/skill-and-tool-validator/README.md, and the already-correct
entries in docs/labels-and-capabilities.md). The spec-loop docs were not
updated in the rename, so anyone copy-pasting a uv run --project tools/skill-validator ... skill-validate command from a spec hits a
non-existent project.
Where to look
Let grep be the source of truth, since line numbers drift:
git grep -nE "skill-validator|skill-validate\b" -- ':!tools/skill-and-tool-validator' | grep -v skill-and-tool
As of now that surfaces references in tools/spec-loop/AGENTS.md,
tools/spec-loop/IMPLEMENTATION_PLAN.md, and the specs
adoption-and-setup.md, drafting-mode.md, meta-and-quality-tooling.md,
pairing-mode.md, security-issue-lifecycle.md, and triage-mode.md.
Replace:
tools/skill-validator → tools/skill-and-tool-validator
- the CLI
skill-validate → skill-and-tool-validate
Two spots need judgement, not blind replace:
tools/spec-loop/specs/meta-and-quality-tooling.md describes the tool
itself (its name and CLI in prose), so update the wording, not just the
commands.
tools/skill-evals/evals/setup-override-upstream/.../report.md contains
skill-validate inside mock fixture data (a sample PR checklist). Updating
fixture text can change what the eval asserts, so re-run that suite after
editing and confirm expected.json still matches:
uv run --project tools/skill-evals skill-eval tools/skill-evals/evals/setup-override-upstream/.
Acceptance criteria
Estimated effort
~1 hour for someone new to the codebase.
Getting started
This issue was drafted with an AI-assisted tool and reviewed by a maintainer before posting.
Which layer
skill-and-tool-validator
How to reproduce
N/A
Expected vs actual
see acceptance criteria
Surface area (optional)
No response
Environment (optional)
No response
What's broken
Summary
The validator tool was renamed from
skill-validator(CLIskill-validate)to
skill-and-tool-validator(CLIskill-and-tool-validate), but severaldocs and specs under
tools/spec-loop/still use the old name. The commandsthey print no longer run. Update the stale references to the new name.
Background
tools/skill-validator/no longer exists; the tool now lives attools/skill-and-tool-validator/and its CLI isskill-and-tool-validate(see
tools/skill-and-tool-validator/README.md, and the already-correctentries in
docs/labels-and-capabilities.md). The spec-loop docs were notupdated in the rename, so anyone copy-pasting a
uv run --project tools/skill-validator ... skill-validatecommand from a spec hits anon-existent project.
Where to look
Let grep be the source of truth, since line numbers drift:
As of now that surfaces references in
tools/spec-loop/AGENTS.md,tools/spec-loop/IMPLEMENTATION_PLAN.md, and the specsadoption-and-setup.md,drafting-mode.md,meta-and-quality-tooling.md,pairing-mode.md,security-issue-lifecycle.md, andtriage-mode.md.Replace:
tools/skill-validator→tools/skill-and-tool-validatorskill-validate→skill-and-tool-validateTwo spots need judgement, not blind replace:
tools/spec-loop/specs/meta-and-quality-tooling.mddescribes the toolitself (its name and CLI in prose), so update the wording, not just the
commands.
tools/skill-evals/evals/setup-override-upstream/.../report.mdcontainsskill-validateinside mock fixture data (a sample PR checklist). Updatingfixture text can change what the eval asserts, so re-run that suite after
editing and confirm
expected.jsonstill matches:uv run --project tools/skill-evals skill-eval tools/skill-evals/evals/setup-override-upstream/.Acceptance criteria
skill-validator/skill-validatereferences remain outside the tool's own directory).uv runcommand that referenced the validator now usestools/skill-and-tool-validatorandskill-and-tool-validateand runs successfully.meta-and-quality-tooling.mdprose names the tool correctly.setup-override-upstreameval suite still passes.Estimated effort
~1 hour for someone new to the codebase.
Getting started
This issue was drafted with an AI-assisted tool and reviewed by a maintainer before posting.
Which layer
skill-and-tool-validator
How to reproduce
N/A
Expected vs actual
see acceptance criteria
Surface area (optional)
No response
Environment (optional)
No response