Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body delivers highly actionable, executable Python workflows with a clear sequence and validation checklist, but it is held back by redundant concept explanation and a progressive-disclosure failure where a rich bundle of reference/script/asset files is never surfaced or linked from SKILL.md.
Suggestions
Replace the 'Key Concepts' prose and the redundant Overview with brief pointers to references/standards.md, keeping only what is not already general ATT&CK knowledge Claude has.
Link the inline workflow steps to the richer references/workflows.md and surface scripts/agent.py, scripts/process.py, and assets/template.md where appropriate instead of duplicating their content inline.
Tighten the generic 'When to Use' bullets into specific, non-templated triggers tied to concrete analyst tasks (e.g., 'When producing a threat-actor TTP report from a vendor intelligence bulletin').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Overview restates the description, the 'Key Concepts' section explains ATT&CK matrix/group/Navigator basics Claude already knows, and the 'When to Use' bullets are generic templated phrasing ('When investigating security incidents that require analyzing threat actor ttps with mitre attack'); the code blocks themselves are lean, but the prose around them could be tightened. | 2 / 3 |
Actionability | Each of the five steps is a complete, executable Python script using the attackcti library with real IDs (e.g., G0016) and copy-paste-ready output handling, matching the anchor for fully executable code. | 3 / 3 |
Workflow Clarity | The five steps are clearly sequenced (query -> map -> Navigator layer -> detection gaps -> cross-group) and capped by an explicit 'Validation Criteria' checklist; the operations are read-only queries so the missing inline feedback loops are not penalized. | 3 / 3 |
Progressive Disclosure | Bundle files exist (references/api-reference.md, references/standards.md, references/workflows.md, scripts/agent.py, scripts/process.py, assets/template.md) but the body references none of them — the STIX/API details and workflow descriptions that live in those files are duplicated inline, and the References section links only to external URLs. | 2 / 3 |
Total | 10 / 12 Passed |