Content
88%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.
The body is a highly actionable, well-sequenced reading workflow with concrete tool calls, a worked example, and an explicit refine-and-repeat feedback loop. Its main weakness is moderate redundancy of the anti-fabrication guidance and a single-file structure with no progressive disclosure references.
Suggestions
Consolidate the repeated no-invention / keep-the-page-full guidance into one canonical section and cross-reference it instead of restating it in Evidence rules, the thin-material section, and Output discipline.
Consider extracting the worked example and the "When the inspected material is thin" expansion playbook into a short reference file (e.g. EXAMPLES.md) to bring progressive disclosure to one level deep.
Add a one-line "Stop condition" checklist at the end of the workflow summarizing when a slide has enough source-grounded evidence to stop reading.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Efficient and instruction-dense with no padding about concepts Claude already knows, but the no-invention / keep-the-page-full rule is restated across Evidence rules, the "thin material" section, and Output discipline and could be tightened. | 4 / 5 |
Actionability | Gives concrete, executable tool signatures (grep(pattern, path, glob), glob(pattern, path), read_file(path, offset, limit)) with a fully worked example including specific parameters; absence of literal code is not penalized for this instruction-only skill. | 5 / 5 |
Workflow Clarity | The 8-step Reading workflow is clearly sequenced with an explicit feedback loop (step 6: refine search terms and repeat grep -> targeted read) and grounding checks (steps 7-8); the operation is read-only so the destructive-cap does not apply. | 5 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections (Boundary, When to use / not to use, Reading workflow, Evidence rules, etc.) with easy navigation, but it is a single ~80-line file with no reference structure, slightly above the under-50-line simple-skill exception. | 4 / 5 |
Total | 18 / 20 Passed |