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-sequenced, highly actionable research pipeline with strong validation and feedback loops. Its weaknesses are repeated prohibition statements that hurt conciseness and a monolithic inline structure with no reference files to aid progressive disclosure.
Suggestions
Consolidate the repeated prohibitions into a single 'constraints' section and reference it elsewhere instead of restating 'NEVER write outside docs/research/' and 'NEVER implement code' four times each.
Extract the full worker prompt template and the output file manifest into reference files (e.g., references/worker-prompt.md, references/output-structure.md) and link to them from SKILL.md.
Add an explicit post-Document verification step (e.g., confirm all five output files exist) to push workflow_clarity toward 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The config-style YAML is generally tight, but the same prohibitions are repeated across veto_conditions, constraints, security, and scope_boundaries (e.g., 'NEVER write files outside docs/research/' and 'NEVER implement code' each appear multiple times), so it could be trimmed. | 3 / 5 |
Actionability | Provides a copy-paste-ready worker prompt template, explicit Task() dispatch signature, numeric stopping thresholds, and a concrete output file manifest; only minor gaps keep it from being fully turnkey. | 4 / 5 |
Workflow Clarity | Six phases are clearly sequenced with explicit validation checkpoints (HARD/SOFT stop rules, coverage thresholds, failed-worker fallback, Wave 2 loop), satisfying the batch-operation feedback-loop requirement with only minor implicit checks. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the skill is a single ~430-line monolithic YAML block; content that could live in separate references (worker prompt template, output manifest) is inlined, so structure is present but not split for navigation. | 3 / 5 |
Total | 14 / 20 Passed |