Content
92%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 dense, high-quality skill body: project-specific rules only, executable code and commands, a validated multi-step workflow with feedback loops and a completion checklist, and detail properly offloaded to three real, clearly signaled reference files. The single weakness is a couple of over-long run-on rule bullets that could be tightened or moved to a reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body never explains concepts Claude already knows — every rule is project-specific and non-obvious ('@signozhq/ui turns a button off with aria-disabled instead', 'Storybook parses the order out of the file statically'). A few bullets (the file-layout rule, the play-function rule) are long run-on prose that could be tightened or split into a reference, keeping this just below 'every token earns its place'. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste-ready code for the meta/doc-comment pattern, the aria-disabled assertion, the click-and-check pattern, and the AI-owned banner, plus exact commands ('pnpm tsgo --noEmit', 'pnpm exec oxlint <files>', 'pnpm exec oxfmt --check <files>') and exact title and path formats. Specific examples cover the common cases with no gaps. | 5 / 5 |
Workflow Clarity | A five-step sequenced workflow with explicit validation checkpoints and feedback loops: 'run it. The console names the endpoints step 1 missed', 'Never report the story as done without it', and 'Flip it once and run it' for assertions, capped by the 'Done means' checklist with concrete verification commands. This matches the top anchor including error recovery. | 5 / 5 |
Progressive Disclosure | The body is a clear overview of process and rules, with detail correctly split into three well-signaled, one-level-deep references (references/discovery.md, references/controls.md, references/verify.md) that all exist in the bundle with substantive content (51/180/85 lines) and are linked at the point of need. Nothing that belongs in a reference is inlined and navigation is easy. | 5 / 5 |
Total | 19 / 20 Passed |