Content
86%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 well-structured, highly actionable skill body: executable CLI commands with a smoke-test path, a clear 7-slot specification, and properly disclosed one-level-deep references that verified to real files. Minor improvements are possible: the 'Core Capabilities' section duplicates the 7-slot specification, and the manual compilation workflow could spell out explicit steps and a validation checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and domain-specific (e.g., diffusion models lacking 'intrinsic 3D coordinate awareness'), but the 'Core Capabilities' bullets ('Dolly vs. Zoom Decoupling', 'Rigid Parallax Anchoring', 'Subject Bounding-Box Locking') substantially duplicate what the 7-slot specification and the reference file already state. Not 5 because that section could be trimmed; not 3 because there is no generic padding or explanation of concepts Claude already knows. | 4 / 5 |
Actionability | Copy-paste-ready CLI commands are provided for all common cases: intent compilation in markdown and JSON ('python3 scripts/motion_contract_compiler.py --intent "..." --format json') plus a built-in smoke fixture ('--sample'), and the manual path includes a fully worked input/output example. The referenced script exists and is dependency-free, making the guidance fully executable. | 5 / 5 |
Workflow Clarity | Two workflows (CLI compile and manual agent compilation) are clearly presented, with the CLI path including a verification command ('Built-in smoke fixture verification'). Not 5 because the manual workflow provides only a single worked example with no explicit step sequence or output-validation checkpoint for compiling an arbitrary shot. | 4 / 5 |
Progressive Disclosure | The SKILL.md body is a concise overview that clearly signals one-level-deep references: 'Detailed cinematography principles, parallax velocity formulation, and diffusion engine mapping are documented in: [Camera Mechanics Reference](references/camera-mechanics.md)' and the scripts/ path, both of which exist as real bundle files with no nested references. Content is appropriately split between the overview, the reference, and the script. | 5 / 5 |
Total | 18 / 20 Passed |