Incident Response
Create an incident response plan for "$ARGUMENTS" with severity classifications, response playbooks per incident type, defined roles, communication protocols, and escalation paths.
Arguments. $ARGUMENTS may contain the project name and optional flags. Take the first token as <project> and treat --skip-checks as a flag; never include flags in file paths. All paths below use <project>. If --skip-checks is present, skip the prerequisite check and, before writing any artifact, append one line to .singularskills/log.jsonl: {"ts":"<ISO timestamp>","skill":"security-incident-response","workflow":"security","phase":4,"project":"<project>","event":"skipped","artifact":"04-respond.md","note":"<reason or \"none given\">"}.
Prerequisites
Part of a workflow. This skill is phase 4 (Respond) of the NIST CSF workflow (security); cross-domain workflows run it too. First check .singularskills/log.jsonl for an open run for this project: a run-started line with "project":"<project>" and no later run-finished line for the same workflow and project. If one exists, the conductor is running you: continue here. Otherwise, if the user asked to start, run, continue or resume a process or workflow rather than this one step, do not continue here: invoke the workflow skill with the workflow the user asked for, or security when they named none, followed by <project>; it runs this phase in order, asks before it writes and records the run. Otherwise continue here: a later phase runs on its own, behind its gate.
Run this skill's gate before writing: sh <this skill's folder>/scripts/gate.sh <project> <project root>, where <project root> is the folder that contains .singularskills/ (use . when you are already there). If it exits non-zero, stop and tell the user what it printed, unless --skip-checks was given (see Arguments). On a refusal, before you stop, append this line to .singularskills/log.jsonl (create the folder and file if missing): {"ts":"<ISO timestamp>","skill":"security-incident-response","workflow":"security","phase":4,"project":"<project>","event":"refused","artifact":"04-respond.md","note":"<what the gate printed>"}. Once the gate has passed, or under --skip-checks once you have appended the skipped line, append this line before you start work: {"ts":"<ISO timestamp>","skill":"security-incident-response","workflow":"security","phase":4,"project":"<project>","event":"started","artifact":"04-respond.md","note":""}.
Read .singularskills/security/<project>/00-govern.md. If this file does not exist, tell the user:
Phase 0 (Govern) has not been completed for "". Run a Govern skill first (e.g., /security-security-policy <project>), or use --skip-checks to bypass.
Process
Read context files:
- Read
references/incident-response-template.md for methodology reference and output structure
- Read
.singularskills/security/<project>/00-govern.md for organizational context and risk appetite
Define severity classification (P1–P4):
- P1 — Critical: confirmed data breach, ransomware spreading, active attacker with privileged access, complete service outage affecting all customers
- P2 — High: suspected data breach under investigation, targeted attack detected, partial service outage affecting significant user segment
- P3 — Medium: vulnerability actively exploited with limited impact, unauthorized access attempt partially successful, single-service degradation
- P4 — Low: policy violation detected, failed attack attempt, minor security misconfiguration discovered
- Define criteria for each level: data sensitivity, blast radius, regulatory implications, business impact
Create response playbooks per incident type:
- Data breach — identify compromised data, assess scope, contain exfiltration, preserve evidence, notify affected parties and regulators
- DDoS attack — activate DDoS mitigation (CDN, WAF rules, rate limiting), identify attack vectors, engage upstream providers, scale infrastructure
- Ransomware — isolate affected systems immediately, assess encryption scope, activate backup recovery, engage law enforcement if appropriate
- Insider threat — preserve evidence before alerting subject, restrict access silently, coordinate with HR and legal, investigate scope of access
- Supply chain compromise — identify affected dependencies, assess blast radius, isolate compromised components, verify integrity of remaining systems
- Each playbook includes: detection triggers, immediate actions (first 15 minutes), short-term containment (first hour), investigation steps, eradication, recovery
Define response team roles:
- Incident Commander — owns decision-making authority, coordinates all responders, manages timeline
- Technical Lead — leads investigation and containment, directs engineering response
- Communications Lead — manages internal and external communications, coordinates with legal and PR
- Scribe — documents timeline, decisions, actions, and evidence in real time
- Subject Matter Experts — engaged as needed based on incident type (database, network, cloud, application)
- Define backup personnel for each role and activation procedures
Set communication protocols:
- Define communication channels by severity (P1: war room + phone bridge, P2: dedicated Slack channel, P3–P4: ticket-based)
- Set status update cadence (P1: every 30 minutes, P2: every 2 hours, P3: daily, P4: on resolution)
- Define who is notified at each severity level (P1: CISO + executive team, P2: security lead + engineering lead, P3: security team, P4: assigned responder)
- Template for status updates: current status, actions taken, next steps, ETA, blockers
Define escalation paths:
- Time-based escalation (P1 not acknowledged in 5 minutes → auto-escalate, P2 not acknowledged in 15 minutes → auto-escalate)
- Severity-based escalation (any incident may be escalated if scope expands or new evidence emerges)
- External escalation criteria (when to engage law enforcement, regulators, external forensic specialists, cyber insurance)
- De-escalation criteria (when to downgrade severity based on investigation findings)
Create decision trees for common scenarios:
- "Suspicious login detected" → verify with user → if confirmed unauthorized → P2, lock account, investigate scope
- "Malware alert on endpoint" → isolate endpoint → determine if lateral movement occurred → if yes, escalate to P1
- "Data exposure reported by third party" → verify claim → assess scope → if confirmed, activate data breach playbook
- "Unusual outbound traffic" → analyze destination and volume → if exfiltration suspected → P1, block traffic, preserve logs
Write the artifact — append to .singularskills/security/<project>/04-respond.md under a ## Incident Response section. Create the file with a # Respond — <project> heading if it does not exist; if a ## Incident Response section already exists, replace only that section. The section contains:
Incident Response Plan
Include sections:
- Severity Classification — P1–P4 definitions with criteria and examples
- Response Playbooks — per incident type with step-by-step actions
- Response Team — roles, responsibilities, and backup personnel
- Communication Protocols — channels, cadence, and notification matrix
- Escalation Paths — time-based, severity-based, and external escalation criteria
- Decision Trees — common scenario flowcharts
Output
The incident response plan appended to .singularskills/security/<project>/04-respond.md. Present a summary to the user highlighting:
- Severity classification criteria for P1–P4
- Playbooks created per incident type
- Response team roles and communication protocols
- Key escalation triggers and decision trees
Record the run. After you have written your section, append this line to .singularskills/log.jsonl (the started line of Prerequisites, with "event":"finished"): {"ts":"<ISO timestamp>","skill":"security-incident-response","workflow":"security","phase":4,"project":"<project>","event":"finished","artifact":"04-respond.md","note":""}.
This artifact is shared by every skill of phase 4 (Respond). The frontmatter is written once, by whoever creates the file: if you create it, open it with the block below (skill is the phase title, started the time of that first write; gate is passed when the gate ran clean and skipped under --skip-checks); if it already exists, leave the block alone except to update finished and to set gate to the worst value among the sections (skipped over passed).
---
skill: Respond
workflow: security
phase: 4
project: <project>
started: <ISO timestamp>
finished: <ISO timestamp>
agent: <the agent you run in, or "unknown">
gate: <passed|skipped>
---
Open your ## Incident Response section with one italic line, *<skill name> · <ISO timestamp> · gate: <passed|skipped>* (your skill name is security-incident-response).
End your section with ### Decisions and ### Open questions (one level under your ## Incident Response heading, so the section stays one block), in this shape:
### Decisions
- <what was chosen> — <why> — <what was rejected>
### Open questions
- <what the next phase or a reviewer must settle>
End the artifact with this paragraph, verbatim:
Not a penetration test or audit. This artifact is generated analysis; validate findings against the live system and have material controls reviewed by a qualified security professional.
1---2name: security-incident-response3description: Create a technical incident response plan — P1 to P4 severities, playbooks for breach, ransomware, DDoS, insider and supply chain attacks, roles, communication, escalation and decision trees. Use when the user has no plan for a security incident or asks what their team should do when an attack is detected. Not for legal notification deadlines; see /legal-incident-response-plan.4metadata:5 source: https://skillmd.com/skills/bromso/security-incident-response6 argument-hint: "[project] [--skip-checks]"7 workflow: security8 phase: 49 artifact: 04-respond.md10---1112# Incident Response1314Create an incident response plan for "$ARGUMENTS" with severity classifications, response playbooks per incident type, defined roles, communication protocols, and escalation paths.1516**Arguments.** `$ARGUMENTS` may contain the project name and optional flags. Take the first token as `<project>` and treat `--skip-checks` as a flag; never include flags in file paths. All paths below use `<project>`. If `--skip-checks` is present, skip the prerequisite check and, **before writing any artifact**, append one line to `.singularskills/log.jsonl`: `{"ts":"<ISO timestamp>","skill":"security-incident-response","workflow":"security","phase":4,"project":"<project>","event":"skipped","artifact":"04-respond.md","note":"<reason or \"none given\">"}`.1718## Prerequisites1920**Part of a workflow.** This skill is phase 4 (Respond) of the NIST CSF workflow (`security`); cross-domain workflows run it too. First check `.singularskills/log.jsonl` for an open run for this project: a `run-started` line with `"project":"<project>"` and no later `run-finished` line for the same `workflow` and `project`. If one exists, the conductor is running you: continue here. Otherwise, if the user asked to start, run, continue or resume a process or workflow rather than this one step, do not continue here: invoke the `workflow` skill with the workflow the user asked for, or `security` when they named none, followed by `<project>`; it runs this phase in order, asks before it writes and records the run. Otherwise continue here: a later phase runs on its own, behind its gate.2122Run this skill's gate before writing: `sh <this skill's folder>/scripts/gate.sh <project> <project root>`, where `<project root>` is the folder that contains `.singularskills/` (use `.` when you are already there). If it exits non-zero, stop and tell the user what it printed, unless `--skip-checks` was given (see Arguments). On a refusal, before you stop, append this line to `.singularskills/log.jsonl` (create the folder and file if missing): `{"ts":"<ISO timestamp>","skill":"security-incident-response","workflow":"security","phase":4,"project":"<project>","event":"refused","artifact":"04-respond.md","note":"<what the gate printed>"}`. Once the gate has passed, or under `--skip-checks` once you have appended the `skipped` line, append this line before you start work: `{"ts":"<ISO timestamp>","skill":"security-incident-response","workflow":"security","phase":4,"project":"<project>","event":"started","artifact":"04-respond.md","note":""}`.2324Read `.singularskills/security/<project>/00-govern.md`. If this file does not exist, tell the user:2526> Phase 0 (Govern) has not been completed for "<project>". Run a Govern skill first (e.g., `/security-security-policy <project>`), or use `--skip-checks` to bypass.2728## Process29301. **Read context files:**31 - Read `references/incident-response-template.md` for methodology reference and output structure32 - Read `.singularskills/security/<project>/00-govern.md` for organizational context and risk appetite33342. **Define severity classification (P1–P4):**35 - **P1 — Critical:** confirmed data breach, ransomware spreading, active attacker with privileged access, complete service outage affecting all customers36 - **P2 — High:** suspected data breach under investigation, targeted attack detected, partial service outage affecting significant user segment37 - **P3 — Medium:** vulnerability actively exploited with limited impact, unauthorized access attempt partially successful, single-service degradation38 - **P4 — Low:** policy violation detected, failed attack attempt, minor security misconfiguration discovered39 - Define criteria for each level: data sensitivity, blast radius, regulatory implications, business impact40413. **Create response playbooks per incident type:**42 - **Data breach** — identify compromised data, assess scope, contain exfiltration, preserve evidence, notify affected parties and regulators43 - **DDoS attack** — activate DDoS mitigation (CDN, WAF rules, rate limiting), identify attack vectors, engage upstream providers, scale infrastructure44 - **Ransomware** — isolate affected systems immediately, assess encryption scope, activate backup recovery, engage law enforcement if appropriate45 - **Insider threat** — preserve evidence before alerting subject, restrict access silently, coordinate with HR and legal, investigate scope of access46 - **Supply chain compromise** — identify affected dependencies, assess blast radius, isolate compromised components, verify integrity of remaining systems47 - Each playbook includes: detection triggers, immediate actions (first 15 minutes), short-term containment (first hour), investigation steps, eradication, recovery48494. **Define response team roles:**50 - **Incident Commander** — owns decision-making authority, coordinates all responders, manages timeline51 - **Technical Lead** — leads investigation and containment, directs engineering response52 - **Communications Lead** — manages internal and external communications, coordinates with legal and PR53 - **Scribe** — documents timeline, decisions, actions, and evidence in real time54 - **Subject Matter Experts** — engaged as needed based on incident type (database, network, cloud, application)55 - Define backup personnel for each role and activation procedures56575. **Set communication protocols:**58 - Define communication channels by severity (P1: war room + phone bridge, P2: dedicated Slack channel, P3–P4: ticket-based)59 - Set status update cadence (P1: every 30 minutes, P2: every 2 hours, P3: daily, P4: on resolution)60 - Define who is notified at each severity level (P1: CISO + executive team, P2: security lead + engineering lead, P3: security team, P4: assigned responder)61 - Template for status updates: current status, actions taken, next steps, ETA, blockers62636. **Define escalation paths:**64 - Time-based escalation (P1 not acknowledged in 5 minutes → auto-escalate, P2 not acknowledged in 15 minutes → auto-escalate)65 - Severity-based escalation (any incident may be escalated if scope expands or new evidence emerges)66 - External escalation criteria (when to engage law enforcement, regulators, external forensic specialists, cyber insurance)67 - De-escalation criteria (when to downgrade severity based on investigation findings)68697. **Create decision trees for common scenarios:**70 - "Suspicious login detected" → verify with user → if confirmed unauthorized → P2, lock account, investigate scope71 - "Malware alert on endpoint" → isolate endpoint → determine if lateral movement occurred → if yes, escalate to P172 - "Data exposure reported by third party" → verify claim → assess scope → if confirmed, activate data breach playbook73 - "Unusual outbound traffic" → analyze destination and volume → if exfiltration suspected → P1, block traffic, preserve logs74758. **Write the artifact** — append to `.singularskills/security/<project>/04-respond.md` under a `## Incident Response` section. Create the file with a `# Respond — <project>` heading if it does not exist; if a `## Incident Response` section already exists, replace only that section. The section contains:7677 ### Incident Response Plan7879 Include sections:80 - **Severity Classification** — P1–P4 definitions with criteria and examples81 - **Response Playbooks** — per incident type with step-by-step actions82 - **Response Team** — roles, responsibilities, and backup personnel83 - **Communication Protocols** — channels, cadence, and notification matrix84 - **Escalation Paths** — time-based, severity-based, and external escalation criteria85 - **Decision Trees** — common scenario flowcharts8687## Output8889The incident response plan appended to `.singularskills/security/<project>/04-respond.md`. Present a summary to the user highlighting:90- Severity classification criteria for P1–P491- Playbooks created per incident type92- Response team roles and communication protocols93- Key escalation triggers and decision trees9495**Record the run.** After you have written your section, append this line to `.singularskills/log.jsonl` (the `started` line of Prerequisites, with `"event":"finished"`): `{"ts":"<ISO timestamp>","skill":"security-incident-response","workflow":"security","phase":4,"project":"<project>","event":"finished","artifact":"04-respond.md","note":""}`.9697This artifact is shared by every skill of phase 4 (Respond). The frontmatter is written once, by whoever creates the file: if you create it, open it with the block below (`skill` is the phase title, `started` the time of that first write; `gate` is `passed` when the gate ran clean and `skipped` under `--skip-checks`); if it already exists, leave the block alone except to update `finished` and to set `gate` to the worst value among the sections (`skipped` over `passed`).9899```yaml100---101skill: Respond102workflow: security103phase: 4104project: <project>105started: <ISO timestamp>106finished: <ISO timestamp>107agent: <the agent you run in, or "unknown">108gate: <passed|skipped>109---110```111112Open your `## Incident Response` section with one italic line, `*<skill name> · <ISO timestamp> · gate: <passed|skipped>*` (your skill name is `security-incident-response`).113114End your section with `### Decisions` and `### Open questions` (one level under your `## Incident Response` heading, so the section stays one block), in this shape:115116```markdown117### Decisions118- <what was chosen> — <why> — <what was rejected>119120### Open questions121- <what the next phase or a reviewer must settle>122```123124End the artifact with this paragraph, verbatim:125126> **Not a penetration test or audit.** This artifact is generated analysis; validate findings against the live system and have material controls reviewed by a qualified security professional.