Claude Code plugin for Butterbase, a backend-as-a-service for AI-native apps. It gives Claude knowledge of Butterbase's MCP tools and guides you through building apps, configuring auth, designing schemas, and deploying.
Claude Code
> /plugin marketplace add butterbase-ai/butterbase-skills> /plugin install butterbase-skills@butterbase-skills
Codex
$ npx skills add butterbase-ai/butterbase-skills -a codex
Cursor
$ npx skills add butterbase-ai/butterbase-skills -a cursor
Gemini CLI
$ npx skills add butterbase-ai/butterbase-skills -a gemini-cli
GitHub Copilot
$ copilot plugin marketplace add butterbase-ai/butterbase-skills$ copilot plugin install butterbase-skills@butterbase-skills
OpenCode
$ npx skills add butterbase-ai/butterbase-skills -a opencode
Windsurf
$ npx skills add butterbase-ai/butterbase-skills -a windsurf
Claude Code plugin for Butterbase — the AI-Native Backend-as-a-Service.
This plugin gives Claude deep knowledge of Butterbase's nearly 40 MCP tools, guides you through common workflows, and auto-configures the MCP server connection.
claude plugin marketplace add https://github.com/butterbase-ai/butterbase-skills
claude plugin install butterbase-skills@butterbase-skills
Sign-in is OAuth — no API key copy-paste needed.
Sign up at butterbase.ai.
Install the MCP server across every detected client with one command:
npx @butterbase/cli mcp install
This walks Claude Code, Cursor, VS Code, JetBrains, Codex, Gemini CLI, and the rest, and prints per-client OAuth follow-up hints.
Trigger OAuth once per client. In Claude Code: restart, then run /mcp (or claude mcp login butterbase). The cli's output covers every other client.
The plugin auto-loads its skills and CLAUDE.md context as soon as Claude Code starts. All tools are available immediately after consent.
Skills are namespaced by the plugin name, e.g. butterbase-skills:build-app.
| Skill | Description | Example prompts |
|---|---|---|
butterbase-skills:build-app | Build a complete app from scratch | "Build me a blog with auth and comments" |
butterbase-skills:schema-design | Design database schemas | "Design a schema for an e-commerce app" |
butterbase-skills:deploy-frontend | Deploy frontends to live URLs | "Deploy my React app to production" |
butterbase-skills:debug-rls | Debug Row-Level Security | "Users are seeing each other's data" |
butterbase-skills:function-dev | Develop serverless functions | "Create a cron job to clean up expired sessions" |
butterbase-skills:auth-setup | OAuth providers, auth hooks, JWT lifetimes, service keys | "Add Google and GitHub sign-in" |
butterbase-skills:storage | File uploads/downloads, presigned URLs, storage ACLs | "Let users upload profile pictures" |
butterbase-skills:realtime | WebSocket subscriptions, presence, multiplayer state | "Show new messages live without refreshing" |
butterbase-skills:durable-objects | Stateful per-key actors (rooms, rate limiters, long-running agents) | "Build a multiplayer game room" |
butterbase-skills:ai | AI gateway: chat, embeddings, models, defaults, BYOK, usage | "Summarize each post with an LLM" |
butterbase-skills:rag-dev | Knowledge bases, document ingestion, semantic search, Q&A | "Let users ask questions about our docs" |
butterbase-skills:agents | Declarative LLM/tool-graph agents, MCP servers, access controls | "Create a support agent that can look up orders" |
butterbase-skills:meetings | Meeting bots that join, record, and transcribe Zoom/Meet/Teams/Webex calls | "Build a sales-call notetaker" |
butterbase-skills:integrations | Third-party SaaS (email, SMS, Slack, calendar, CRM, ...) via built-in integrations | "Send a welcome email when someone signs up" |
butterbase-skills:payments | Stripe Connect payments through manage_billing | "Charge users a monthly subscription" |
butterbase-skills:substrate | Read/write the per-user agent-memory substrate | "Remember my customers across apps" |
butterbase-skills:migrations | Move an app between regions, check, abort, or reverse a move | "Move my app to the EU region" |
butterbase-skills:templates | Publish, browse, and clone public app templates | "Publish my app as a template" |
butterbase-skills:contributing | Contribute to Butterbase | "How do I add a new MCP tool?" |
butterbase-skills:journey takes an idea all the way to a deployed app, running these stages in order. Each stage can also be run on its own.
| Skill | Description | Example prompts |
|---|---|---|
butterbase-skills:journey | Orchestrates the full idea → plan → build → deploy flow | "I have an idea for an app" |
butterbase-skills:journey-idea | Stage 1: one-question-at-a-time idea brainstorm | "I want to build something that..." |
butterbase-skills:journey-plan | Stage 2: turn the idea into a concrete Butterbase plan | "Plan out the tables and auth" |
butterbase-skills:journey-preflight | Verify account, MCP connection, API key, and app ID | "Am I set up to build?" |
butterbase-skills:journey-docs | Prime the relevant Butterbase docs before building | — |
butterbase-skills:journey-schema | Apply the plan's tables | — |
butterbase-skills:journey-rls | Install the plan's RLS policies | — |
butterbase-skills:journey-auth | Configure the plan's OAuth providers and auth hooks | — |
butterbase-skills:journey-storage | Configure the plan's storage buckets and ACLs | — |
butterbase-skills:journey-functions | Implement and deploy the plan's functions | — |
butterbase-skills:journey-realtime | Enable realtime on the plan's tables | — |
butterbase-skills:journey-durable | Deploy the plan's Durable Object classes | — |
butterbase-skills:journey-ai | Configure the plan's AI gateway defaults | — |
butterbase-skills:journey-rag | Create the plan's RAG collections and ingest seed docs | — |
butterbase-skills:journey-agents | Build and deploy the plan's agents | — |
butterbase-skills:journey-frontend | Scaffold and deploy the plan's frontend | — |
butterbase-skills:journey-deploy | Smoke-test the deployed app | "Check my app actually works" |
butterbase-skills:journey-substrate | Optional: link the app to your substrate | — |
butterbase-skills:journey-templates | Optional: publish the app as a template | — |
butterbase-skills:journey-submit | Optional: submit the app to a hackathon | "Submit my app to the hackathon" |
The plugin also ships 34 slash commands (in commands/) that invoke the skills directly, e.g. /butterbase-skills:journey, /butterbase-skills:schema, /butterbase-skills:deploy, /butterbase-skills:idea, /butterbase-skills:submit.
.mcp.json — Auto-configures the Butterbase MCP server connection (HTTPS endpoint)CLAUDE.md — Always-on context: environment variables, workflows, patterns, documentation referencesIf you're running the Butterbase monorepo locally, the MCP server URL defaults to http://localhost:4000/mcp. Set this in your environment:
export CONTROL_API_URL=http://localhost:4000
Hosted Butterbase MCP may expose the optional manage_office tool with 44 organization-scoped actions. Call butterbase_docs with topic: "office" before using it. Office uses a platform credential and an explicit org_id; it does not need an app. Equivalent interfaces are butterbase office --org <uuid> and SDK OfficeClient.
Enable, pause, resume and approve return a saved browser confirmation receipt. Show confirmation_url to the initiating owner, who signs in and reviews one operation. Never confirm as an agent. Observe status using confirmation_id. Keep Ask's request key and exact conversation/turn IDs; retry the same intended write with the same key and observe admitted work without submitting another Ask. Disconnecting does not cancel server work. Inspect unknown outcomes before retrying. See the Office client reference.
butterbase_docs MCP tool — Call with any topic (auth, storage, functions, etc.) for comprehensive reference docsMIT
Curated organization context uses agent-memories / SDK agentMemories; default agent retrieval searches only this category. Other business memory requires an explicit category read. Compact title/summary lists precede full entry reads; context never overrides rules or permissions. Amend/archive require the current revision. Private per-person memory remains deferred.
skills supports separate list/detail/version/run pages, draft/test/reject and owner-confirmed approve/enable/rollback/run. principles amend/retire proposes governed changes. settings reads cadence and proposes revision-guarded 10/15/30/60-minute intervals without resuming paused work. Every-loop skills follow admitted full timer/event sweeps within a shared ten-minute budget; unchanged checks and Ask/test/manual/scheduled turns do not create loops. Extra runs can spend credits.
records list / SDK records.list / MCP list_office_records reads bounded resource pages (25 default, 100 maximum). Preserve organization, resource and filters with next_cursor; loaded counts are not totals and cutoff pagination is not a transaction-wide snapshot. Read the Office reference for the complete 44-action contract and payloads.
Stars on GitHub
A development methodology for coding agents that makes the agent brainstorm before building, follow plans, run parallel work and finish branches in a disciplined way. You get fewer skipped steps and more consistent results from your coding assistant.
@obraHelps you take a change from a rough idea or bug report through to a tested, reviewed result, with each step handled by a focused skill. Its skills cover pinning down domain terms, designing module interfaces, diagnosing hard bugs, and reviewing changes against your repo's coding standards.
@mattpocockGives your coding agent a planning, testing and review routine to follow on every task. It plans before building, checks changes with tests, has a fresh reviewer look for regressions, and saves repeated wins as reusable skills.
@affaan-mDeveloper tools for working on the React codebase itself. Provides skills for extracting error messages, managing and debugging feature flags across release channels, running Flow type checks, and fixing lint and formatting issues before committing.
@facebookInstall it with the command on its page. It includes agents, ai, auth-setup. Its skills do not fire on their own yet. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it