Content
63%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 a well-structured, actionable orchestrator with a clear sequenced workflow and validation gate, but it is dense with run-on steps and inlined field specs, and its many references point outside the skill bundle rather than to bundled files.
Suggestions
Break the run-on Build Process steps (especially 2 and 7) into shorter sub-steps or move the per-field authoring_state rules into a dedicated reference file.
Move the full Sequence Map Fields and scene-card field enumerations into a reference file, keeping only the essential fields inline in SKILL.md.
Resolve the reference paths: either bundle the referenced files under ./references/ within the skill, or document that they live in a shared plugin-level references directory so the navigation is verifiable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body does not pad with concepts Claude already knows, but several Build Process steps (notably 2 and 7) are long run-on sentences and the Sequence Map Fields section enumerates ~25 fields inline, which could be tightened or moved to a reference. | 3 / 5 |
Actionability | It provides concrete taxonomies (generation modes, sequence relations, shot structures), an 11-step Build Process, and an explicit 11-item Output Contract; the main gap is that prompt-compilation mechanics are delegated to reference files not present in the bundle. | 4 / 5 |
Workflow Clarity | The Build Process is a clearly numbered sequence with an explicit validation gate in step 11 ('require the clip or final frame... and only then compile the next prompt') and field checklists, though the dense prose slightly reduces clarity. | 4 / 5 |
Progressive Disclosure | References are well-signaled with conditional load guidance, but the skill bundle contains no reference files (paths point to ../../references/ outside the bundle) and a large amount of detailed spec is inlined in SKILL.md rather than split out. | 3 / 5 |
Total | 14 / 20 Passed |