security-investigator-automation — Claude Code skill for Microsoft Sentinel investigations
A skill that runs security investigations across Microsoft Sentinel, Defender XDR and Graph API from a plain-language request.
npx skills add reason-machines/security-skills --skill security-investigator-automation -a claude-codeWhat security-investigator-automation does
This skill drives investigations through the Microsoft security stack: Sentinel, Defender XDR, Graph API and threat intelligence services. It ships 25 workflows with KQL queries, indicator enrichment and HTML report generation. The main surface is VS Code Copilot Chat in Agent mode; the skill also installs into Claude, Codex, Cursor, Gemini CLI and OpenCode.
Setup goes through three templates. config.json.template holds your Sentinel workspace and Azure tenant identifiers, .env.template holds keys for IPInfo, AbuseIPDB, vpnapi.io and Shodan, and .vscode/mcp.json.template wires the MCP servers: @sentinel-datalake, @sentinel-triage, @graph-api, @kql-search, @microsoft-learn, @azure-mcp-server and @sentinel-graph in private preview. Skip the threat intelligence keys and enrichment quietly degrades.
The suggested first prompt is a threat pulse scan, which sweeps 9 security domains and returns findings by priority. After that the skill picks a workflow from keywords: user, incident, indicator, device, authentication, Conditional Access, behavioural drift. Baseline-dependent workflows such as device or service principal scope drift need history to compare against, so a fresh tenant gives thin results on day one.
What it helps with
- check a user across sign-in logs and Identity Protection alerts
- break down an incident with a criticality rating and MITRE ATT&CK mapping
- score an IP against several threat intelligence sources
- spot drift in device or service principal behaviour
- produce an HTML report from an investigation
Example prompts for the agent
- Run a threat pulse scan and show me what needs attention
- Analyze incident 12345 and map the entities to MITRE ATT&CK
- Is this IP malicious? 203.0.113.42
How to install security-investigator-automation
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill security-investigator-automation -a claude-code2Manually: put the files in place
~/.claude/skills/security-investigator-automation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/security-investigator-automation/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill security-investigator-automation -a codex2Manually: put the files in place
.agents/skills/security-investigator-automation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill security-investigator-automation -a cursor2Manually: put the files in place
.cursor/skills/security-investigator-automation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/security-skills security-investigator-automation2Manually: put the files in place
.github/skills/security-investigator-automation/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill security-investigator-automation -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/security-skills --path skills/security-investigator-automationManually: put the files in place
.devin/skills/security-investigator-automation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill security-investigator-automation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about security-investigator-automation
How do I install security-investigator-automation in Claude Code?
Run npx skills add reason-machines/security-skills --skill security-investigator-automation -a claude-code. The skill lands at ~/.claude/skills/security-investigator-automation/SKILL.md.
What does security-investigator-automation do?
It runs security investigations across Microsoft Sentinel, Defender XDR and Graph API from natural-language prompts. It pulls the data, enriches indicators from outside sources and writes an HTML report.
What has to be in place before the first run?
Fill config.json with your Sentinel and Azure identifiers, put IPInfo, AbuseIPDB, vpnapi.io and Shodan keys in .env, and build .vscode/mcp.json from the template.