Content
78%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 lean, well-organized skill body that gives concrete discovery guidance and clear rules for keeping generated code in sync. It would benefit from a copy-paste import example and an explicit typecheck-failure recovery step.
Suggestions
Add a short copy-paste import example showing both barrel and direct-file imports (e.g. `import { useGetPets } from './gen/hooks'`) to lift actionability to fully executable.
Turn the 'Typecheck after regenerating' rule into an explicit feedback loop: 'If typecheck fails, fix the call site or update the spec/config and rerun kubb generate'.
Drop or fold the 'What It Does' section, since its bullets restate 'Where output lands', 'Find what was generated', and 'Rules' that follow it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes competence (no preamble about what Kubb or OpenAPI is), but the 'What It Does' section restates the rest of the body in a meta, descriptive voice that could be trimmed. | 4 / 5 |
Actionability | Gives concrete, executable guidance (specific paths like 'node_modules/@kubb/plugin-<name>/src/types.ts', the 'kubb generate' command, barrel-vs-direct import rule), but provides no copy-paste import code snippets to anchor the common cases. | 4 / 5 |
Workflow Clarity | The 'Find what was generated' section is a clear 3-step sequence and the Rules include a typecheck validation checkpoint after regenerating, but there is no explicit error-recovery feedback loop. | 4 / 5 |
Progressive Disclosure | A compact, well-sectioned overview (no bundle files exist) with clearly signaled one-level-deep navigation only via the Related Skills table, so structure is appropriate and easy to navigate. | 5 / 5 |
Total | 17 / 20 Passed |