Guide · Agent skill
How to use the Vulnerability Aging and SLA Tracking agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
This guide explains how to install and use the building-vulnerability-aging-and-sla-tracking agent skill, a set of instructions and Python scripts that help an AI agent design a vulnerability remediation SLA policy and measure how long findings stay open. It is aimed at security and vulnerability management teams, and at engineers who need code to calculate vulnerability age from scan data. By the end you will know how to install the skill, ask for the right outputs, and check the results before you rely on them.
Quick start
- 1Download and unzip. Download the ZIP from this page and unzip it. Keep the folder named building-vulnerability-aging-and-sla-tracking intact.
- 2Place the skill. Put the folder in ~/.claude/skills/ for personal use or in a project's .claude/skills/ folder, or upload the ZIP under Settings → Capabilities → Skills in the Claude apps.
- 3Install pandas. Make sure Python 3 is available and install pandas, which scripts/process.py requires.
- 4Prepare your CSV. Export vulnerability data with discovery_date, remediation_date and severity columns.
- 5Align the SLA values. Compare the hardcoded SLA values in scripts/agent.py and SKILL.md, and set them to match your policy.
- 6Ask for the output. Describe your policy and data in a request, such as asking for an aging report and escalation list from your CSV.
- 7Verify on a sample. Run the process on a small known dataset and confirm the ages, overdue flags and KPIs are correct before using them.
What the skill makes the agent do
An agent skill is a folder of instructions and optional scripts that an AI agent loads when your request matches the skill's description. This one covers vulnerability aging and SLA tracking: measuring time-to-remediation against severity-based deadlines, flagging overdue items, triggering escalation steps and producing compliance metrics.
The SKILL.md file uses a standard framework of 14 days for critical, 30 days for high, 60 days for medium and 90 days for low vulnerabilities. It also includes adaptive modifiers, such as shorter deadlines for internet-facing assets or CISA KEV-listed vulnerabilities, and an escalation path that starts with a reminder at 50% of the SLA elapsed and reaches VP/CTO escalation at 120%.
- Design an SLA policy with deadlines by severity
- Calculate age, days overdue and percent of SLA elapsed for each vulnerability
- Produce an escalation list from open items
- Report KPIs such as mean time to remediate (MTTR), SLA compliance rate and overdue count
Install the skill
Download the ZIP file from this page and unzip it. You can install the skill in one of two ways.
For Claude Code, unzip it into ~/.claude/skills/ to make it available in all your projects, or into a project's .claude/skills/ folder to limit it to that project.
In the Claude apps, upload the ZIP under Settings → Capabilities → Skills.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside your project folder
- Claude apps: Settings → Capabilities → Skills
Set up what the skill needs
The skill needs Python 3 and pandas, because scripts/process.py depends on pandas. Your input must be a vulnerability export in CSV form that contains discovery_date, remediation_date and severity columns. Ticketing data or a reporting tool such as Splunk, Elastic, Power BI or Grafana is optional, and is useful for dashboards.
Without real discovery and remediation dates, the output will not mean anything.
- Python 3 and pandas
- A CSV export with discovery_date, remediation_date and severity columns
- Optional: ticketing or reporting platform such as Splunk, Elastic, Power BI or Grafana
pip install pandasTrigger the skill with natural requests
You do not need to name the skill. Ask in plain language about SLA policy, aging or remediation timelines, and the agent should load it. Be specific about your inputs and the output you want, such as a CSV path and whether you want a report or code.
Name the file and the outcome. The more context you give about your policy, the less the agent has to guess.
- "Set up a remediation SLA policy with 14 days for critical and 30 days for high, and write the calculation logic."
- "Here is vulnerabilities.csv. Calculate age and overdue status for each open finding and list what needs escalation."
- "Give me MTTR and SLA compliance rate by severity from this export for next month's security committee report."
Review the scripts and align the SLA values before use
The bundled scripts are scripts/agent.py and scripts/process.py. According to the skill's assessment, the scripts can process a CSV export and output aging reports and escalation lists. The skill's own notes say the scripts use hardcoded SLA values that differ between SKILL.md and scripts/agent.py, so you must check them against your own policy before you run anything.
The skill runs scripts. It does not use the network, according to its listing, so review the code yourself before running it on production data.
- Read scripts/agent.py and scripts/process.py and confirm the SLA values match your policy
- Test on a small sample CSV with known dates first
- Check that the escalation percentages match the escalation path you approved
Examples of useful output
Ask for the parts you need. The skill's template in assets/template.md includes a KPI summary, an aging distribution table by severity and an escalation summary table. Its references include standards such as NIST SP 800-40 Rev 4, CIS Controls v8.1 Control 7, PCI DSS v4.0 Req 6.3.3 and ISO 27001:2022 A.8.8.
Treat the reference tables as starting points. Some of them differ from the SKILL.md defaults, so pick one set of values and use it consistently.
- KPI summary: total open, MTTR, SLA compliance rate, overdue count, exception count
- Aging distribution by severity across age buckets
- Escalation list of open items with their level
What people use it for
- Setting up a remediation SLA policy with severity deadlines and escalation steps for a security team
- Calculating vulnerability age and overdue status from scan exports for a weekly review
- Producing MTTR and SLA compliance figures for a monthly security committee report
- Preparing evidence of remediation timelines for an audit or compliance review
Frequently asked questions
Is the building-vulnerability-aging-and-sla-tracking skill free to use?
The skill is listed under the Apache-2.0 licence. Check the licence file in the repository for the terms that apply to your use. This page does not state any price.
What do I need to run this skill?
You need Python 3, pandas for scripts/process.py, and a CSV export with discovery_date, remediation_date and severity columns. A ticketing or reporting platform such as Splunk, Elastic, Power BI or Grafana is optional.
How do I install the skill in Claude?
Download the ZIP and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder. In the Claude apps, you can upload the ZIP under Settings → Capabilities → Skills.
Does the skill send my data over the network?
The listing says the skill uses no network. The scripts do run, so review scripts/agent.py and scripts/process.py before using them on sensitive data.
Why do the SLA values in the scripts differ from the SKILL.md?
The skill's notes say the scripts use hardcoded SLA values that differ between SKILL.md and scripts/agent.py. Choose one set that matches your own policy and align both files before you use the output.
Can I use this skill instead of a vulnerability management platform?
Not as a replacement. The skill builds the calculations and reports on top of data you already have, and it expects a scanner or ticketing export as input.
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
Use this skill if you are a security or vulnerability management team setting up SLA policies and aging reports, or an engineer who needs Python logic for vulnerability age from real scan data. Pick something else if you have no scanner or ticketing data, or if you want a turnkey product, since the scripts need review and alignment to your policy first.
Download the skill