
soc-operations
Build, run, and improve a Security Operations Center — alert prioritization, runbook authoring, escalation criteria, on-call structure, alert tuning workflow, MTTD / MTTR / fidelity KPIs, analyst tiering, and shift handoffs. Use when the user mentions 'SOC,' 'security operations,' 'SOC analyst,' 'alert triage workflow,' 'runbook,' 'escalation,' 'on-call,' 'SOC tiering,' 'tier 1 / tier 2,' 'MTTD,' 'MTTR,' 'alert fatigue,' 'alert tuning,' 'shift handoff,' 'SOAR,' or wants to design or improve a security operations team.
- Installs
- 325
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/briiirussell/cybersecurity-skills --skill soc-operations- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads soc-operations automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
SOC Operations — Building and Running a Security Operations Center
The operations layer above siem-detection (engineering rules) and incident-triage (response). This skill is about the people and process of running 24/7 alert triage — alert prioritization, runbook authoring, escalation, on-call hygiene, MTTD / MTTR, and the slow drift toward alert fatigue that kills SOCs.
Three modes:
- Build — designing a SOC from scratch (small org standing up its first IR capability, or MSSP onboarding)
- Run — daily operations for an existing SOC
- Improve — analyzing an existing SOC's metrics and fixing the broken parts
Cross-references: siem-detection (the rules that feed alerts to the SOC), incident-triage (the playbook for confirmed incidents), threat-hunting (proactive work between alert triage), breach-patterns (what attacks the SOC should be ready for).
Mode 1 — Build a SOC
Decision: in-house, MSSP, or hybrid?
| Model | When it fits | Pitfalls |
|---|---|---|
| Fully in-house | Mature security org, ≥ 5 dedicated analysts, regulated industry | Hard to staff 24/7 with under 8 people; on-call burnout |
| Fully outsourced (MSSP) | Smaller orgs, regulated requirements without internal staffing | MSSP context drift — they don't know your business; alert tuning slow |
| Hybrid (MSSP Tier 1, in-house Tier 2+) | Most common for growth-stage companies | Handoff complexity, "MSSP filtered it but didn't tell us" gaps |
Staffing model
For 24/7 in-house coverage, the math:
- 24 × 7 = 168 hours per week of coverage needed
- One analyst at 40 hours/week (= 160 hr/yr × 50 weeks ≈ 8000 hr/yr - PTO - training ≈ 1700 productive hours)
- Minimum 5 analysts for true 24/7 if no overlap; realistic minimum 6–7 to handle PTO and burnout
- Below 6 — consider MSSP for off-hours coverage; the burnout cost of "always on" is real
Analyst tiering
Standard tier model (adjust to taste):
- Tier 1 — Triage: initial alert review. Closes false positives with notes. Escalates real findings to Tier 2. Typically follows runbooks; deviates with documentation.
- Tier 2 — Investigation: deeper analysis on escalations. Pivots across data sources, correlates events, decides "incident" vs "noise." Authors new runbooks for patterns Tier 1 should handle next time.
- Tier 3 — Engineering & response: detection engineering (see
siem-detection), threat hunting (seethreat-hunting), incident response leadership (seeincident-triage). Senior, expensive, the ones building the SOC's capability.
For small SOCs (≤ 4 analysts), the tiers collapse — every analyst does T1+T2 work, T3 is part-time or contracted. Don't pretend you have tiers if you don't.
Tools you actually need
- SIEM for log aggregation and alerting (see
siem-detection) - Case management — ServiceNow / Jira Security / TheHive / Tines workflow. Tickets, not Slack threads. Slack is for chatter; the audit trail is in the ticket
- SOAR for playbook automation — Tines, Torq, Cortex XSOAR, Splunk SOAR. Only worth it after you have stable runbooks worth automating
- EDR / NDR consoles the analyst can pivot into during triage
- Asset inventory the analyst can look up — Snipe-IT, ServiceNow CMDB, Axonius
- Documentation — a wiki where runbooks live (Notion / Confluence / GitBook). Not Slack DMs
Mode 2 — Run the SOC
Alert prioritization
When ten alerts land in five minutes, what's the order?
The default ranking (tweak per environment):
- Critical — confirmed compromise indicator (known-bad hash, C2 callback, ransomware behavior, data egress to known-bad infrastructure)
- High — credential-access patterns (LSASS dump, ticket forging), privileged-account unusual behavior, security-control disablement (EDR removed, audit log stopped)
- Medium — persistence indicators (new scheduled task, registry run key), discovery commands by service accounts, MFA failures spike
- Low — single-event anomalies, behavioral outliers without context
- Informational — context-rich events for correlation later, not actionable alone
Critical and High should never wait. Medium triages within shift (≤ 8 hours). Low and Info batched.
Runbook authoring
Every alert that fires more than 2-3 times needs a runbook. Without one, every analyst re-derives the response and quality varies.
Runbook structure:
# Runbook: [Alert name]
## Trigger: [exact SIEM rule / detection name]
## Owner: [team / person]
## Last reviewed: [date]
## Quick reference
- **What the alert means in plain English:** [one sentence]
- **Common false positives:** [list, with how to recognize]
- **Common true positives:** [list, with what to look for next]
## Triage steps
1. [Step 1 — specific query / action]
2. [Step 2]
3. [Decision point — true positive / false positive / escalate]
## False positive handling
- [How to close + what to document]
- [Whether to add to suppression list]
## True positive handling
- [Immediate containment if any]
- [Escalation to whom, with what info]
- [Link to incident-triage skill for full IR]
## Common pivots
- [Other data sources to check]
- [Other systems likely affected]
Runbooks live in version control or a versioned wiki — not in Slack DMs, not in individual analyst notes.
Escalation criteria
Escalation rules should be explicit, not "use your judgment." Judgment lives at Tier 3+; lower tiers need rules.
| Condition | Escalate to | How quickly |
|---|---|---|
| Active data egress observed | Tier 2 / on-call | Immediately |
| Privileged account behavior anomaly | Tier 2 | This shift |
| Multiple correlated alerts on one host | Tier 2 | This shift |
| Detection rule firing > 50× / hour with high TP rate | Tier 3 (engineering) | Next business day |
| Detection rule firing > 50× / hour with 100% FP | Tier 3 (engineering) | Next business day |
| Anything Tier 1 doesn't know how to handle | Tier 2 | After 30 minutes of triage |
Shift handoffs
The single most preventable cause of breaches detected days late is "the night shift had something interesting and the morning shift never heard about it."
Handoff checklist (5–10 minutes per shift):
- Open cases — what's in progress, what's blocked, what's the next step
- Watch items — anything not yet a case but worth keeping eyes on
- Active tuning — rules under tuning, FP patterns being investigated
- Pages received during shift — even if resolved, the next shift should know
- Anything you decided to ignore — and why — so next shift doesn't quietly disagree without context
Write it down. Slack handoff channel, daily summary doc, ticketing system shift report — any format works as long as it's persistent and searchable.
Mode 3 — Improve the SOC
KPIs that actually matter
| Metric | Definition | Target |
|---|---|---|
| MTTD | Mean Time To Detect — from event to alert firing | < 5 min for high-confidence rules; < 1 hr for behavioral |
| MTTR | Mean Time To Respond — from alert to triage decision | Tier 1: < 15 min for Critical; < 4 hr for Medium |
| MTTC | Mean Time To Contain — from confirmed incident to spread halted | < 1 hr for confirmed compromise (industry P50 is ~6 days; aspire higher) |
| TP rate per rule | True positives / total alerts | > 30% for any rule; tune or kill rules below |
| Alert volume per analyst per shift | Alerts per Tier 1 analyst per 8-hour shift | < 25 — above that, fatigue dominates |
| Coverage by ATT&CK tactic | Tactics with at least one detection rule | Aim for 100% Initial Access, Execution, Persistence, Defense Evasion, Credential Access |
| Runbook coverage | % of alerts that have runbooks | > 80% of alert volume |
| Time to runbook | New alert-type to runbook delivered | < 5 alerts of the new type |
Don't measure things you can't act on. "Number of alerts processed" is a vanity metric — it goes up with noisier rules.
The tuning loop
The dominant SOC failure mode is alert fatigue from un-tuned rules. The loop that prevents it:
- Weekly: review top-N rules by alert volume
- For each high-volume rule: what's the TP rate? If < 30%, the rule is broken — tune or retire
- Retire vs tune: if the rule's underlying concept is sound, tune (add filter, increase threshold, add allow-list); if the concept is unsound (anomaly that's normal in your environment), retire
- Document every retirement — future engineers will want to know why the rule went away
- Track tuning cycles — "rule X tuned 3 times in 6 months" means the rule concept is wrong, not the parameters
See siem-detection's tuning section for the engineering side; this is the operations side.
Alert fatigue diagnostic
Symptoms your SOC is suffering:
- Tier 1 analysts closing alerts in < 30 seconds (not investigating, just clicking through)
- Same alert types ignored repeatedly without documented suppression
- Analyst turnover > 25% / year
- "We didn't catch X" post-mortems pointing to an alert that fired but wasn't actioned
When you see these: full-stop the new-rule pipeline and spend a cycle on tuning. Adding more rules to an over-firing SOC makes things worse.
Output Format
# SOC Assessment / Build Plan
## Organization: [name]
## Mode: Build / Run / Improve
## Date: [date]
### Current state (or proposed)
- Coverage hours, staffing model
- Tier structure
- Tools in use
- Alert volume / day
- Key metrics — MTTD, MTTR, TP rate distribution
### Findings (Improve mode) / Gaps (Build mode)
| Category | Issue / Gap | Severity |
|----------|-------------|----------|
### Recommendations
| Priority | Item | Owner | Timeline |
|----------|------|-------|----------|
### KPI dashboard proposal
[What to measure, how to source it, target thresholds]
### Runbook backlog
[Alert types that lack runbooks, ranked by volume]
Boundaries
- This skill produces operations plans, not exploitation
- Refuse to design SOC capabilities for unauthorized surveillance of employees or third parties
- Alert tuning that intentionally hides legitimate security events is a finding, not a deliverable
- Don't help build "compliance-theater" SOCs — if the org's intent is "check the box without actually detecting," push back
- Where the assessment surfaces an active incident, hand off to
incident-triage— don't continue planning work mid-fire
References
- NIST SP 800-61 Rev. 3 (Computer Security Incident Handling Guide)
- "Crafting the InfoSec Playbook" — Bollinger / Enright / Valites
- "The Practice of Network Security Monitoring" — Richard Bejtlich
- "Intelligence-Driven Incident Response" — Brown / Roberts
- SANS SOC Survey (annual)
- Gartner Magic Quadrant for SIEM (rotating — use the current edition)
- ATT&CK for SOC analysts —
attack.mitre.org/resources/training - MITRE D3FEND — defensive countermeasures catalog
- "SOC Maturity Model" — various — pick one and measure against it
FAQ
What does the soc-operations skill do?
Build, run, and improve a Security Operations Center — alert prioritization, runbook authoring, escalation criteria, on-call structure, alert tuning workflow, MTTD / MTTR / fidelity KPIs, analyst tiering, and shift handoffs. Use when the user mentions 'SOC,' 'security operations,' 'SOC analyst,' 'alert triage workflow,' 'runbook,' 'escalation,' 'on-call,' 'SOC tiering,' 'tier 1 / tier 2,' 'MTTD,' 'MTTR,' 'alert fatigue,' 'alert tuning,' 'shift handoff,' 'SOAR,' or wants to design or improve a security operations team.
How do I install soc-operations?
Run npx skills add https://github.com/briiirussell/cybersecurity-skills --skill soc-operations in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/soc-operations/ (personal) or .claude/skills/soc-operations/ (project).
Which AI agents can use soc-operations?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is soc-operations safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains soc-operations?
It is published by briiirussell in briiirussell/cybersecurity-skills. It has 325 recorded installs.
More from briiirussell/cybersecurity-skills
owasp-audit
briiirussell/cybersecurity-skills
Audit application source code against the OWASP Top 10 (2021) vulnerability categories — broken access control, cryptographic failures, injection, insecure design, security misconfiguration, vulnerable components, authentication failures, data integrity, logging failures, SSRF. Use when the user mentions 'OWASP,' 'OWASP Top 10,' 'security audit,' 'security review,' 'secure code review,' 'code security review,' 'vulnerability audit,' 'find vulnerabilities,' 'appsec review,' 'application security audit,' 'check for security issues,' 'broken access control,' 'IDOR,' 'SQL injection,' 'XSS,' 'SSRF,' or wants to check their codebase for common security weaknesses.
web-pentest
briiirussell/cybersecurity-skills
Perform black-box / grey-box web application penetration testing on an authorized target — auth bypass, IDOR, session handling, business-logic flaws, parameter tampering, Burp Suite / OWASP ZAP workflows. Use when the user mentions 'web pentest,' 'web application penetration test,' 'pentesting,' 'bug bounty,' 'Burp Suite,' 'ZAP,' 'OWASP testing,' 'authentication testing,' 'session testing,' 'authorization testing,' 'business logic testing,' 'web vulnerability testing,' or has explicit authorization to test a live web application.
api-audit
briiirussell/cybersecurity-skills
Audit REST, GraphQL, and RPC APIs against the OWASP API Security Top 10 (2023). Use when the user mentions 'API security,' 'API audit,' 'BOLA,' 'broken object level authorization,' 'BFLA,' 'function-level authorization,' 'mass assignment,' 'API rate limiting,' 'GraphQL security,' 'REST security,' 'API authentication,' 'API authorization,' 'excessive data exposure,' or needs to review API endpoints for security weaknesses.
dependency-audit
briiirussell/cybersecurity-skills
Audit project dependencies, frameworks, languages, and dev tools for known vulnerabilities, CVEs, and security anti-patterns. Use when the user mentions 'dependency audit,' 'npm audit,' 'CVE,' 'vulnerable packages,' 'supply chain security,' 'outdated dependencies,' 'known vulnerabilities,' 'security advisory,' 'package security,' 'framework vulnerability,' 'is this package safe,' or needs to check whether their stack has known security issues.
secrets-audit
briiirussell/cybersecurity-skills
Find leaked secrets in source code, Git history, build artifacts, and infrastructure — and audit the secrets-management posture preventing future leaks. Use when the user mentions 'secrets audit,' 'secret scanning,' 'leaked credentials,' 'API key in code,' 'gitleaks,' 'trufflehog,' 'git history scan,' 'secrets management,' 'vault audit,' 'rotation policy,' 'AWS Secrets Manager,' 'HashiCorp Vault,' 'Doppler,' '1Password Secrets Automation,' 'sealed-secrets,' 'External Secrets Operator,' or needs to find or prevent credential exposure.
threat-modeling
briiirussell/cybersecurity-skills
Open the skill to read its SKILL.md instructions.
Popular security skills
azure-compliance
microsoft/azure-skills
Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.
minimal-run-and-audit
lllllllama/rigorpilot-skills
Rigor Run skill for README-first deep learning repo reproduction. Use when the task is specifically to capture or normalize evidence from the selected smoke test or documented inference or evaluation command and write standardized reprooutputs/ files, including patch notes when repository files changed. Do not use for training execution, initial repo intake, generic environment setup, paper lookup, target selection, hidden scientific-meaning changes, or end-to-end orchestration by itself.
seo-audit
coreyhaines31/marketingskills
When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," "SEO health check," "my traffic dropped," "lost rankings," "not showing up in Google," "site isn't ranking," "Google update hit me," "page speed," "core web vitals," "crawl errors," "indexing issues," "stuck on page 2," "striking distance keywords," "title tag rewrite," "low CTR," "local SEO," "Google Business Profile," or "map pack." Use this even if the user just says something vague like "my SEO is bad" or "help with SEO" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.
firebase-security-rules-auditor
firebase/agent-skills
Audits Firebase (Firestore, Cloud Storage) security rules for vulnerabilities, privilege escalation, role bypasses, create vs update inconsistencies, resource exhaustion, type safety, size limits, and hasOnly ownership checks. Use when auditing/reviewing rules, running red-team rule assessments, or scoring against auditor checklists. Don't use for Firebase CLI (login, deploy), Auth, Crashlytics, Remote Config, or database queries.
audit
pbakaus/impeccable
Run technical quality checks across accessibility, performance, theming, responsive design, and anti-patterns. Generates a scored report with P0-P3 severity ratings and actionable plan. Use when the user wants an accessibility check, performance audit, or technical quality review.
competitors
coreyhaines31/marketingskills
When the user wants to create competitor comparison or alternative pages for SEO and buyer-facing use. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'competitor teardown,' 'audit our competitor pages,' 'are our comparison pages out of date,' or 'competitive asset audit.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For auditing existing claims (not researching competitors from scratch, which is competitor-profiling; not technical SEO on these pages, which is seo-audit), use the asset audit here. For internal battle cards and sales-specific competitor docs, see sales-enablement.