Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, actionable contract skill with concrete paths, namespaces, and decision rules, but it carries cross-section redundancy, lacks an explicit sequenced workflow with validation checkpoints, and is a monolithic single file above the simple-skill line.
Suggestions
Deduplicate the repeated "upstream first / do not fork shadcn CLI" guidance: state the core rule once in Core Contract and reference it from Registry Rules and Red Flags rather than restating it.
Turn the Red Flags list into an explicit pre-flight checklist with a validate step (e.g., "check ../shadcn first, then proceed") so the decision workflow has a clear sequence with checkpoints.
Move the detailed Registry dependency rules and Current Divergences into a reference file referenced one level deep from SKILL.md to reduce inline bulk and improve navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining concepts Claude already knows and uses lean bullets, but the same injunctions ("upstream first", "do not fork shadcn CLI") are restated across Core Contract, Registry Rules, and Red Flags, so it could be tightened. | 2 / 3 |
Actionability | Guidance is concrete and specific — exact paths (apps/www/src/registry/*, apps/www/public/rd), namespaces (@plate, @shadcn/*), URL patterns (https://platejs.org/r/*.json), the --local flag, and clear prefer-X-over-Y decision rules — actionable without code, as the rubric allows for instruction-only skills. | 3 / 3 |
Workflow Clarity | Sections are well-organized and Red Flags act as a reassess-checklist, but this is declarative policy rather than a sequenced multi-step workflow with explicit validate-fix-retry checkpoints, so checkpoints remain implicit rather than embedded in a clear sequence. | 2 / 3 |
Progressive Disclosure | The skill is a single self-contained ~130-line file with clear headers and no bundle/reference files, but it exceeds the simple-skill (<50 line) threshold and keeps all detail inline rather than splitting reference material out one level deep. | 2 / 3 |
Total | 9 / 12 Passed |