Content
85%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 strongly engineered orchestration body: every sub-command has concrete read/apply/report steps, verified on-demand reference loading with real bundle files behind each path, explicit error recovery, and a stated selection rule that prevents context flooding. The only trims available are minor duplication between the Runtime context and Reference Files sections and slightly underspecified 'apply the prompt' semantics.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is operational rather than explanatory — no space is spent on concepts Claude already knows, and instructions like 'Dumping all 21 is noise' justify rules efficiently. It stops short of 5 because of minor redundancy: the reference-file inventory appears twice (the 'Runtime context' block and the 'Reference Files' section), and the intro paragraph plus the Commands table partly restate the orchestration steps. | 4 / 5 |
Actionability | Mostly executable guidance: exact file paths per stage ('Read all files in references/prompts/find/'), a copy-paste sync command ('"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run sync_flow.py'), an error-handling table with concrete recovery actions, and a priority-ordered prompt-selection rule. The gap keeping it at 4 is that 'Apply each prompt to the URL or topic' leaves the core operation (how a prompt file is used against input) as a high-level hint rather than fully specified. | 4 / 5 |
Workflow Clarity | Each of the seven sub-commands has a clear numbered sequence, and the skill includes explicit error-recovery feedback loops ('sync_flow.py auth error → Run gh auth login then retry', missing files → '/seo flow sync') plus a checklist for the complex optimize-stage selection ('Always surface exactly 2-3 prompts. State which prompts you chose and why'). This matches the top anchor — clear sequences with explicit validation/recovery steps and a selection checklist; there are no destructive or batch operations lacking validation. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: references/flow-framework.md, bibliography.md, prompts/README.md, and the five stage directories exist with exactly the claimed counts (find=5, leverage=1, optimize=21, win=3, local=11 = 41 prompts). SKILL.md is a pure orchestration overview with one-level-deep, clearly signaled references ('Load on-demand, do NOT load all at startup', a dedicated Reference Files section with when-to-load conditions), so it matches the clear-overview top anchor. | 5 / 5 |
Total | 18 / 20 Passed |