Content
53%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 content is well-structured and rich in genuinely specialized cinematography mappings, but its executable guidance is undermined by a broken bash example and references to non-existent script files, and the workflow lacks validation checkpoints.
Suggestions
Fix the bash example by adding line-continuation backslashes or writing it as a single line so it is copy-paste executable.
Provide the referenced scripts/generate-film.sh and core/platform/check-result.sh as bundle files, or note explicitly that they live outside the skill.
Add an explicit validation/feedback loop for the async step (e.g. 'poll check-result.sh; if status is failed, inspect the error and re-run with adjusted parameters').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient dense reference tables and lists, but it opens by restating the description ("A specialized skill for AI Agents to direct high-fidelity cinematic video") and defines basic camera terms (Dolly, Truck, Crane) Claude already knows, so it has some unnecessary explanation that could be trimmed. | 3 / 5 |
Actionability | Provides a concrete command example and a prompt-expansion formula, but the bash snippet is not executable as written (multi-line command with no line-continuation backslashes) and the referenced scripts/ directory does not exist, so key execution details are missing. | 3 / 5 |
Workflow Clarity | A clear 3-step sequence (define brief, invoke script, poll async result) is present, but there are no explicit validation checkpoints or error-recovery feedback loops for the async polling step. | 3 / 5 |
Progressive Disclosure | The body is well-organized into clearly labeled sections (intent mapping, camera movements, protocol, constraints) with one-level-deep references to named scripts; however, those referenced script files are not present in any bundle directory, a minor organization gap. | 4 / 5 |
Total | 13 / 20 Passed |