WYRE-AI/msp-claude-plugins/msp-claude-plugins/sentinelone/sentinelone/skills/purple-ai/SKILL.md
SentinelOne Purple AI
The `purple_ai` tool — SentinelOne's natural language investigation assistant over the full Singularity telemetry model. Covers how to phrase investigative prompts, behavioral anomaly and MITRE ATT&CK TTP analysis, PowerQuery generation, and handing generated queries to the `powerquery` tool for execution.
- Source repository stars
- 42
- Declared platforms
- 0
- Static risk flags
- 1
- Last source update
- 2026-08-28
- Source checked
- 2026-08-28
Decision brief
What it does: where it fits
The `purple_ai` tool — SentinelOne's natural language investigation assistant over the full Singularity telemetry model. Covers how to phrase investigative prompts, behavioral anomaly and MITRE ATT&CK TTP analysis, PowerQuery generation, and handing generated queries to the `powerquery` tool for execution.
Not for
- Tasks that require unconfirmed production actions or broad system permissions.
- Environments where the pinned source and install steps cannot be inspected.
Compatibility matrix
Platform support, with evidence labels
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
Inspect first. Install second.
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/WYRE-AI/msp-claude-plugins --skill "msp-claude-plugins/sentinelone/sentinelone/skills/purple-ai"Inspect the Agent Skill "SentinelOne Purple AI" from https://github.com/WYRE-AI/msp-claude-plugins/blob/5005f73ba2f52cd299f58aa6bb79f4e70ae87103/msp-claude-plugins/sentinelone/sentinelone/skills/purple-ai/SKILL.md at commit 5005f73ba2f52cd299f58aa6bb79f4e70ae87103. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
What the source asks the agent to do
- 01
Anti-triggers
Executing a query you already have. purpleai writes PowerQuery;
Executing a query you already have. purpleai writes PowerQuery;Working the existing alert queue. Purple AI answers open-endedHunting on non-SentinelOne telemetry. Purple AI reasons only over - 02
MCP Tools
Call purpleai with a natural language query describing what you want to investigate:
purpleai with query="Find PowerShell processes that have established network connections to external IP addresses in the last 24 hours"purpleai with query="I need to find evidence of lateral movement using PsExec or WMI across managed endpoints"purpleai with query="What MITRE ATT&CK techniques are associated with recent alert activity?" - 03
Available Tools
Review the “Available Tools” section in the pinned source before continuing.
Review and apply the “Available Tools” source section. - 04
Using purpleai
Call purpleai with a natural language query describing what you want to investigate:
purpleai with query="Find PowerShell processes that have established network connections to external IP addresses in the last 24 hours"purpleai with query="I need to find evidence of lateral movement using PsExec or WMI across managed endpoints"purpleai with query="What MITRE ATT&CK techniques are associated with recent alert activity?" - 05
Key Concepts
Purple AI interprets natural language descriptions of threats, behaviors, and investigation goals. The key to effective use is describing what you want to find, not how to query for it.
"Find processes that are connecting to known C2 infrastructure""Show me evidence of credential dumping on Windows endpoints""Are there any endpoints where LSASS memory was accessed by unusual processes?"
Permission review
Static risk signals and limitations
Network access
The documentation includes network, browsing, or remote request actions.
"Find PowerShell scripts that download and execute content from the internet"Evidence record
Why each signal appears
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 92/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 42 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Provenance and original SKILL.md
- Repository
- WYRE-AI/msp-claude-plugins
- Skill path
- msp-claude-plugins/sentinelone/sentinelone/skills/purple-ai/SKILL.md
- Commit
- 5005f73ba2f52cd299f58aa6bb79f4e70ae87103
- License
- Apache-2.0
- Collected
- 2026-08-28
- Default branch
- main
View the original SKILL.md
SentinelOne Purple AI
Overview
Purple AI is SentinelOne's natural language cybersecurity assistant built into the Singularity platform. Through the purple_ai MCP tool, you can ask investigative questions in plain English and receive threat analysis, PowerQuery strings for hunting, MITRE ATT&CK TTP mappings, and contextual security intelligence. Purple AI understands the full SentinelOne telemetry model and can reason across endpoints, cloud workloads, identities, and network data.
Purple AI is the primary starting point for any investigation -- describe what you want to find and it will generate the appropriate PowerQuery or provide analysis. It is read-only and cannot take any remediation actions.
Anti-triggers
- Executing a query you already have.
purple_aiwrites PowerQuery; it does not run it. Hand the generated string tosentinelone-threat-hunting. - Working the existing alert queue. Purple AI answers open-ended
questions against telemetry — listing, filtering, or reading notes on
alerts that already exist is
sentinelone-alerts. - Hunting on non-SentinelOne telemetry. Purple AI reasons only over
the Singularity Data Lake. Huntress detections are
huntress-signals; ThreatLocker execution history isthreatlocker-audit-log.
MCP Tools
Available Tools
| Tool | Description | Key Parameters |
|---|---|---|
purple_ai | Natural language cybersecurity assistant | query (required) - natural language investigation prompt |
Using purple_ai
Call purple_ai with a natural language query describing what you want to investigate:
Example: Investigate suspicious PowerShell activity:
purple_aiwithquery="Find PowerShell processes that have established network connections to external IP addresses in the last 24 hours"
Example: Generate a threat hunting query:
purple_aiwithquery="I need to find evidence of lateral movement using PsExec or WMI across managed endpoints"
Example: MITRE ATT&CK analysis:
purple_aiwithquery="What MITRE ATT&CK techniques are associated with recent alert activity?"
Key Concepts
Natural Language Investigation
Purple AI interprets natural language descriptions of threats, behaviors, and investigation goals. The key to effective use is describing what you want to find, not how to query for it.
Good prompts:
- "Find processes that are connecting to known C2 infrastructure"
- "Show me evidence of credential dumping on Windows endpoints"
- "Are there any endpoints where LSASS memory was accessed by unusual processes?"
- "Find PowerShell scripts that download and execute content from the internet"
Avoid:
- "Generate a PowerQuery for..." (Purple AI works better when you describe the threat, not the output format)
- "SELECT * FROM..." (Purple AI does not use SQL)
- Overly generic requests like "Show me everything suspicious"
PowerQuery Generation
Purple AI frequently returns PowerQuery strings as part of its response. These queries can then be executed against the Singularity Data Lake using the powerquery tool. The typical workflow is:
- Ask Purple AI a natural language question
- Purple AI returns analysis and one or more PowerQuery strings
- Execute the PowerQuery with the
powerquerytool - Analyze the results
MITRE ATT&CK Integration
Purple AI maps threats and behaviors to the MITRE ATT&CK framework:
| Category | Examples |
|---|---|
| Initial Access | Phishing, drive-by compromise, supply chain |
| Execution | PowerShell, command-line, scripting engines |
| Persistence | Registry run keys, scheduled tasks, services |
| Privilege Escalation | Token manipulation, UAC bypass |
| Defense Evasion | Process injection, timestomping, obfuscation |
| Credential Access | LSASS dump, Kerberoasting, brute force |
| Discovery | Network scanning, account enumeration |
| Lateral Movement | PsExec, WMI, RDP, SMB |
| Collection | Data staging, clipboard capture |
| Command & Control | Beaconing, DNS tunneling, encrypted channels |
| Exfiltration | Data compression, exfil over C2 |
| Impact | Encryption (ransomware), data destruction |
What Purple AI Is NOT For
Purple AI is an investigative assistant. It does not:
- Modify alert status or assignments
- Quarantine or isolate endpoints
- Block threats or take response actions
- Replace the
list_alerts,get_alert, or other specific tools for structured data retrieval - Execute PowerQuery -- use the
powerquerytool for execution
For active alert management, use the alert tools (list_alerts, get_alert, etc.). For running queries against the Data Lake, use the powerquery tool.
Common Investigation Queries
Endpoint Threats
| Investigation | Purple AI Query |
|---|---|
| Suspicious PowerShell | "Find PowerShell processes connecting to external IP addresses on non-standard ports" |
| LOLBIN Activity | "Show me Living-off-the-Land Binary activity like certutil, mshta, or regsvr32 downloading files" |
| Process Lineage | "Trace the parent process chain for any suspicious child processes of explorer.exe" |
| Ransomware Indicators | "Find evidence of mass file encryption or modification of shadow copies" |
| Fileless Malware | "Detect processes running entirely from memory without a backing file on disk" |
Lateral Movement
| Investigation | Purple AI Query |
|---|---|
| PsExec Usage | "Detect PsExec or similar remote execution tools being used across the network" |
| WMI Remote Exec | "Find WMI-based remote process creation events" |
| RDP Anomalies | "Show unusual RDP connections, especially from endpoints that don't normally use RDP" |
| SMB Lateral | "Find SMB connections followed by service creation on remote hosts" |
| Pass-the-Hash | "Detect NTLM authentication attempts that may indicate pass-the-hash attacks" |
Credential Access
| Investigation | Purple AI Query |
|---|---|
| LSASS Access | "Find processes accessing LSASS memory, excluding known legitimate tools" |
| Kerberoasting | "Detect Kerberos TGS requests for service accounts that may indicate Kerberoasting" |
| Credential Files | "Find access to files commonly containing credentials like SAM, NTDS.dit, or browser credential stores" |
| Brute Force | "Show accounts with failed login attempts exceeding 10 in the last hour" |
Command & Control
| Investigation | Purple AI Query |
|---|---|
| Beaconing | "Detect periodic outbound connections that may indicate C2 beaconing behavior" |
| DNS Tunneling | "Find DNS queries with unusually long subdomain names or high query volumes to a single domain" |
| Encoded Traffic | "Show processes making HTTPS connections to recently registered domains" |
| Non-Standard Ports | "Find outbound connections on unusual ports from common applications" |
Data Exfiltration
| Investigation | Purple AI Query |
|---|---|
| Large Transfers | "Detect large outbound data transfers exceeding 100MB to external destinations" |
| Archive Creation | "Find creation of compressed archives (zip, rar, 7z) followed by network activity" |
| Cloud Upload | "Show uploads to cloud storage services like Dropbox, Google Drive, or OneDrive from unauthorized endpoints" |
| Staging | "Detect files being copied to a common staging directory before exfiltration" |
Phishing
| Investigation | Purple AI Query |
|---|---|
| Phishing Artifacts | "Find Outlook or browser processes spawning PowerShell, cmd, or script interpreters" |
| Macro Execution | "Detect Office applications launching child processes that indicate macro execution" |
| Link Clicks | "Show browser navigations to newly registered or low-reputation domains from email link clicks" |
Response Examples
Purple AI Response (PowerQuery Generated):
Based on your investigation, I've generated a PowerQuery to find PowerShell
processes with external network connections:
EventType = "IP Connect" AND SrcProcName = "powershell.exe" AND
NetConnStatus = "SUCCESS" AND NOT DstIP In ("10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16")
| columns EndpointName, SrcProcName, SrcProcCmdLine, DstIP, DstPort, EventTime
| sort -EventTime
| limit 100
This query looks for:
- Process: powershell.exe
- Event: Successful IP connections
- Destination: External IPs (excluding RFC 1918 private ranges)
MITRE ATT&CK Mapping:
- T1059.001 - Command and Scripting Interpreter: PowerShell
- T1071 - Application Layer Protocol
Purple AI Response (Analysis):
Based on the alert data, this activity is consistent with a multi-stage
attack chain:
1. Initial Access: Phishing email with malicious attachment (T1566.001)
2. Execution: Word document macro launching PowerShell (T1059.001)
3. Defense Evasion: Base64-encoded commands (T1027)
4. C2: Beaconing to external IP 203.0.113.42 every 60 seconds (T1071.001)
Recommended next steps:
- Investigate the source email and other recipients
- Check for lateral movement from the affected endpoint
- Review the PowerShell command line for IOCs
- Check if the C2 IP appears on other endpoints
Error Handling
Common Errors
| Error | Cause | Resolution |
|---|---|---|
| Empty response | Query too vague | Be more specific about the threat or behavior you're investigating |
| Authentication error | Invalid token | Verify Service User token is Account or Site level |
| Timeout | Complex query or overloaded system | Simplify the query or try again later |
| No matching data | No telemetry matching the criteria | Widen the time range or adjust the investigation scope |
Best Practices
- Describe the threat, not the query format - Say "Find PowerShell connecting to external IPs" not "Generate a PowerQuery for PowerShell"
- Be specific about behaviors - Include details like process names, network indicators, or file paths
- Include context - Mention the client, time frame, or related alerts when relevant
- Follow up on results - Use Purple AI iteratively to dig deeper into findings
- Execute generated queries - Always run Purple AI's PowerQuery output through the
powerquerytool for actual results - Combine with alert tools - Use Purple AI for investigation, then cross-reference with
list_alertsorget_alertfor specific alert context - Map to MITRE - Ask Purple AI to map findings to MITRE ATT&CK for consistent reporting
- Use for QBR preparation - Generate threat summaries for quarterly business reviews with clients
- Think in attack chains - Investigate related TTPs, not just isolated events
- Document investigation steps - Keep notes on Purple AI queries and findings for incident reports
Related Skills
- Threat Hunting - PowerQuery execution against the Data Lake
- Alerts - Structured alert retrieval and triage
- API Patterns - MCP tools reference and connection info
- Vulnerabilities - Vulnerability context for investigations
- Inventory - Asset context for investigations
Frequently asked questions
What to verify before installation and use
What does the SentinelOne Purple AI source document cover?
The `purple_ai` tool — SentinelOne's natural language investigation assistant over the full Singularity telemetry model. Covers how to phrase investigative prompts, behavioral anomaly and MITRE ATT&CK TTP analysis, PowerQuery generation, and handing generated queries to the `powerquery` tool for execution.
How do I install SentinelOne Purple AI?
The source record exposes this install command: npx skills add https://github.com/WYRE-AI/msp-claude-plugins --skill "msp-claude-plugins/sentinelone/sentinelone/skills/purple-ai". Inspect the command and pinned source before running it.
Which permission-related actions were detected?
Static rules flagged network in the source; the page lists the matching lines and excerpts.
Alternatives
Compare before choosing
coreyhaines31/marketingskills
ab-testing
When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program
coreyhaines31/marketingskills
churn-prevention
When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' 'involuntary churn,' 'people keep canceling,' 'churn rate is too high,' 'how do I keep users,' or 'customers are leaving.' Use this whenever someone is losing subscribers o
alirezarezvani/claude-skills
app-store-optimization
App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklist
wanshuiyin/Auto-claude-code-research-in-sleep
citation-audit
Use it for operations and research tasks; the detail page covers purpose, installation, and practical steps.