Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill body is highly actionable with a clear three-step workflow and a real supporting script, but it is padded with a large inline JSON example and recommendation tables that duplicate the script's embedded logic, and it keeps reference-grade detail inline rather than splitting it out.
Suggestions
Move the full JSON output schema and the four recommendation matrices into a separate REFERENCE.md and reference it one level deep, keeping only a concise sample in SKILL.md.
Trim the Best Practices and Troubleshooting sections to a few essential bullets; the script and JSON are self-documenting for Claude.
Replace the static JSON example with a short excerpt plus a note to run the script, since the exact output is generated dynamically.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and executable, but the full ~55-line JSON example, the lengthy recommendation tables that duplicate logic already embedded in detect_resources.py, and sections like Best Practices/Troubleshooting add explanatory padding that Claude could derive from the script. | 2 / 3 |
Actionability | It provides fully executable commands (`python scripts/detect_resources.py`), complete CLI flags, copy-paste-ready Python snippets that read the JSON and branch on recommendations, and the underlying script is real and complete. | 3 / 3 |
Workflow Clarity | The process is clearly sequenced as three numbered steps (run detection → read JSON → make decisions), with the script serving as an implicit validation checkpoint and the JSON output providing feedback the user can act on; the single-task workflow is unambiguous. | 3 / 3 |
Progressive Disclosure | Structure is well-organized with clear sections, but the bulk of detailed reference material (the full JSON schema and recommendation matrices) is inline in SKILL.md rather than split into a referenced file; only scripts/detect_resources.py is referenced one level deep. | 2 / 3 |
Total | 10 / 12 Passed |