Content
78%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 lean, highly actionable instruction skill with strong templates, examples, and end-to-end sequencing from foundation through validation. Its main weaknesses are a dangling reference to docs/output-kit.md (absent from the bundle) that undercuts both the final step's executability and navigation, and validation that is checkpointed only at the end rather than per level.
Suggestions
Ship the referenced docs/output-kit.md in the bundle (e.g. under references/) or inline the essential output-format rules into Step 6 so the final step is executable without a missing file.
Add brief selection criteria at Step 2 (e.g. 'select using the Step 5 filters') or move a one-line filter summary forward so the "select strongest" instruction is not deferred.
Clarify the external dependencies (pitch-position, pitch-recon, Echo, crest-compete, /atlas-report) with one line on what to do if those skills/commands are unavailable, so the workflow degrades gracefully outside its home ecosystem.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is template- and table-driven with zero concept explanation — lines like "Build hierarchy top-down. Each level unpacks level above." and the surface-map table carry maximum instruction per token. Every section (formats, examples, filters, delivery) earns its place, matching the lean top anchor rather than the minor-trim level 4. | 5 / 5 |
Actionability | Concrete, copy-paste-ready templates with worked examples ("[Outcome] for [who]" → "Faster decisions for product teams", the three-example proof-point block, the CTA alternatives) make this mostly-to-fully executable for an instruction-only skill. It falls short of 5 because Step 6 says "Follow the output format defined in docs/output-kit.md", but no such file exists in the bundle (no references/ or docs/ directory is present), leaving the final output format unresolvable as shipped. | 4 / 5 |
Workflow Clarity | Six clearly sequenced steps with prerequisite confirmation in Step 1 (including the fallback "If missing, run pitch-recon") and an explicit validation checklist in Step 5 with a fix directive ("does a competitor say something identical? If so, sharpen"). Not 5: validation is end-of-pipeline only — Step 2's "Write 3 options, select strongest" lacks selection criteria until Step 5, and there are no per-level checkpoints or explicit re-validation after edits. | 4 / 5 |
Progressive Disclosure | The single-file body is well-sectioned, but it points to "docs/output-kit.md" (Step 6) and invokes "/atlas-report" without either existing in the bundle — the referenced path cannot be verified as a real file, leaving navigation partially broken. This sits between anchor 3 (references present but problematic) and anchor 4 (references mostly clear); the dangling output-format reference keeps it at 3 rather than 4, but the organized single-file structure keeps it above 2. | 3 / 5 |
Total | 16 / 20 Passed |