Content
96%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.
An exemplary project-specific skill: it teaches only what Claude cannot know (registry invariants, boundary rules, failure modes), provides fully executable commands with a compiler-driven workflow, and closes with a five-gate validation loop. The single gap is that a few long, self-contained sections could live in separate reference files to slim the main body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries repo-specific, non-inferable knowledge (the registry-as-gate rule, the import cycle, the client-safe boundary, per-file failure modes for metadata) and it teaches zero general concepts, even delegating to TSDoc ("read the TSDoc in `types.ts` before overriding"). Lean and assuming of Claude's competence; nothing to trim, so not 4. | 5 / 5 |
Actionability | Copy-paste-ready commands throughout: `cd apps/sim && bun run type-check`, the full grep `grep -rnE "(===|!==) '{id}'|case '{id}':" apps/sim --include='*.ts' --include='*.tsx' | grep -v column-types/`, the exact test-suite invocation, and a complete icon component template with concrete geometric constraints. Fully executable guidance covering the common cases, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | Sequenced Steps 1-5, a pre-finish checklist, and a 'Final Validation (Required)' section with five explicit gates and error-recovery feedback loops ("If any file *outside* `column-types/` errors, that file has a hardcoded type list; fix it to read the registry"; "needing to edit one means you changed behavior"). Clear sequence, explicit validation, and recovery guidance — the 5 anchor. | 5 / 5 |
Progressive Disclosure | Well-organized sections with clear headers and a coherent flow (rule, structure, steps, traps, checklist, validation), so navigation is easy. Not 5 because at ~155 lines with no bundle files, self-contained blocks like the metadata-registration failure table and the 'Watch out' traps could be split into one-level-deep reference files; not 3 because nothing is buried and the in-file structure is genuinely clear. | 4 / 5 |
Total | 19 / 20 Passed |