Content
93%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 efficient, highly actionable instruction-only skill: concrete commands, exact file paths, and a well-sequenced workflow with a thoughtful change-boundary gate. The main gap is the absence of failure-path guidance (missing script output, absent index sections), which costs it a validation checkpoint on workflow clarity rather than any structural flaw.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: no concepts are explained that Claude already knows, and every step carries instruction rather than padding. The only framing sentences ('Read the relevant development guidelines before starting your task' and the closing 'This step is mandatory before writing any code') are short and functional, so every token earns its place. | 5 / 5 |
Actionability | Guidance is fully executable: exact commands ('python3 ./.trellis/scripts/get_context.py --mode packages', 'cat .trellis/spec/<package>/<layer>/index.md', 'cat .trellis/spec/guides/index.md'), exact artifact filenames (prd.md, design.md, implement.md), the specific section to follow ('Pre-Development Checklist'), and named example guideline files (error-handling.md, conventions.md, mock-strategies.md). Placeholders are appropriately templated, not pseudocode. | 5 / 5 |
Workflow Clarity | The 8-step sequence is clear and correctly ordered, with conditional handling ('design.md if present') and an escalation checkpoint ('If the real scope turns out to be clearly larger than this, say so and why before continuing'). However, there are no explicit validation or feedback steps — e.g., what to do if get_context.py fails, .trellis/ is absent, or an index lacks a Pre-Development Checklist — which keeps it below the anchor requiring explicit validation loops. Since the skill is read-only preparation, not destructive or batch, the 3-cap does not apply. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no external bundle files needed; the numbered-step organization is clear and self-contained. It also models one-level-deep disclosure well, explicitly steering past the index: 'The index is NOT the goal — it points you to the actual guideline files', which is exactly the navigation behavior the top anchor rewards. | 5 / 5 |
Total | 19 / 20 Passed |