Content
75%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 well-organized, actionable planning skill: concise catalog, concrete sequenced workflow with implicit safety gates, and clearly signaled references to leaf playbooks. The main gap is the absence of an explicit validation checkpoint and literal copy-paste seed JSON.
Suggestions
Add an explicit validation step to the workflow (e.g., 'Validate plan/threat-profile.json and conops.json against decepticon.core.schemas before handoff') so the sequence has a hard checkpoint.
Include a minimal copy-paste ThreatProfile seed snippet or a pointer to a template file so step 3 ('Copy the ThreatProfile seed') is fully actionable.
Confirm the referenced files exist at the cited paths (../references/apt-groups.md, ../references/adversary-archetypes.md, emulation/<actor>/SKILL.md) so the one-level-deep navigation resolves.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — a compact actor table, a 6-step procedure, anatomy and discipline bullets — and assumes domain knowledge rather than explaining it; the only mild trim candidate is the blockquote clarifying Soundwave vs executing agents, which keeps it just shy of a 5. | 4 / 5 |
Actionability | Concrete, executable guidance throughout — explicit `load_skill("/skills/standard/soundwave/threat-profile/emulation/<actor>/SKILL.md")` calls and named output files (`plan/threat-profile.json`, `conops.json`, `abort.json`, `deconfliction.json`) — with only minor gaps (no literal JSON snippets to copy) keeping it from a 5. | 4 / 5 |
Workflow Clarity | The 'How to use a playbook' section is a clearly ordered 6-step sequence with implicit checkpoints (RoE-pruning drops empty phases in step 3, safety gates carried in step 5) and a defined handoff; it lacks an explicit 'validate the JSON' step, so it is not a 5. | 4 / 5 |
Progressive Disclosure | The SKILL.md is an overview/catalog that signals one-level-deep references to leaf playbooks (`emulation/<actor>/SKILL.md`) and sibling references (`../references/apt-groups.md`, `../references/adversary-archetypes.md`) with clear navigation; no bundle directories are present to verify further, so structure is good but not the textbook 5. | 4 / 5 |
Total | 16 / 20 Passed |