Content
71%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.
A well-structured interactive-instruction skill: a clear six-step workflow with concrete parameters, a named self-check checkpoint, and exemplary single-file progressive disclosure verified against the actual bundle. The main cost is token redundancy — the coverage bullets, Constraints, and When-to-use sections substantially restate the Workflow and the description.
Suggestions
Collapse the 'What is covered in this Skill?' bullet list and the redundant MUST constraints into the Workflow steps themselves (e.g., fold layer counts and ordering rules into step 2) to remove three overlapping restatements of the same content.
Remove or trim the 'When to use this skill' section, which duplicates the frontmatter description's trigger phrases verbatim — the description already handles triggering.
Add one short feedback instruction to step 6 stating what to do when a slice fails the self-check (e.g., drop or shrink the offending layer option and recompose), since the fix-and-retry loop currently lives only in the reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean but carries noticeable redundancy: the "What is covered in this Skill?" bullet list restates the Workflow steps almost one-for-one, the Constraints MUSTs ("MUST identify 3-6 functional or workflow layers", "MUST generate 4-5 options per layer", "MUST challenge scope with the smallest-useful-version question") repeat steps 2 and 3, and "When to use this skill" duplicates the frontmatter description's trigger phrases. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' — not 4, since the duplication is systematic across three sections rather than a minor trim. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is concrete and executable: fixed counts ("Identify 3-6 functional or workflow layers", "generate 4-5 implementation or quality options ordered from the simplest acceptable choice"), an exact challenge question ("If this had to ship tomorrow, what would be the smallest useful version?"), explicit rejection criteria, and named routing targets (041-planning-plan-mode, 042-planning-openspec, 043-planning-github-issues, 044-planning-jira). Minor gaps keep it from 5: no worked example of a composed slice in the body and routing skills are named but not linked as files. | 4 / 5 |
Workflow Clarity | Six steps are clearly sequenced and step 6 is an explicit validation checkpoint ("Check every slice for value, size, testability, deliverability, and issue-tracking suitability"), which fits 'Clear sequence with most checkpoints present'. It is not 5 because the body lacks a feedback loop for what to do when a slice fails the self-check (no fix-and-retry guidance is stated in the body, only safeguards in the reference file), and not 3 because checkpoints are explicit rather than implicit. | 4 / 5 |
Progressive Disclosure | The body is a concise overview pointing to exactly one reference file (references/052-design-hamburger-method.md), which exists, is one level deep (it contains no further references), and is clearly signaled twice — a MUST-read constraint up front and a dedicated Reference section at the end. The reference file itself covers detailed steps, examples, output format, and safeguards. This matches the top anchor: clear overview, well-signaled one-level-deep reference, easy navigation. | 5 / 5 |
Total | 16 / 20 Passed |