Content
86%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-built routing/catalog skill: concrete steps, exact file targets, and disciplined separation between the overview and per-actor leaf playbooks. The only notable gaps are a duplicated planning-vs-execution clarification and the absence of an explicit validation checkpoint in the adaptation workflow.
Suggestions
Merge the opening blockquote and the paragraph after Step 5 — both explain that the mapped operational skills are for executing agents and that Soundwave only plans; state it once.
Add an explicit validation checkpoint after pruning, e.g. 'Re-validate the pruned threat-profile.json against the ThreatProfile schema before lifting the kill chain into conops.json.'
State what to do when the operator's intake does not name an actor (e.g., default to evidence-based attribution step or ask), so Step 1 has a fallback path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes domain competence ('Emulate behavior, not malware', 'RoE wins every tie'), but the planning-vs-execution clarification is made twice — once in the opening blockquote ('Soundwave only reads them to author plan/threat-profile.json') and again after Step 5 ('Soundwave does not create objectives or dispatch the mapped actions'). Merging these would tighten an otherwise efficient document. | 4 / 5 |
Actionability | Guidance is fully concrete for an instruction-only skill: a copy-paste-ready load_skill path, exact output files (plan/threat-profile.json, conops.json, abort.json, deconfliction.json), explicit pruning rules ('A pruned technique whose whole phase is now empty drops that kill-chain row'), and a complete actor table with per-playbook paths. | 5 / 5 |
Workflow Clarity | The 5-step 'Adapting a playbook' sequence is clearly ordered and includes a conditional pruning rule, but there is no explicit validation checkpoint (e.g., re-checking the pruned ThreatProfile against the decepticon.core.schemas schema before lifting the kill chain). Checkpoints are implicit rather than stated as verify-then-proceed steps. | 4 / 5 |
Progressive Disclosure | The catalog is a clean overview that routes to seven one-level-deep leaf playbooks via a table plus an explicit load step, keeping per-actor detail appropriately split out. No bundle files exist in this skill; navigation to the leaves is unambiguous and nothing that belongs in a leaf is inlined. | 5 / 5 |
Total | 18 / 20 Passed |