Content
72%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 extremely lean, well-sectioned body with a concrete layout spec and output contract, but it is undermined by a dangling reference (DESIGN.md does not exist in the bundle) and by instruction-level gaps on the print stylesheet and arithmetic details. Conciseness is exemplary; workflow and disclosure pay the price of the missing file.
Suggestions
Ship the DESIGN.md the workflow depends on (frontmatter requires color, typography, layout, and components sections) or remove the 'Read DESIGN.md' step — the workflow's first step is currently unexecutable.
Replace the 'Print stylesheet @media print to remove backgrounds' hint with a short concrete snippet (e.g., a minimal @media print block hiding backgrounds/links and setting page margins) so the print step is copy-paste ready.
Add a lightweight validation checkpoint to the workflow, e.g., verify the totals block (subtotal − retainer + tax = total due) against the line items before emitting the artifact.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~30 lean lines: a one-line goal ("Produce a single-page printable invoice"), a tight numbered layout spec, and a minimal output contract — every token earns its place and nothing explains concepts Claude already knows. This matches the 5 anchor ('lean and efficient; assumes Claude's competence'); it does not warrant 4 territory since there is no over-explanation to trim. | 5 / 5 |
Actionability | Concrete structural guidance is present: exact table columns ("description / qty / unit / amount"), totals block fields ("subtotal, retainer, tax, total due"), and a literal artifact contract with type and title. It sits at 4 rather than 5 because details like the "Print stylesheet @media print to remove backgrounds" step are hints rather than executable code, and tax/retainer computation, currency formatting, and payment-instruction fields are left unspecified. | 4 / 5 |
Workflow Clarity | The sequence (1. Read DESIGN.md → 2. Layout → 3. Print stylesheet → output contract) is clearly ordered, but step 1 points at a DESIGN.md that does not exist anywhere in the bundle (no references/, scripts/, or assets/ directories), so the workflow cannot be followed as written. That broken first step, plus no validation of the produced artifact (e.g., checking totals arithmetic or that all line items render), places it at the 3 anchor ('steps listed but gaps') rather than 4; this is not a destructive/batch operation, so the 3-cap rule is not the driver. | 3 / 5 |
Progressive Disclosure | For a sub-50-line single-purpose skill the structure (## Workflow, ## Output contract) is well organized, but the body's only external reference — "Read DESIGN.md" — is dangling, and the frontmatter's design_system requirement implies a design reference that is absent. Per the guideline to score against the actual bundle structure, the broken reference prevents both the simple-skill 5 and the 4 anchor; it lands at 3 ('references present but' unusable / organization gaps that block navigation). | 3 / 5 |
Total | 15 / 20 Passed |