{
  "markdown": "# Honeycomb Agent Skill\n\nHoneycomb 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/).\n\n## What's included\n\n- **9 skills** — observability fundamentals, query patterns, metrics queries, production investigation, SLOs & triggers, OpenTelemetry instrumentation, OpenTelemetry migration, Beeline migration, board creation\n- **2 agents** — `honeycomb-investigator` for autonomous multi-step production debugging, `instrumentation-advisor` for codebase-to-Honeycomb gap analysis (Claude Code and Cursor)\n- **1 command** — `/honeycomb-setup` for interactive MCP server configuration (Claude Code and Cursor)\n\n## Supported Tools\n\n**Full Plugin Install:**\n| Tool | Install |\n|------|---------|\n| Claude Code | `claude plugin marketplace add honeycombio/agent-skill` then `claude plugin install honeycomb` |\n| OpenAI Codex | `codex plugin marketplace add honeycombio/agent-skill` then install Honeycomb from the plugin directory |\n| Cursor | [Install from cursor.directory](https://cursor.directory/plugins/honeycomb) — or Team Marketplace import ([setup](#cursor)) |\n| Augment (Auggie CLI) | `auggie plugin marketplace add honeycombio/agent-skill` then `auggie plugin install honeycomb` |\n| GitHub Copilot CLI | `copilot plugin install honeycombio/agent-skill:honeycomb` |\n\n**Skills + MCP (manual setup):**\n| Tool | Skills Directory | MCP Config |\n|------|-----------------|------------|\n| VS Code Copilot | `.github/skills/` | `.vscode/mcp.json` |\n| OpenAI Codex CLI | `honeycomb/skills/` | `~/.codex/config.toml` |\n| Cline | Rules system | `cline_mcp_settings.json` |\n\n**MCP Server Only:**\nWindsurf, 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.\n\nFor detailed setup instructions for each tool, see [Honeycomb Docs: Agent Skills Setup](https://docs.honeycomb.io/integrations/agent-skills/).\n\n## Install\n\n### Claude Code\n\n#### Marketplace (preferred)\n\n```bash\nclaude plugin marketplace add honeycombio/agent-skill\nclaude plugin install honeycomb\n```\n\n#### Local development\n\n```bash\nclaude plugin add ./honeycomb\n```\n\nRequires the Honeycomb MCP server to be configured (the `/honeycomb-setup` command can help).\n\n### Cursor\n\nHoneycomb is a Cursor **plugin** (skills, agents, the `/honeycomb-setup`\ncommand, hooks, and the MCP server). Install it from the Cursor plugin\ndirectory:\n\n**→ [cursor.directory/plugins/honeycomb](https://cursor.directory/plugins/honeycomb)**\n\nOpen the listing and use its **Install** action. The plugin's MCP server config\nis shown for review before it's passed to Cursor — confirm it, then reload.\n\n#### Distributing to a team\n\nOn Teams/Enterprise plans you can import this repo as a private **Team\nMarketplace**: Cursor dashboard → **Settings > Plugins > Team Marketplaces >\nImport**, then paste `https://github.com/honeycombio/agent-skill` and grant team\naccess. See [Cursor: Plugins](https://cursor.com/docs/plugins) for team\nmarketplace setup.\n\nFor a manual / local install (e.g. plugin development), see\n[`honeycomb/.cursor-plugin/INSTALL.md`](honeycomb/.cursor-plugin/INSTALL.md).\n\n### OpenAI Codex\n\n```bash\ncodex plugin marketplace add honeycombio/agent-skill\n```\n\nAfter adding the marketplace, restart Codex, open the plugin directory, select **Honeycomb Plugins**, and install Honeycomb.\n\n### Augment (Auggie CLI)\n\n```bash\nauggie plugin marketplace add honeycombio/agent-skill\nauggie plugin install honeycomb\n```\n\n### GitHub Copilot CLI\n\n```bash\ncopilot plugin install honeycombio/agent-skill:honeycomb\n```\n\n## Tests\n\n```bash\npython -m venv .venv && source .venv/bin/activate\nmake install\nmake test\n```\n\nStructural tests validate plugin layout, frontmatter, and hook behavior — no API keys needed.\n\n## Versioning\n\nThe Claude Code plugin uses semantic versioning. Its version in\n`honeycomb/.claude-plugin/plugin.json` is the single source of truth for update\ndetection. Every pull request that changes files under `honeycomb/` must bump\nthat version so existing installations receive the changes.\n\nThe repository-level marketplace version in `.claude-plugin/marketplace.json`\nmatches the plugin version. The marketplace plugin entry intentionally omits a\nsecond version field because Claude Code gives the plugin manifest precedence.\n",
  "bytes": 4570,
  "sha": "ba39cbca044e9fd3c49d14db1aa376d43ab8e6ec7d29f39c8b3fd62b94848e48",
  "repo_slug": "honeycombio/agent-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_honeycombio_agent_skill_honeycomb_bf7bcd81/readme"
}