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.
The body is an exemplary lean instruction skill: concrete pointers instead of tutorials, explicit where-to-look and what-to-check guidance, and well-signaled one-level-deep references into the library and design pages. The only soft spot is a merely implied rather than explicitly sequenced workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~55-line body is lean with no padding and no explanation of concepts Claude already knows; every line carries repo-specific knowledge (component inventory, source paths, stories convention, demos command). | 5 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: exact source paths in both repos, a copy-paste command (`pnpm -F @gitbutler/ui-react demos`), specific example mapping ("a confirmation is Modal's, a picker Popup's or PickerDialog's"), and a concrete fallback with what to say in the PR description. | 5 / 5 |
Workflow Clarity | The sections imply a clear order (find the closest existing thing, read the design pages, follow the words guidance, check the result) and "Check it" is an explicit validation checkpoint (light and dark, keep a screenshot). It falls short of 5 because there is no explicit sequenced checklist or error-recovery feedback loop. | 4 / 5 |
Progressive Disclosure | A short single-file skill with no bundle files, organized into clear sections; all detail (library source, JSDoc, stories, DESIGN.md, per-topic design pages) is one level deep, clearly signaled, and gated by "each saying when to read it". | 5 / 5 |
Total | 19 / 20 Passed |