Content
93%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 skill body: every command is executable, every reference resolves to a real bundled file, and the config schema, validation rules, gaps, and QC checklist are all stated concretely with no token waste. The single gap is the absence of an explicit error-recovery loop telling the agent what to fix and re-run when the built-in validations or the Self-QC checklist flag a problem.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense with skill-specific knowledge: exact commands, a full config field table, pacing numbers ('~1.6–2.8 s per line... about 18 characters a second'), refusal rules, known gaps, and a QC checklist. It never explains concepts Claude already knows (Playwright, ffmpeg, and Apple Notes are named, not taught), matching anchor 5 ('Lean and efficient; assumes Claude's competence; every token earns its place'). | 5 / 5 |
Actionability | The Run block is fully executable and copy-paste ready ('cd scripts && npm install', 'npx playwright install chromium', the three node/bash invocations with flags and expected outputs), the Config section documents every field with a pointer to a real scripts/config.example.json that matches the documented schema, and all referenced bundle files (record-notes.js, render-end-card.js, stitch.sh, scripts/mockup/) exist. This matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases'). | 5 / 5 |
Workflow Clarity | The sequence is clearly ordered (install once → free --still-only review stills → record notes → render end card → stitch master) with real checkpoints: review stills before committing to video, built-in script validation (record-notes.js refuses em/en dashes or >80-char lines; render-end-card.js refuses missing rows/logo and fails on unloaded fonts), and an explicit Self-QC checklist. It falls short of anchor 5 because there is no fix-and-retry feedback loop when a QC check or script refusal fires — the Self-QC section says what to watch for but not what to correct and re-run. | 4 / 5 |
Progressive Disclosure | SKILL.md is a genuine overview: implementation is appropriately split into the scripts bundle (record-notes.js, render-end-card.js, stitch.sh, mockup/generate.js), and the config detail is clearly delegated one level deep to 'scripts/config.example.json' (verified to exist and consistent with the documented blocks). No nested references, no inlined content that belongs elsewhere, easy navigation — matching anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |