honeycomb — Claude Code plugin: what it does, how to install
This plugin gives Claude Code Honeycomb workflows for queries, production investigations, SLOs, OpenTelemetry, and Beeline migration.
MIT ★ 28 updated 2026-10-09
/plugin install honeycomb@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialWhat honeycomb does
The plugin adds 9 skills for Honeycomb work. They cover observability basics, query and metric patterns, production investigations, SLOs and triggers, OpenTelemetry setup, OpenTelemetry and Beeline migrations, plus board creation. The skills help an agent inspect telemetry and connect code-level instrumentation gaps to Honeycomb.
It also includes honeycomb-investigator for multi-step production debugging and instrumentation-advisor for comparing a codebase with its Honeycomb instrumentation needs. The /honeycomb-setup command guides MCP configuration. The Honeycomb MCP server must be configured first, or features that depend on Honeycomb data will not run.
What it helps with
- build a Honeycomb query for application errors
- trace a production failure through telemetry
- review SLOs and their triggers
- spot missing OpenTelemetry instrumentation
- plan a Beeline migration
Example prompts for the agent
- Run
/honeycomb-setupand configure the Honeycomb MCP server with me. - Investigate the latest production failure in Honeycomb and write a step-by-step diagnosis.
- Review this codebase for OpenTelemetry gaps that affect Honeycomb data.
How to install honeycomb
Plugin marketplace
/plugin install honeycomb@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-officialStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about honeycomb
How do I install honeycomb in Claude Code?
In Claude Code, run /plugin install honeycomb@claude-plugins-official, then run /plugin marketplace add anthropics/claude-plugins-official.
What does the honeycomb plugin do?
It adds skills, agents, and a command for Honeycomb queries, production debugging, SLOs, OpenTelemetry work, and Beeline migration.
What must be configured before using it?
The Honeycomb MCP server must be configured. /honeycomb-setup can guide that setup interactively.
Source text
honeycomb · MIT
# Honeycomb Agent Skill Honeycomb observability skills for AI coding agents. Adds query patterns, production investigation workflows, SLOs & triggers, OpenTelemetry instrumentation, and Beeline migration guidance. Designed to complement the [Honeycomb MCP server](https://docs.honeycomb.io/integrations/mcp/). ## What's included - **9 skills** — observability fundamentals, query patterns, metrics queries, production investigation, SLOs & triggers, OpenTelemetry instrumentation, OpenTelemetry migration, Beeline migration, board creation - **2 agents** — `honeycomb-investigator` for autonomous multi-step production debugging, `instrumentation-advisor` for codebase-to-Honeycomb gap analysis (Claude Code and Cursor) - **1 command** — `/honeycomb-setup` for interactive MCP server configuration (Claude Code and Cursor) ## Supported Tools **Full Plugin Install:** | Tool | Install | |------|---------| | Claude Code | `claude plugin marketplace add honeycombio/agent-skill` then `claude plugin install honeycomb` | | OpenAI Codex | `codex plugin marketplace add honeycombio/agent-skill` then install Honeycomb from the plugin directory | | Cursor | [Install from cursor.directory](https://cursor.directory/plugins/honeycomb) — or Team Marketplace import ([setup](#cursor)) | | Augment (Auggie CLI) | `auggie plugin marketplace add honeycombio/agent-skill` then `auggie plugin install honeycomb` | | GitHub Copilot CLI | `copilot plugin install honeycombio/agent-skill:honeycomb` | **Skills + MCP (manual setup):** | Tool | Skills Directory | MCP Config | |------|-----------------|------------| | VS Code Copilot | `.github/skills/` | `.vscode/mcp.json` | | OpenAI Codex CLI | `honeycomb/skills/` | `~/.codex/config.toml` | | Cline | Rules system | `cline_mcp_settings.json` | **MCP Server Only:** Windsurf, Amazon Q Developer, Continue, and Copilot Coding Agent can connect the Honeycomb MCP server directly. See [Honeycomb Docs: MCP Configuration](https://docs.honeycomb.io/integrations/mcp/configuration-guide/) for setup instructions. For detailed setup instructions for each tool, see [Honeycomb Docs: Agent Skills Setup](https://docs.honeycomb.io/integrations/agent-skills/). ## Install ### Claude Code #### Marketplace (preferred) ```bash claude plugin marketplace add honeycombio/agent-skill claude plugin install honeycomb ``` #### Local development ```bash claude plugin add ./honeycomb ``` Requires the Honeycomb MCP server to be configured (the `/honeycomb-setup` command can help). ### Cursor Honeycomb is a Cursor **plugin** (skills, agents, the `/honeycomb-setup` command, hooks, and the MCP server). Install it from the Cursor plugin directory: **→ [cursor.directory/plugins/honeycomb](https://cursor.directory/plugins/honeycomb)** Open the listing and use its **Install** action. The plugin's MCP server config is shown for review before it's passed to Cursor — confirm it, then reload. #### Distributing to a team On Teams/Enterprise plans you can import this repo as a private **Team Marketplace**: Cursor dashboard → **Settings > Plugins > Team Marketplaces > Import**, then paste `https://github.com/honeycombio/agent-skill` and grant team access. See [Cursor: Plugins](https://cursor.com/docs/plugins) for team marketplace setup. For a manual / local install (e.g. plugin development), see [`honeycomb/.cursor-plugin/INSTALL.md`](honeycomb/.cursor-plugin/INSTALL.md). ### OpenAI Codex ```bash codex plugin marketplace add honeycombio/agent-skill ``` After adding the marketplace, restart Codex, open the plugin directory, select **Honeycomb Plugins**, and install Honeycomb. ### Augment (Auggie CLI) ```bash auggie plugin marketplace add honeycombio/agent-skill auggie plugin install honeycomb ``` ### GitHub Copilot CLI ```bash copilot plugin install honeycombio/agent-skill:honeycomb ``` ## Tests ```bash python -m venv .venv && source .venv/bin/activate make install make test ``` Structural tests validate plugin layout, frontmatter, and hook behavior — no API keys needed. ## Versioning The Claude Code plugin uses semantic versioning. Its version in `honeycomb/.claude-plugin/plugin.json` is the single source of truth for update detection. Every pull request that changes files under `honeycomb/` must bump that version so existing installations receive the changes. The repository-level marketplace version in `.claude-plugin/marketplace.json` matches the plugin version. The marketplace plugin entry intentionally omits a second version field because Claude Code gives the plugin manifest precedence.
© Honeycomb · MIT · honeycombio/agent-skill