Content
92%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exceptionally disciplined instruction-only skill: concise, evidence-driven, and sequenced with explicit validation and honest-coverage reporting requirements. The single weakness is that the link-enumeration step describes what to search for without providing a concrete pattern, leaving the reader to construct it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense with rules Claude does not already know (e.g. "Do not use `rg --files`, which skips hidden paths such as `.agents/`"); there is no padding, no tutorial prose, and every sentence carries operational guidance. This matches the "every token earns its place" anchor. | 5 / 5 |
Actionability | Mostly executable guidance: exact commands (`git ls-files --cached --others --exclude-standard -- '*.md' '*.mdx'`, `python scripts/ci/check_doc_task_paths.py`, `git diff --check`) and precise resolution rules for paths, fragments, and renderer-specific IDs. Not a 5 because the core link-detection step leaves the actual search pattern unspecified (justified, but still a gap the reader must fill). | 4 / 5 |
Workflow Clarity | Four ordered phases (scope/baseline, mechanical checks, meaning/language, edit/validate) with explicit validation checkpoints: recheck each changed link, run repository check scripts, Sphinx build with warning inspection, `git diff --check`, and final diff review, plus error-recovery guidance ("If a target is missing or ambiguous, search the repository for its intended replacement... otherwise report the uncertainty with file and line"). Validation for this batch operation is present, so no cap applies. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, self-contained with no bundle files (references/, scripts/, assets/ do not exist and none are referenced), and organized into four clearly labeled sections. Per the rubric's simple-skill guidance, well-organized sections with no need for external references merit a 5. | 5 / 5 |
Total | 19 / 20 Passed |