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.
The body is a tight, well-structured index that practices what it preaches on progressive disclosure, with all referenced files present. Its weakness is actionability and workflow clarity: it defers all executable figure-making guidance to the reference files without surfacing even a minimal quick-start snippet.
Suggestions
Add a short 'Quick start' snippet showing one canonical figure (e.g., a styled grouped bar) so the body is actionable on its own before forcing a reference hop.
Include a minimal step sequence for the common case (pick demo -> match PALETTE/fonts -> export PDF/SVG) with a verification checkpoint that the exported file renders and matches house style.
Surface 2-3 key house-style constants (e.g., the PALETTE name, default DPI, font) inline so common cases don't require opening references/api.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~25-line body is lean and assumes Claude's competence — it explains only the repo-specific house-style context and navigation rules, with no padding or basic-concept re-explanation. | 5 / 5 |
Actionability | It offers concrete navigation guidance (a file table with 'Open when' triggers and an explicit 'do not preload' rule) but no executable code or commands, leaving the actual figure-making steps deferred to the reference files. | 3 / 5 |
Workflow Clarity | A rough sequence is present ('Start from the table below, then follow links inside the document you opened') but there are no validation checkpoints; acceptable for an index skill yet not a fully sequenced workflow. | 3 / 5 |
Progressive Disclosure | Clear overview with a well-signaled one-level-deep reference table; all five referenced files exist in references/ and the 'open only as needed' instruction prevents eager loading. | 5 / 5 |
Total | 16 / 20 Passed |