Content
71%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.
The body is well-organized, concise, and gives concrete executable guidance with clear success/failure handling. Its notable weakness is that the central referenced bundle file (scripts/ccv-projects.mjs) is absent from the skill package, breaking progressive disclosure and slightly weakening actionability.
Suggestions
Ship the referenced 'scripts/ccv-projects.mjs' in the bundle (under scripts/) so the skill's core mechanics actually exist, or remove the script reference and inline the logic.
Add an explicit validation/feedback loop for the 'start' path (on non-zero exit: read stderr → diagnose listed causes → retry or guide the user) to reach the level-5 workflow anchor.
Tighten the conversational framing (e.g. 'le cœur', 'n'en fais pas l'impasse pour improviser de ton côté') to lift conciseness to a lean 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence, giving executable commands and output formats without explaining concepts Claude already knows; only minor conversational padding ('le cœur', 'n'en fais pas l'impasse') keeps it off the lean level-5 anchor. | 4 / 5 |
Actionability | Concrete executable commands are given ('node scripts/ccv-projects.mjs list', '… start <dir>') with argument syntax and an explicit stdout example, but the referenced script file is not present in the bundle, which slightly undercuts copy-paste readiness relative to the level-5 anchor. | 4 / 5 |
Workflow Clarity | The start flow has a clear sequence (determine dir → run → branch on success/failure) with explicit validation via exit codes and honest error handling, missing only the formal validate-fix-retry feedback loop that would warrant a 5. | 4 / 5 |
Progressive Disclosure | The body is well-structured with clear sections and points to an encapsulated script, but it repeatedly references 'scripts/ccv-projects.mjs' which does not exist in the bundle — per the rubric, scoring against the actual bundle structure, a missing referenced path caps this between the 'references present but not clearly signaled' and 'good structure' anchors. | 3 / 5 |
Total | 15 / 20 Passed |