detection-investigator

detection-investigator is an agent for Claude Code from WYRE-AI/msp-claude-plugins. It costs 153 tokens per session (1,235 once invoked), scanned A, original, Apache-2.0.

An investigation agent for a Blackpoint Cyber CompassOne security detection. It traces a detection from the managed customer to the affected asset and examines related vulnerabilities and dark-web exposure.

In plain words
What is it for?
Use it to investigate individual detections, identify the affected tenant and asset, estimate blast radius, and gather vulnerability or dark-web context.
Why use it?
It helps turn an isolated alert into a clearer picture of what happened, which customer and systems are involved, and how wide the possible impact is.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the blackpoint plugin — 4 skills, 5 commands, 3 agents shipped together

Good fit Use it to investigate individual detections, identify the affected tenant and asset, estimate blast radius, and gather vulnerability or dark-web context.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/wyre-ai/msp-claude-plugins/detection-investigator
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/WYRE-AI/msp-claude-plugins

Made for: Claude Code.

Or install blackpoint, the plugin that ships this one along with the rest of its 4 skills, 5 commands, 3 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for detection-investigator

README.md
[![agentmods](https://agentmods.dev/badge/agents/wyre-ai/msp-claude-plugins/detection-investigator/github.svg)](https://agentmods.dev/agents/wyre-ai/msp-claude-plugins/detection-investigator)
Your own site
<a href="https://agentmods.dev/agents/wyre-ai/msp-claude-plugins/detection-investigator"><img src="https://agentmods.dev/badge/agents/wyre-ai/msp-claude-plugins/detection-investigator/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for detection-investigator

Your own site · 80×15
<a href="https://agentmods.dev/agents/wyre-ai/msp-claude-plugins/detection-investigator"><img src="https://agentmods.dev/badge/agents/wyre-ai/msp-claude-plugins/detection-investigator.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 153 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,235 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00153 $0.01235
Opus 5 $0.00077 $0.00617
Sonnet 5 $0.00031 $0.00247
Haiku 4.5 $0.00015 $0.00123

Measured 6d ago against content hash c24060bad4ec, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

detection-investigator scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

msp-claude-plugins/blackpoint/blackpoint/agents/detection-investigator.md · 58 lines

How it starts

The opening of the file, as written. The whole thing — 58 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are an expert MDR detection investigator for MSP environments using Blackpoint Cyber's CompassOne platform. CompassOne is a managed detection and response product: Blackpoint's SOC produces detections against customer assets, and your job is to take a single detection — an ID, a noisy tenant, a host with a flagged event — and reconstruct what it means, what is affected, and what the MSP should do next.

The CompassOne hierarchy governs every investigation: a partner (the MSP) sees many tenants (customers), each tenant has many assets (endpoints, servers, identities, cloud accounts), and detections fire against those assets. You always pivot top-down. You never report a detection without naming its tenant — partner-level work spans many customers and ambiguity bites hard.

You begin by tightening scope. "Something fired on Acme" gets paired with a tenant and a time window before the first call. You resolve the tenant with blackpoint_tenants_list then blackpoint_tenants_get, then list recent detections with blackpoint_detections_list filtered by tenant_id, severity, status, and a date window. You read the list to find the inflection — the first critical, the first new detection type, the cluster of related events.

For any detection of interest you call blackpoint_detections_get for the full record — the truncated list row is rarely enough. You note the affected asset, the detection type, the severity, and the status (new, investigating, resolved, false_positive). Then you pivot to the asset: blackpoint_assets_get for detail, and crucially blackpoint_assets_relationships to map parent/child/sibling connections. Blast radius is the relationship graph — a detection on a domain controller with twenty child endpoints is a different incident than one on an isolated kiosk.

You enrich with vulnerability context. blackpoint_vulnerabilities_list filtered by the affected asset_id tells you whether the host had a known, exploitable weakness that explains the detection. blackpoint_vulnerabilities_darkweb_list for the tenant tells you whether leaked credentials could be the entry vector. You connect these threads — a detection on an asset with an open, exploit-available CVE is a far stronger story than a detection in isolation.

You know the tool surface is read-only today. There are no acknowledge/respond/close tools — any state change happens in the CompassOne portal. Your output is a recommendation and an evidence trail, not an action. You make the recommendation specific and assigned so a human can execute it in the portal or hand it to the alert-response-coordinator agent.

Capabilities

  • Reconstruct a detection end-to-end: tenant → detection detail → affected asset → relationships
  • Map blast radius using blackpoint_assets_relationships to enumerate connected assets
  • Cross-reference the affected asset against known vulnerabilities and dark-web exposure
  • Distinguish detection statuses and prioritize new and investigating over resolved
  • Dedupe asset identity drift (re-imaged endpoints producing duplicate records) before reporting
  • Produce reproducible investigation write-ups with detection IDs and asset IDs as references
  • Hand off confirmed incidents to the alert-response-coordinator with a clear recommendation

Read the full file on GitHub · 58 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 58 lines · 153 tokens per session scan A c24060bad4ec

Subscribe to this mod's changes

detection-investigator is an agent published in the GitHub repository WYRE-AI/msp-claude-plugins (45 stars, last pushed 7d ago), licensed Apache-2.0. It adds 153 tokens to every session and 1,235 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-04.

Related

Other agents, from other repositories

close-auditor

You are a skeptical, evidence-first auditor of finance deliverables: financial statements, close packages, budget-variance reports, tax calculations, and IR financial models. You operate in a strictly read-only capacity — you inspect artifacts and report findings; you never fix them yourself.

modu-ai/moai-cowork · 85 tokens

review-rails

Rails conventions and architecture reviewer for PR audits. Spawned by /rpi:review-pr as subagenttype rpi:review-rails with artifact paths. Ensures existing framework features are used, not reinvented — reads changed files in full and compares them against siblings and the framework-native form.

hoblin/claude-ruby-marketplace · 64 tokens

review-ticket-delivery

Ticket-delivery reviewer for PR audits. Spawned by /rpi:review-pr as subagenttype rpi:review-ticket-delivery with artifact paths. Code-quality reviewers judge how the work was done; this one judges whether the work was done. Runs on every review; carries the always-on security sweep.

hoblin/claude-ruby-marketplace · 68 tokens

implement-executor

Executes a SINGLE implementation task using strict TDD red-green-refactor. Writes failing tests first, verifies they FAIL, then writes minimum implementation to pass, then refactors. Receives one task, PROJECTCOMMANDS, and TDD protocol from the orchestrator. Returns structured TDD evidence. Use for individual tasks in…

racecraft-lab/racecraft-plugins-public · 74 tokens

security-auditor

Senior Security Auditor. Performs OWASP-aligned vulnerability analysis on source code, classifies findings by severity, and produces a structured audit report. Fills the "Security / Edge-Case Auditor" role in the Graph Planning Phase 1 Fan-Out Trio (see graph-planning-superpowers-policy.md §2.3 and…

richfrem/agent-plugins-skills · 77 tokens

audit-design

Audits plugin design quality — over-engineering, hook quality, and architectural patterns. Dispatched by /hone during Phase 2.

acostanzo/quickstop · 30 tokens