Validating detections with atomic tests
Skill meltedinhex/analyst-ai-pack/skills/validating-detections-with-atomic-tests
An open agent-skills library for malware analysis, reverse engineering, and threat hunting - 118 curated, runnable skills mapped to MITRE ATT&CK, D3FEND, and CAR.
npx -y skills add meltedinhex/analyst-ai-pack --skill validating-detections-with-atomic-testsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 19 stars19 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Validates detection coverage by mapping Atomic Red Team tests to ATT&CK techniques, checking which of your detections cover each tested technique, and reporting coverage gaps. Activates for requests to validate detections with atomic tests, map Atomic Red Team to coverage, or find detection gaps against tested techniques.
The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
2.7 KB, 399 tokens by cl100k_base, as published. Nobody here has run it
Validating Detections With Atomic Tests
When to Use
- You want to validate that your detections fire for specific ATT&CK techniques by correlating Atomic Red Team test definitions with your detection inventory.
- You are measuring coverage and identifying gaps before or after running atomics.
Do not use the atomics themselves on production systems without authorization and isolation — they execute adversary behaviors. This skill performs mapping/coverage analysis offline.
Prerequisites
- An export of Atomic test→technique mappings (CSV/JSON) and your detection inventory mapped to ATT&CK techniques.
Workflow
Step 1: Compute coverage
python scripts/analyst.py coverage --atomics atomics.json --detections detections.json
Joins atomic-tested techniques with your detections' covered techniques and reports covered vs uncovered techniques.
Step 2: Prioritize gaps
Rank uncovered techniques by the number of atomic tests (more atomics → more validated adversary behavior you currently miss).
Step 3: Validate live (authorized/isolated)
For covered techniques, run the corresponding atomic in an isolated range and confirm the detection fires; record results.
Step 4: Close gaps
Author detections for high-priority uncovered techniques and re-run coverage.
Validation
- Coverage join keys on ATT&CK technique IDs (including sub-techniques).
- Covered and uncovered technique lists are complete and disjoint.
- Gap prioritization reflects atomic-test counts.
Pitfalls
- Sub-technique vs parent-technique mismatch (T1059 vs T1059.001) skewing coverage.
- Claiming coverage from a rule that exists but is disabled/untuned.
- Running atomics outside an isolated, authorized range.
References
- See
references/api-reference.mdfor the coverage tool. - Atomic Red Team and ATT&CK references (linked in frontmatter).
What ships with it: 3 files
4.1 KB alongside SKILL.md, 1 of them executable
references/
- api-reference.md1.2 KB
scripts/
- analyst.pyruns2.5 KB
- LICENSE340 B
Gives 0 of the 12 instructions most test skills give in 399 tokens
Counted across 964 of the 1,571 authors here whose files we hold, read 2026-08-07
- Close the browser when donein 55 of 964, across 12 files
- Wait for network idle statein 51 of 964, across 6 files
- Launch Chromium in headless modein 49 of 964, across 6 files
- Use descriptive selectors for elementsin 49 of 964, across 6 files
- Run provided scripts with help flag firstin 49 of 964, across 6 files
- Add appropriate explicit waitsin 48 of 964, across 5 files
- Use bundled scripts as black boxesin 46 of 964, across 3 files
- Do not read script source codein 46 of 964, across 3 files
- Use sync playwright for scriptsin 46 of 964, across 3 files
- Inspect dom before executing actionsin 46 of 964, across 3 files
- Run the full test suitein 37 of 964
- Write the failing test firstin 29 of 964, across 23 files
Said here and by no other author read
- compute coverage by joining atomic tests with detections
- rank uncovered techniques by number of atomic tests
- run atomics in an isolated range to confirm detections fire
- author detections for high-priority uncovered techniques
- join coverage keys on ATT&CK technique IDs
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.