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 well-structured, token-efficient skill body with good progressive disclosure and a sequenced workflow including a verification checkpoint. Main gaps are the duplicated file listing and the absence of an explicit failure-recovery loop in the workflow.
Suggestions
Consolidate the Quick Reference table and Loading Files checkbox list into a single navigation section to remove the duplicated file directory.
Add an error-recovery step to the New Library Workflow (e.g., 'If the build is missing .d.ts or a format, check tsdown entry/format config and re-run') to turn the verify checkpoint into a full feedback loop.
Inline one or two concrete code snippets for the highest-value tasks (e.g., a minimal dual-export package.json exports map with types) so common cases are actionable without loading a reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with bullet-driven principles and minimal over-explanation, but the file directory is listed twice — once as the Quick Reference table and again as the Loading Files checkbox list with near-identical descriptions — which is redundant and could be trimmed. | 4 / 5 |
Actionability | Provides copy-paste-ready package.json and tsdown.config.ts examples plus a concrete verify command ('pnpm build && pnpm pack --dry-run'), but the inline executable guidance is minimal and leans on reference files for the specifics of each task. | 4 / 5 |
Workflow Clarity | The 'New Library Workflow' gives a clear 6-step sequence with an explicit validation checkpoint (step 4 checks for .mjs/.cjs/.d.ts outputs), but lacks an error-recovery feedback loop describing what to do when verification fails. | 4 / 5 |
Progressive Disclosure | Clear overview with well-signaled one-level-deep references; all 10 referenced files (project-setup, package-exports, build-tooling, etc.) exist in references/ and are organized both as a table and a checklist for easy navigation. | 5 / 5 |
Total | 17 / 20 Passed |