Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong meta-skill for authoring agent skills. It excels at actionability with concrete examples, commands, and templates, and demonstrates excellent progressive disclosure by routing to specific workflow and reference files based on the task. The workflow clarity is strong with clear job routing and validation steps. The main weakness is moderate verbosity — some sections could be tightened without losing clarity, though for a complex meta-skill covering multiple jobs, the length is largely justified.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally well-structured and avoids explaining basic concepts, but it's somewhat verbose for a meta-skill. Some sections like 'Progressive Disclosure' and 'Writing SKILL.md Bodies' repeat concepts that could be more tightly expressed. The Cardinal Rules table is useful but lengthy. Overall mostly efficient with some room to tighten. | 2 / 3 |
Actionability | Provides concrete, executable commands (scaffold, validate scripts), specific YAML examples for good/bad descriptions, a clear formula for writing descriptions, and a structured shape (Choose/Do/Show/Guard/Check) for writing bodies. The tooling section has copy-paste ready commands. The job routing table gives specific file paths to follow. | 3 / 3 |
Workflow Clarity | The 'Choose the Job' table provides clear routing to specific workflows based on the task at hand. The 'Fast Path' section gives a concise 4-step process for simple edits with an explicit validation step. The body-writing shape (Choose/Do/Show/Guard/Check) includes a validation checkpoint. The skill clearly sequences the loading order and decision points. | 3 / 3 |
Progressive Disclosure | Excellent progressive disclosure structure. The skill routes to specific workflow files (create.md, synthesize.md, test.md, debug.md, refine.md) and reference files based on the job at hand. References are one level deep and clearly signaled with 'Read first' and 'Then use when needed' columns. The three-layer model (name+description → SKILL.md body → references/scripts/assets) is explicitly documented and practiced. | 3 / 3 |
Total | 11 / 12 Passed |