Content
75%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 dense, competent instruction-only skill with strong validation gates, feedback loops, and a concrete output contract, supported by clearly signaled one-level references. It loses points for run-on verbosity, the absence of a worked prompt example, and a workflow that is scattered across sections rather than unified into one sequenced flow.
Suggestions
Add one short worked example showing a completed output contract (continuation type through final Seedance prompt) so the abstract 'translate record into carriers' step is concrete.
Consolidate the high-level procedure (load Director's Read -> classify -> gate -> observe -> compile -> return) into a single numbered 'Workflow' section, then keep the rule sections as supporting detail.
Break the longest compound sentences (especially around the source-gate and authoring-state steps) into shorter steps or a checklist to improve scannability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence — it never explains what Seedance or a clip is — and every section carries domain-specific procedure Claude would not already know, though several sentences (e.g., the 'After the source gate is satisfied...' paragraph) are dense run-ons that could be tightened. | 4 / 5 |
Actionability | Concrete guidance is present — an exact fallback utterance, a runnable command ('python scripts/extract_last_frame.py <take>'), a named-field input gate, and a numbered output contract — but no full worked example of a compiled continuation prompt is shown, leaving a minor gap. | 4 / 5 |
Workflow Clarity | Validation checkpoints and feedback loops are strong (input gate refusal, intent-echo confirmation 'before generation spends money', repair_tail-before-continue, reanchor_after_drift, max_chain_depth cap), but the workflow is spread across topical sections rather than presented as one clean sequenced procedure. | 4 / 5 |
Progressive Disclosure | References are well-signaled and one level deep with conditional load guidance ('Load failure-atlas when the continuation failed', 'Load directing-engine so the next clip inherits...'), but no references/ bundle is present to verify the files exist, the SKILL.md itself inlines a fair amount of rule content, and eight separate references is a moderately heavy navigation surface. | 4 / 5 |
Total | 16 / 20 Passed |