Skip to content

Guide · Agent skill

How to use the SOC Escalation Matrix Builder agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

The building-soc-escalation-matrix skill teaches an AI agent how a Security Operations Center sorts security incidents into priority levels (P1 to P4), assigns who handles each one, and sets response and update deadlines. This guide explains what the skill does, how to install it, how to ask for it in plain language, and what to check before you rely on its output. You do not need prior experience with agent skills to follow it.

SOC Escalation Matrix Buildermukul975/Anthropic-Cybersecurity-Skills · Apache-2.0

Quick start

  1. 1Download and unzip. Download the ZIP from this page and unzip it to get the building-soc-escalation-matrix folder.
  2. 2Place the skill folder. Move the folder into ~/.claude/skills/ for personal use or into .claude/skills/ in a project. Alternatively, upload it in Settings, Capabilities, Skills in the Claude apps.
  3. 3Check Python. Confirm Python 3.8 or later is available if you plan to run the included scripts.
  4. 4Ask for the matrix. Describe your SOC structure, tiers and asset types in a plain-language request.
  5. 5Review the defaults. Compare the example SLAs and triggers against your policies and legal obligations before adopting them.
  6. 6Adopt and test. Use the agent's templates and optional script output in a lab or review process before live use.

What the skill makes the agent do

Once the skill is installed, the agent can draft a complete SOC escalation matrix. That includes severity tiers, the analyst tier responsible for each, notification steps and message templates. The skill's source describes context-driven escalation, which combines business risk, asset criticality and data sensitivity instead of severity alone. The escalation decision matrix in the source, for example, rates an incident as P1 when a Critical severity meets High or Critical asset criticality.

The skill also includes two Python scripts, scripts/agent.py and scripts/process.py, that build and simulate these matrices. The skill is a planning aid. It produces documents and generic logic, not real-time response decisions.

Install the skill from the ZIP download

Download the ZIP for this skill from this page and unzip it. Then place the resulting folder in one of two locations: ~/.claude/skills/ to make it available across your projects, or .claude/skills/ inside a specific project folder to limit it to that project.

You can also upload the skill in the Claude apps. Open Settings, go to Capabilities, then Skills, and upload the skill there.

  • Personal install: ~/.claude/skills/
  • Project install: .claude/skills/ inside your project

Trigger the skill with a natural request

You do not need to type a special command. The skill's description says to use it when designing or revising how a SOC triages and escalates incidents across analyst tiers, so ask for that work in plain language. Name the goal, your context and the output you want.

Good requests name the situation: a new SOC, a revised triage policy, a SOAR playbook with escalation timers, or a training exercise. Mention your asset categories and data types if you want context-driven tiers rather than generic ones.

  • Draft an escalation matrix for a 24/7 SOC with three analyst tiers, including P1 to P4 response and resolution times.
  • Revise our P2 escalation rules so that executive account anomalies and domain controller alerts are escalated automatically.
  • Create message templates for P1 and P2 incident notifications to management.
  • Produce an SLA timer configuration for our SOAR escalation playbook, then explain each condition.
  • Build a simulation of our escalation matrix using the included scripts and show me the output.

Review the default values before use

The SLAs, triggers and tier assignments in the skill are example values. The skill's own warnings say they must be validated against your organisation's policies and regulatory obligations. The default P1 response target is 15 minutes, the P2 target is 30 minutes and the P1 resolution target is 4 hours, but these are not recommendations for your organisation.

Treat the output as a draft for review by your SOC leadership, legal and compliance teams. Do not copy the default SLAs and triggers into production without checking them against your risk profile.

  • Confirm each SLA against your contracts and regulatory duties.
  • Check that auto-escalation triggers match the assets you actually have.
  • Make sure named roles and contacts exist and are staffed for the hours you promise.

Run the included Python scripts

The skill requires Python 3.8+ to run its included scripts. The source does not name any other dependencies beyond Python 3.8+ and the prerequisite of an appropriate test or lab environment for safe execution. The files do not mention API keys or accounts.

The skill's references describe the priority tiers, alert categories and escalation chains that the scripts work from. Ask the agent to run the scripts against your own categories, then review the output before you adopt it.

python scripts/agent.py python scripts/process.py

What people use it for

  • Drafting a P1 to P4 escalation matrix for a SOC that is moving from one analyst tier to three.
  • Adding context-driven rules, such as escalating domain controller or executive account alerts automatically.
  • Writing P1 and P2 notification templates with subject lines, impact fields and update intervals.
  • Creating SOAR escalation timer conditions, such as escalating a P2 incident that is unresolved after a set age.
  • Teaching students or new analysts how tiered SOC operations and escalation paths work.

Frequently asked questions

Is the building-soc-escalation-matrix skill free?

The skill is published under the Apache-2.0 licence, as stated in its metadata. Check the licence file in the downloaded package for the full terms before you reuse or redistribute it.

What do I need to use this skill?

The source lists Python 3.8+ to run the included scripts. It does not mention API keys or accounts, and the skill does not use the network.

Does the skill run code on my computer?

Yes. The skill runs scripts, specifically scripts/agent.py and scripts/process.py, which build and simulate matrices. Review the scripts before running them, and run them in a test or lab environment as the prerequisites recommend.

Can I use this skill for live incident response?

No. The skill produces planning documents and generic logic, not real-time response decisions. It is meant for designing and revising escalation rules, not for handling an active incident.

Where do I install agent skills?

Place the unzipped folder in ~/.claude/skills/ for personal use or .claude/skills/ inside a project. You can also upload it in the Claude apps under Settings, Capabilities, Skills.

Can I use the default SLAs as they are?

The source presents the SLAs and triggers as example values that must be validated against your organisation's policies and regulatory obligations. Review them before use rather than copying them directly.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

This skill suits SOC managers, security leads, SOAR engineers and trainers who need a structured first draft of tiered escalation rules and notification templates. It is not suited to live incident response, and it should not be used as-is by any organisation that has not checked its SLAs, triggers and legal duties against its own risk profile.

Download the skill