Content
72%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.
A tight, highly actionable camera-direction skill body with strong concrete phrasing and good sectioning. Its main weaknesses are implicit workflow checkpoints and a broken bundle — six reference files are linked but none are present.
Suggestions
Ship the referenced bundle files (references/directors-read.md, quick-ref.md, cinematography-shot-language.md, directing-engine.md, vocab/zh.md, vocab/ru.md) or remove the links; dangling references make progressive disclosure non-functional.
Add an explicit numbered workflow with a validation/checkpoint step (e.g. '1. Load Director's Read; 2. Classify brief; 3. Draft camera phrase; 4. Check against Conflict Rule; 5. Return per Output Contract') to make the sequence and its gates explicit.
Trim the conceptual Intent paragraph ('Camera grammar is empathy mechanics...') to a one-line operational cue to tighten conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and assumes Claude's intelligence — the Camera Contract table, Move Selection, and Continuity Rules are dense and high-value. Only minor over-explanation could be trimmed (the 'Camera grammar is empathy mechanics' philosophy in Intent and the dense opener), so it sits at 'Efficient; minor instances of over-explanation.' Not a 5 because the Intent section is conceptual padding rather than operational guidance. | 4 / 5 |
Actionability | Highly actionable for an instruction-only skill: concrete strong/avoid phrase pairs in the contract table, specific lens mm anchors, explicit move-selection rules by use case, and exact reference-tag syntax ('@Video1 controls camera rhythm only; do not transfer performer, room, logo, or identity'). Specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | A conceptual flow is given up front ('load the Director's Read, classify the brief, complete its record, translate into carriers') and an Output Contract closes it, but there are no explicit validation checkpoints or feedback loops and the sequence is implicit rather than enumerated. This matches 'Steps listed but validation gaps; checkpoints missing or implicit.' Not a 4 because checkpoints are not present, and the destructive/batch cap is not triggered since this is a generation skill. | 3 / 5 |
Progressive Disclosure | The SKILL.md is well-sectioned and clearly signals one-level-deep references (directors-read.md, quick-ref.md, cinematography-shot-language.md, directing-engine.md, vocab/zh.md, vocab/ru.md), which structurally suggests a 4-5; however none of these referenced files exist in the bundle (no references/ directory resolves), so navigation is broken. The missing backing files cap it at 'Some structure... references present but' not reliably navigable rather than a 4. | 3 / 5 |
Total | 15 / 20 Passed |