Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is concise and reasonably actionable with useful mapping tables and a prompt formula, but it leans on non-existent script references and lacks validation/retry guidance for its async workflow.
Suggestions
Either bundle the referenced scripts (generate-film.sh, core/platform/check-result.sh) or replace the dead references with self-contained, executable instructions.
Add an explicit poll-until-complete loop with error handling and a retry/failure path for the async video generation workflow.
Show the actual check-result.sh invocation rather than only naming it, so the polling step is copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table/bullet-driven, assumes Claude's competence, and avoids explaining concepts Claude already knows; only minor intro repetition keeps it from feeling padded. | 3 / 3 |
Actionability | It provides a concrete bash example, a prompt-expansion formula, and mapping tables, but the example references a non-bundled script and the polling command is named without being shown. | 2 / 3 |
Workflow Clarity | Three sequenced steps are present, but the async polling workflow lacks validation checkpoints or an error-recovery feedback loop, which caps this dimension at 2. | 2 / 3 |
Progressive Disclosure | Sections are well-organized inline, but referenced script paths (generate-film.sh, check-result.sh) point to no actual bundle files and nothing is split into separate reference files. | 2 / 3 |
Total | 9 / 12 Passed |