{
  "markdown": "# Busabase Skills & Plugins\n\n**English** | [简体中文](./README.zh-CN.md) | [繁體中文](./README.zh-TW.md) | [日本語](./README.ja.md)\n\nAgent Skills + plugins for [Busabase](https://busabase.com) — the approval-first knowledge base\nwhere AI proposes changes, a human reviews them, and only approved changes get merged.\n\nTwo skills, five ways to install them — pick whatever your agent supports.\n\n## Install\n\n### `skills` (Claude Code, Cursor, Codex, … — evergreen)\n\n```bash\nnpx skills add busabase/skills\n```\n\n### Agent Plugins v1 (portable package)\n\nThe repository root follows the [Agent Plugins Specification v1.0.0](https://agent-plugins.org/):\n`plugin.json` is the portable manifest, `skills/` contains the Agent Skills, and `mcp.json`\ndeclares the hosted Streamable HTTP MCP server. Install or load this repository root with any\nclient that supports the Agent Plugins format.\n\nAgent Plugins v1 leaves OAuth and credentials to the client. Existing Claude Code and Codex\npackages keep their dedicated browser-OAuth behavior. See\n[`docs/agent-plugins.md`](./docs/agent-plugins.md) for the compatibility mapping and validation.\n\n### Claude Code plugin\n\n```bash\nclaude plugin marketplace add https://github.com/busabase/skills.git\nclaude plugin install busabase@busabase\nclaude mcp login plugin:busabase:busabase\n```\n\nThe Claude Code plugin connects to `https://busabase.com/api/mcp` with browser OAuth. Claude\nnamespaces its bundled server as `plugin:busabase:busabase`. Start a new conversation after install\nand login so the authenticated tool catalog is available. See\n[`docs/claude-code-install.md`](./docs/claude-code-install.md) for the complete verification and\nrecovery flow.\n\nMaintainers should also read\n[`docs/codex-to-claude-code-port.md`](./docs/codex-to-claude-code-port.md) for the host-by-host\nmanifest, MCP, OAuth, skill, and validation differences.\n\n### Codex plugin\n\n```bash\ncodex plugin marketplace add busabase/skills\ncodex plugin add busabase@busabase\ncodex mcp login busabase\n```\n\nThe Codex plugin connects to `https://busabase.com/api/mcp`, opens the standard browser OAuth\nflow, and exposes a focused 22-tool catalog. No API key setup is required.\n\nPlugin installation and MCP authorization are separate states. After the browser says\n`Authentication complete`, verify the saved connection before starting a Busabase task:\n\n```bash\ncodex mcp list\n```\n\nThe `busabase` row should show `Auth` as `OAuth`. If it still shows `Not logged in`, run\n`codex mcp login busabase` again and complete the newly opened browser tab while that command is\nstill running. Start a new Codex task after a successful login so the task loads the authenticated\ntool catalog.\n\n### MCP (any MCP-capable agent)\n\nPoint your agent at your workspace's Streamable-HTTP endpoint:\n\n- Desktop / local: `http://localhost:15419/api/mcp` (no auth)\n- Cloud: `https://busabase.com/api/mcp` (send `Authorization: Bearer $BUSABASE_API_KEY`)\n\nCodex can use the full Cloud MCP surface directly with standard OAuth:\n\n```bash\ncodex mcp add busabase --url https://busabase.com/api/mcp\ncodex mcp login busabase\n```\n\nThe portable root [`mcp.json`](./mcp.json) declares the hosted endpoint using the Agent Plugins v1\nformat. The legacy root [`.mcp.json`](./.mcp.json) continues to wire the local endpoint for general\nMCP clients. The Claude\npackage uses its own hosted OAuth [MCP configuration](./claude/.mcp.json). The Codex plugin has a\nseparate remote [MCP configuration](./plugins/busabase/.mcp.json).\n\nThe root **busabase** skill remains the full CLI/curl guide for local and general-purpose agent\ninstalls. The Claude- and Codex-bundled skills are intentionally MCP-first: they rely on OAuth and\nthe curated tool catalog instead of reading `~/.busabase/.env`.\n\nTo set up a workspace from scratch first, paste the onboarding prompt from your Busabase dashboard\n(**Agent Skills** button) — it walks your agent through connecting, seeding a first Base, and then\nrunning one of the install commands above.\n\n## Skills\n\n| Skill | What it does |\n| --- | --- |\n| [`busabase`](./skills/busabase/SKILL.md) | Drive a Busabase workspace over HTTP: list Bases/records, propose ChangeRequests, and merge approved ones. |\n| [`busabase-app-creator`](./skills/busabase-app-creator/SKILL.md) | Turn a product idea into a complete Busabase workspace app with native resources, bounded data access, and a reviewable AirApp. |\n\n\n> **Looking for installable templates?** Complete apps — tables, an AirApp and\n> the manual an agent reads — live in [busabase/templates](https://github.com/busabase/templates).\n> They are kept separate so installing these two skills does not pull down every\n> template's source and screenshots.\n\n## Repo layout\n\nThis one repo serves every install path above:\n\n```\nplugin.json                           Agent Plugins v1 portable manifest\nmcp.json                              Agent Plugins v1 hosted MCP profile\nskills/busabase/SKILL.md              canonical local/general-purpose skill\nskills/busabase-app-creator/SKILL.md  guided Busabase workspace and AirApp creator\n.claude-plugin/marketplace.json       Claude Code marketplace listing\nclaude/.claude-plugin/plugin.json     Claude Code plugin manifest\nclaude/.mcp.json                      hosted OAuth MCP profile for Claude Code\nclaude/skills/busabase/SKILL.md       Claude-specific MCP-first connection guidance\nclaude/skills/busabase-app-creator/   symlink to the shared app creator skill\n.agents/plugins/marketplace.json      Codex marketplace listing\nplugins/busabase/.codex-plugin/plugin.json   Codex plugin manifest\nplugins/busabase/.mcp.json                   hosted OAuth MCP profile for Codex\nplugins/busabase/skills/busabase/SKILL.md    Codex needs the skill INSIDE the plugin dir\n                                             (MCP-first guidance for the curated profile)\nplugins/busabase/skills/busabase-app-creator/SKILL.md\n                                             app creator bundled beside its Busabase dependency\nplugins/busabase/assets/                     icons and light/dark logos bundled with Codex\n.mcp.json                             legacy/general-client local MCP profile\nserver.json                           official MCP Registry entry (remote → busabase.com/api/mcp)\nscripts/validate-agent-plugin.mjs     portable and client-package conformance guard\n```\n\n> **Why host-specific Busabase skills?** The plugin packages use hosted OAuth and MCP tools instead\n> of local shell configuration. Claude Code additionally namespaces the server as\n> `plugin:busabase:busabase`, while Codex uses `busabase`. The shared `busabase-app-creator` skill\n> delegates connection, API, and ChangeRequest behavior to the host-specific MCP-first dependency.\n\n## Publish to the OpenAI Plugin Directory\n\nThe OpenAI Plugin Directory and the MCP Registry are separate release channels. Use\n[`docs/openai-plugin-submission.md`](./docs/openai-plugin-submission.md) for the Platform submission,\ndomain verification, reviewer access, test prompts, and production smoke checks.\n\n## Publish to the official MCP Registry\n\n```bash\nbrew install mcp-publisher                       # or grab the binary from the registry releases\nmcp-publisher login dns --domain busabase.com --private-key <KEY>   # verifies the com.busabase/* namespace\nmcp-publisher publish                            # publishes server.json — live immediately, no review\n```\n\nBump `version` in `server.json` only when publishing an MCP Registry update. Bump the Codex plugin\nmanifest independently for GitHub marketplace releases.\n",
  "bytes": 7531,
  "sha": "bc0e3241806fed482999ab69fc5da3d6114231f388ab7a37e1baea50b367a9f7",
  "repo_slug": "busabase/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_busabase_busabase_eb9df5ff/readme"
}