Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, highly actionable read-only skill body with a clear phased workflow and concrete output contract. Its main weaknesses are triply-duplicated tool listings and a monolithic single-file layout that could offload detailed reference material into bundle files.
Suggestions
Remove the redundant "Tools Used" prose section (or the inline tool mentions) since the frontmatter tools field plus contextual mentions already cover it.
Consider moving the Output Format template and Quality Rules into a references/ file linked from the body, reducing the monolithic length while keeping the overview tight.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and free of concept-explanation padding, but the tool inventory is repeated three times (frontmatter tools, inline mentions in Phases, and the prose "Tools Used" section), so it could be tightened further. | 2 / 3 |
Actionability | Despite being instruction-only, it gives concrete per-situation tool calls, a defined seven-bucket classification scheme, and a copy-ready output-format template — actionable guidance with no code penalty applying. | 3 / 3 |
Workflow Clarity | Five phases are explicitly sequenced with real checkpoints: user disambiguation on shared phrases, entity-shape handoff to find_trajectory, and mandatory gap-labeling; the read-only nature means no destructive-validation cap applies. | 3 / 3 |
Progressive Disclosure | External references (conventions/quality.md, docs/takes-vs-facts.md) are clearly signaled one-level callouts, but no bundle files exist and the ~195-line body keeps output format, quality rules, and anti-patterns inline in a single monolithic file rather than splitting detail into skill-local references. | 2 / 3 |
Total | 10 / 12 Passed |