Content
71%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.
A well-structured instruction-only skill with executable discovery and verification commands, clear sequencing, and exemplary reference navigation. Its weaknesses are repetition in the body (the AGENTS.md note and trigger list) and direction-level guidance for the more advanced verification steps.
Suggestions
State the AGENTS.md equivalence once (in the Overview) and drop the repeated Note in Discovery step 2; similarly remove the 'Use this skill when asked to' list that duplicates the frontmatter description.
Add concrete grep/extraction commands for Steps 3-5 (code pattern verification, convention drift, structural verification), mirroring the style of Steps 1-2.
Replace the undefined $glob_pattern in the dead-glob snippet with a working loop that reads paths: globs from each rule file, and define what to do when a finding is ambiguous (e.g., re-verify against git history) to add a feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with purposeful code blocks, but there is repeated padding: the AGENTS.md explainer appears twice nearly verbatim ("AGENTS.md is a third-party alternative that uses the exact same rules..." in the Overview and again as a Note in Discovery step 2), and the "Use this skill when asked to" bullet list duplicates the frontmatter description. Fits 'mostly efficient but could be tightened' better than 'minor instances' at 4, since two sections are pure repetition. | 3 / 5 |
Actionability | Discovery, dead-glob detection, and reference verification give concrete executable bash commands, and freshness scoring uses concrete thresholds (60+ days, <50% convention adherence). Not 5 because Steps 3-5 (code pattern verification, convention drift, structural verification) are direction-level with no commands or extraction snippets, and the glob-test snippet uses an undefined $glob_pattern variable; not 3 because the core workflow steps are executable rather than pseudocode. | 4 / 5 |
Workflow Clarity | A clear two-phase sequence (Discovery 1-4, Audit Steps 1-7) with an explicit freshness-scoring table acting as validation criteria and a defined report format with priority ranking. Not 5 because the audit steps lack feedback loops (e.g., what to re-check after a flagged rule is inspected, or how to resolve ambiguous drift findings); not 3 because checkpoints and evaluation criteria are explicit, not implicit. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview: a Reference Navigation table maps four topics to the four real files in references/ (all verified to exist, each one level deep with its own table of contents), plus a CI section that signals the same guide. Matches the clear-overview, well-signaled, one-level-deep anchor; the only quibble is the /install-rules-audit command reference with no commands/ directory in the bundle, which is a bundle-completeness issue rather than a navigation one. | 5 / 5 |
Total | 16 / 20 Passed |