Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, well-structured instruction skill with specific, actionable guidance and clean sectioning. The main gaps are the absence of any executable example and an implicit regeneration feedback loop rather than an explicit sequenced one.
Suggestions
Add one short executable import example (e.g., importing a generated client and calling a hook) to move actionability toward copy-paste-ready.
Render the regenerate workflow as a numbered loop with the typecheck as an inline checkpoint (edit -> `kubb generate` -> typecheck -> fix -> regenerate) so the feedback loop is explicit.
Cut the meta "What It Does" section and the restating intro line to tighten conciseness further.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and does not over-explain known concepts, but the meta "What It Does" bullets and the restated intro line ("This skill instructs agents on importing and using the code Kubb generates...") could be trimmed, matching the score-2 anchor of mostly-efficient-but-tightenable. | 2 / 3 |
Actionability | Guidance is concrete with exact paths and keys ("node_modules/@kubb/plugin-<name>/src/types.ts", "output.barrel", the kubb.dev URL) and a clear import rule, but it offers no executable code snippet, so it stops short of the copy-paste-ready score-3 anchor. | 2 / 3 |
Workflow Clarity | There is a numbered "Find what was generated" sequence and an explicit typecheck validation rule, but the regeneration feedback loop (edit spec/config -> regenerate -> typecheck -> fix) stays implicit rather than sequenced with inline checkpoints, fitting the score-2 anchor. | 2 / 3 |
Progressive Disclosure | The ~50-line body is well-organized into clearly labeled sections with no need for external bundle references (none exist), and the only link is a one-level peer-skill pointer, satisfying the scoring-note allowance for score 3 on simple well-organized skills. | 3 / 3 |
Total | 9 / 12 Passed |