agentleFS
kaandgnshkaandgnsh/Claude-Blue/skills/security-testing/purple-team-exercise/SKILL.md

purple-team-exercise

Skill0 starsChanged 13 days agoMITView on GitHub

Plan and run a purple-team exercise where offensive operators and defenders work in the same room on threat-relevant procedures, covering objective and threat selection, procedure list, telemetry checks per step, live tuning, evidence capture and a remediation backlog. Use when organizing a purple-team day or week, turning red-team findings into detections, or validating readiness against a specific threat actor.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep 15-30 procedures for a day.

    line 35
  2. Distinctive:

    If missed: decide now whether it is a telemetry gap, rule gap or tuning gap.

    line 48
  3. Distinctive:

    No telemetry check: a "missed" detection that was never logged gets a rule written against data that does not exist.

    line 72

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Purple-Team Exercise

The value of purple teaming is the tight loop: run a procedure, look for it together, fix the gap, run it again. Without a written plan it degenerates into a red-team demo; without defenders at the keyboard it is just an audit.

1. Objective and threat selection

Pick one objective per exercise:

  • Readiness against a named threat (e.g., a ransomware affiliate seen in your sector in the last 12 months).
  • A kill-chain segment you have little evidence for (credential access → lateral movement).
  • Validation of a new control or telemetry source (new EDR, Sysmon config, identity protection).

Derive procedures from CTI (see intel-to-detection and campaign-correlation): ATT&CK techniques and the concrete procedure the actor used, not just the technique ID.

2. Procedure list

#TechniqueProcedure (actor-realistic)ToolTargetExpected telemetryExpected detection
1T1566.001Container file (ISO/ZIP) attachment with a shortcut, benign payloadManual, test mailboxTest mailboxMail flow, file creation, LNK execMail gateway + EDR LNK child process
2T1059.001Encoded PowerShell command fetching a benign test fileAtomic T1059.001WS-PT14104 script block, process creationEncoded PS rule
3T1003.001LSASS memory access with a built-in Windows component (as in the CTI report)Atomic T1003.001WS-PT1Sysmon 10 / EDR LSASS accessLSASS access rule
4T1021.002Remote service execution over SMB with a test admin accountAtomic T1021.002SRV-PT24624 type 3, service install 7045Lateral movement rule
5T1547.001Run key persistenceAtomic T1547.001WS-PT1Registry setRun key rule

Keep 15-30 procedures for a day. Order them along the kill chain so later steps reuse earlier access.

3. Roles and ground rules

  • Exercise lead (owns the schedule, safety calls), operators (execute), detection engineers and SOC analysts (search, tune), scribe (evidence log), asset owners on call.
  • Signed rules of engagement and deconfliction (see security-test-planning, attack-simulation-safety).
  • Dedicated test hosts and accounts tagged in the SIEM (purple-team tag) so any alert from them is routed to the exercise channel, not to on-call.

4. The loop per procedure

  1. Operator announces and executes; scribe logs UTC time, host, command line.
  2. Defenders check telemetry first: does the raw event exist? Record yes/no and the event IDs.
  3. Then detection: did an alert fire, which rule, how fast, with what severity?
  4. If missed: decide now whether it is a telemetry gap, rule gap or tuning gap. If a rule fix is quick, write it, deploy to test, re-run the procedure.
  5. Record outcome: blocked, detected, logged-only, not-logged.

5. Evidence

Per procedure keep: exact command, timestamp, host, screenshots/exports of raw events, alert IDs, the rule version before and after tuning. After the exercise, score all procedures with detection-validation against the exported alerts so the report is not based on memory.

6. Outputs

# Purple-team exercise: <objective>   Dates: <dates>   Lead: <role>
Procedures: 24   Blocked: 3   Detected: 12   Logged-only: 6   Not logged: 3
New/updated rules deployed during exercise: 5 (re-tested: 5 pass)
## Backlog
| ID | Gap type | Technique | Fix | Owner | Due | Re-test date |
## ATT&CK layer: tested coverage as of <date> (attached)

Schedule a re-test of every backlog item; an unverified fix is still a gap.

Common mistakes

  • Running default Atomic tests only: they detect the tool, not the actor's procedure.
  • Testing on hosts without production-like agents and policies.
  • No telemetry check: a "missed" detection that was never logged gets a rule written against data that does not exist.
  • Leaving test persistence or accounts behind (cleanup checklist in attack-simulation-safety).

Related skills

detection-validation, security-test-planning, attack-simulation-safety, detection-testing, attack-coverage-mapping, hunt-to-detection

References

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.