Skip to main content
Extensions are currently in Private Beta. Get in touch by email or our shared Slack channel if you’d like to try them out.
Extensions are the skills, docs, and tools you bring to incident.io’s agents, Investigations and @incident. With them, the agents can reach internal systems we have no integration for, read the data those systems return the way your team does, and follow the procedures you want used for a particular kind of incident. There are two kinds:
  • Plugins are content agents follow: skills and docs, synced from one of your repositories. A skill teaches an agent how to work in your environment, and a plugin is the bundle that carries it.
  • Connectors are systems agents call: a remote MCP server or an HTTP API you’ve connected, so an agent can query something we have no native integration for.
Most teams end up with both, because a skill is what tells an agent when to use a connector and what its results mean.
Plugins use the open agent skills and Claude Code plugin formats, and connectors speak MCP or plain HTTP. A plugin you write for us also loads in your own coding agents, so everything you write stays portable.

​
How agents use extensions

Extensions sit alongside the telemetry, code, and docs that Nexus already gives our agents, and are used in the same two places.

​
Investigations

Skills, docs, and connectors are picked up automatically. A skill is loaded when its description matches the work in front of the investigation, and connector tools are queried the way any other source is. Whatever comes back is interpreted alongside everything else the investigation has found, and shapes its conclusions. A skill that owns a system or a class of incident is followed at the very start, alongside the initial searches, so you get a more accurate first hypothesis, faster. See Triage skills.

​
The agent

Ask @incident something, wherever you talk to it, and it reaches for the same skills and connectors. Ask for an impact assessment and it can combine the incident’s alerts, a skill that says how your team sizes impact, and a connector to your data warehouse to produce one on demand.

​
A worked example

Here’s a small plugin and connector working together, modeled on how we use extensions ourselves. The problem. A customer reports that a feature has stopped working for them, and only them. Nothing is down. The most common cause is a feature flag whose targeting changed in a way that caught that customer. Investigations already see your change events. A connector adds the flag system itself, and a skill adds how your flags are structured. The connector. You connect your feature flag provider’s MCP server as a connector and allow its read-only tools: get a flag, list flags, read targeting. Investigations can now call it. On its own, though, an agent will use it the way a new hire would, taking flag names and targeting rules at face value. The paired skill. A skill named after the flag system teaches the agent to use those tools the way your team does:
skills/feature-flags/SKILL.md
None of that is in the tool definitions. It’s the knowledge an experienced responder holds. The triage skill. A second skill owns the incident class rather than a system. Its description says it applies to incidents affecting a single customer, so it’s picked up at the start of any incident that looks like that. Its procedure is the opening moves your team would make: establish which customer, check the change events for flag flips in the window, then use the feature-flags skill to read what changed for them. Its findings are in hand when the first hypothesis is formed.
skills/single-customer/SKILL.md
The connector provides access, the paired skill provides the understanding to use it, and the triage skill provides the procedure.

​
Getting started

Connectors are set up and plugins are registered from Extensions in your dashboard. Writing the plugin itself is best done in your repository with your own coding agent, using the official incident.io skills plugin, which knows how to author skills that work well with our agents and can register and verify them for you.

Official skills plugin

Create your first plugin with your coding agent.

Plugins

Bring your team’s skills and docs.

Connectors

Connect your MCP servers and HTTP APIs.

Nexus

The sources Investigations draw on, and how to set each one up.

How investigations work

How evidence becomes a finding.