{
  "markdown": "# Bunny Agent Plugin\n\nConnect your AI assistant to Bunny. This repository is an\n[Agent Plugin](https://agent-plugins.org) (spec 1.0) bundling two things:\n\n- **Developer skills** — Bunny's GraphQL API, the official Node and Ruby SDKs,\n  the `@bunnyapp/components` React library, webhooks, and the customer portal.\n- **Operator skills + MCP tools** — work with a live Bunny account from chat:\n  look up customers, answer revenue questions, preview invoices, build pricing,\n  and raise quotes.\n\nFor more context see [docs.bunny.com/developer](https://docs.bunny.com/developer).\n\n## Install\n\nPick your assistant. Every route installs the same plugin from this repository.\n\n### Claude Code\n\nRun these two commands in a chat:\n\n```text\n/plugin marketplace add bunnyapp/skills\n/plugin install bunny-plugin@bunny-ai-toolkit\n```\n\n### VS Code (GitHub Copilot)\n\nOpen the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`), run\n**Chat: Install Plugin From Source**, and paste the repository URL:\n\n```text\nhttps://github.com/bunnyapp/skills\n```\n\nVS Code clones the repo and reads `plugin.json`, `skills/` and `mcp.json`\ndirectly — it implements Agent Plugins 1.0.\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/bunnyapp/skills\n```\n\n### Cursor\n\nInstall **Bunny** from the Cursor Marketplace.\n\n### OpenAI Codex\n\nIn the Codex CLI run `/plugins`, search for **Bunny**, and select\n**Add to Codex**.\n\n### Any other Agent Plugins host\n\nHosts that implement [Agent Plugins 1.0](https://agent-plugins.org) — Google's\nAgents CLI and Data Agent Kit among them — load a plugin from a directory path.\nThe spec does not define a distribution mechanism, so clone the repo and point\nthe host at it:\n\n```bash\ngit clone https://github.com/bunnyapp/skills bunny-plugin\n```\n\n### Individual skills only\n\nFor any [agentskills.io](https://agentskills.io)-compatible tool, when you want\none skill rather than the whole plugin:\n\n```bash\nnpx skills add bunnyapp/skills --skill <skill-name>\n```\n\n## Connect your Bunny account\n\nInstalling the plugin gives you the skills. The MCP tools — everything that\nreads or changes real data — need one more step, because **Bunny's MCP endpoint\nis per account**:\n\n```text\nhttps://<your-subdomain>.bunny.com/api/mcp\n```\n\nThere is no shared host, so the URL shipped in `mcp.json` is a placeholder.\nReplace `YOUR-SUBDOMAIN` with your own, and create an API client in Bunny under\n**Settings → API Clients** to authenticate. Full walkthrough, including the\nOAuth redirect URI that most often trips people up, is in [MCP.md](MCP.md).\n\nWithout this step the developer skills still work; the operator skills have no\ntools to call.\n\n## How it is packaged\n\nThe repository root **is** the plugin, conforming to\n[Agent Plugins 1.0](https://agent-plugins.org). Hosts implementing the spec\nconsume it directly — no build step, no per-platform repackaging:\n\n```text\nplugin.json          # manifest: $schema + name, plus optional metadata\nmcp.json             # MCP servers, each with an explicit transport type\nskills/<name>/       # one directory per skill, each holding a SKILL.md\n```\n\nThose locations are fixed by the spec, and the same tree feeds the\nvendor-specific manifests kept alongside it (`.claude-plugin/`,\n`.cursor-plugin/`, `.codex-plugin/`, `gemini-extension.json`) — one copy of\nevery skill, many distribution targets. CI validates conformance on every PR.\n\n## What you get\n\n- **Docs and schema-aware help**: search Bunny's developer documentation and\n  GraphQL schema from inside your editor\n- **SDK-guided integration**: correct setup and usage patterns for the Node\n  (`@bunnyapp/api-client`) and Ruby (`bunny_app`) SDKs\n- **React components**: guided integration of `@bunnyapp/components`\n  (BillingDetails, Invoice, Signup, Subscriptions, Quote, Quotes, Transactions)\n- **Webhook handlers**: correct patterns for platform and workflow webhooks\n- **Lifecycle flows**: quote → apply → subscription; renewals, upgrades,\n  cancellation; invoices, payments, credit notes\n\n## Available skills\n\n| Skill | Covers |\n| --- | --- |\n| `bunny-graphql` | Direct GraphQL API: endpoint, auth, pagination, common operations |\n| `bunny-node-sdk` | `@bunnyapp/api-client` (Node / TypeScript) |\n| `bunny-ruby-sdk` | `bunny_app` gem (Ruby / Rails) |\n| `bunny-components` | `@bunnyapp/components` React library |\n| `bunny-webhooks` | Platform and workflow webhook handling |\n| `bunny-customer-portal` | Popup, standalone, and signup portal variants |\n| `bunny-catalog` | Products, plans, features, price lists, coupons |\n| `bunny-quoting` | Quote lifecycle (create → share → accept → apply) |\n| `bunny-subscriptions` | Subscription lifecycle: renewals, upgrades, cancellation, usage |\n| `bunny-billing` | Invoices, payments, credit notes, reconciliation |\n| `bunny-analytics` | MRR / ARR / churn, RevRec schedules, reporting exports |\n| `bunny-agent-tools` | Operating a live Bunny account through the MCP tool set |\n| `bunny-agent-data` | Reading and interpreting Bunny data via MCP |\n| `bunny-agent-changes` | Making changes via MCP: quote lifecycle, catalogue, cancellation |\n\nEach lives at `skills/<name>/SKILL.md`.\n\n## Credential safety\n\nEvery code sample in this plugin reads tokens from environment variables. When\nintegrating Bunny, **never** hardcode, log, or commit access tokens. Rotate\ntokens regularly and scope them to the minimum set of permissions you need.\n\n## Feedback\n\nOpen an issue in this repository. For broader questions about Bunny's API, see\n[docs.bunny.com/developer](https://docs.bunny.com/developer).\n\n## Contributing\n\nThis repo is maintained by the Bunny team. See [CONTRIBUTING.md](CONTRIBUTING.md) for the authoring rubric, skill shape, and PR conventions. External pull requests may be considered on a case-by-case basis — please open an issue first to discuss.\n",
  "bytes": 5796,
  "sha": "bbb6f3533c6772bc404b357e3de2a8622804d40ddd53c544a3a030c376ed65e5",
  "repo_slug": "bunnyapp/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_bunnyapp_skills_63b0a79e/readme"
}