Content
100%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.md body: it explicitly limits itself to deltas from a known default (Playwright recordVideo + ffmpeg) and delivers only non-obvious operational knowledge — concrete commands, an explicit validation step, a fallback error-recovery path, and verified one-level-deep references into the bundle scripts. No weaknesses were found on any dimension.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body states 'Scripts do the work; this file lists only what differs from a plain Playwright recordVideo + ffmpeg job' and holds to it — every line is a non-obvious delta (deviceScaleFactor corner-frame gotcha, relay single-connection behavior, ~20x GIF size comparison, exit-code table). No padding and no explanation of concepts Claude already knows, matching the anchor-5 'every token earns its place' example. | 5 / 5 |
Actionability | Every script has a concrete invocation in the table, plus a copy-paste example command ('node "${CLAUDE_SKILL_DIR}/scripts/finish.mjs" spec-1-1.webm spec-1-2.webm --out ...'), the exact screenshot call ('page.screenshot({ style: '#__screencast{display:none!important}' })'), an exact ffmpeg fallback command for the GIF path, and a complete exit-code table. Fully executable guidance covering the common cases matches anchor 5. | 5 / 5 |
Workflow Clarity | Sequences are clear per mode (launch/start/step/stop for capture.mjs, overlay + per-step timings contract for runners), with an explicit validation checkpoint ('Read <id>.sheet.png before any upload or claim'), a feedback loop with fallback ('Exit 6 ... fall back to gif_creator, convert the GIF ... add a notes line'), and the mp4 sanity check surfaced via exit code 3. Anchor 5 fits; anchor 4 would require missing checkpoints, and the destructive/batch cap does not apply since recording is non-destructive. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: all four scripts referenced (scripts/record.mjs, overlay.js, finish.mjs, capture.mjs) exist, and the details the body defers are genuinely one level deep in those files ('schema in the file header' for record.mjs and 'Usage and exit codes in the file header' for capture.mjs both verified). The body is a lean overview table plus deviations, with clear links — matching the anchor-5 well-signaled one-level-deep structure. | 5 / 5 |
Total | 20 / 20 Passed |