Sandbox
@butterbase-ai/butterbase-skills

Butterbase skills plugin for Claude Code and MCP

This plugin adds Butterbase knowledge and workflows to Claude Code. It auto-loads skill files and `CLAUDE.md`, and it configures the Butterbase MCP server so the agent can use Butterbase tools after OAuth consent. The repo also includes command and skill packs for common Butterbase tasks like app building, schema design, deployment, and debugging.

533 stars40 forksUpdated 2mo ago
Who it's for

Builders who use Claude Code and Butterbase to build apps with agent help.

What it delivers

You can start Butterbase workflows with the right context and tools already wired in.

What it does

Claude Code plugin bundle

Packages Butterbase as a Claude Code plugin with plugin metadata in `.claude-plugin/plugin.json`.

MCP server setup

Uses `.mcp.json` and the Butterbase CLI to connect Claude Code and other clients to Butterbase's MCP server.

Always-on project context

Ships `CLAUDE.md` with environment variables, workflows, patterns, and documentation references.

Guided skills

Provides workflow skills for building apps, designing schemas, deploying frontends, debugging RLS, and developing functions.

Command prompts

Includes reusable command files under `commands/` for common Butterbase tasks and journeys.

How to get it

  1. 1Run
    claude plugin add @butterbase/skills
  2. 2Install the MCP server across every detected client with one command
    npx @butterbase/cli mcp install

README

Butterbase Skills

Claude Code plugin for Butterbase — the AI-Native Backend-as-a-Service.

This plugin gives Claude deep knowledge of Butterbase's 42+ MCP tools, guides you through common workflows, and auto-configures the MCP server connection.

Installation

claude plugin add @butterbase/skills

Setup

Sign-in is OAuth — no API key copy-paste needed.

  1. Sign up at butterbase.ai.

  2. 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.

  3. 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 42+ tools available immediately after consent.

Available Skills

SkillDescriptionExample prompts
butterbase:build-appBuild a complete app from scratch"Build me a blog with auth and comments"
butterbase:schema-designDesign database schemas"Design a schema for an e-commerce app"
butterbase:deploy-frontendDeploy frontends to live URLs"Deploy my React app to production"
butterbase:debug-rlsDebug Row-Level Security"Users are seeing each other's data"
butterbase:function-devDevelop serverless functions"Create a cron job to clean up expired sessions"
butterbase:contributingContribute to Butterbase"How do I add a new MCP tool?"

What's Included

  • .mcp.json — Auto-configures the Butterbase MCP server connection (HTTPS endpoint)
  • CLAUDE.md — Always-on context: environment variables, workflows, patterns, documentation references
  • 6 skills — Guided workflows for building, deploying, debugging, and contributing

Local Development

If 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

Also Available

  • @butterbase/sdk — TypeScript SDK for client-side and server-side use
  • @butterbase/cli — CLI tool for project scaffolding and backend management
  • butterbase_docs MCP tool — Call with any topic (auth, storage, functions, etc.) for comprehensive reference docs

License

MIT

Files in the repo

Repository payload10 top-level entries
  • .claude-plugin
  • commands
  • skills
  • .gitignore
  • .mcp.json
  • CLAUDE.md
  • LICENSE
  • package.json
  • README.md
  • SKILL.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More plugins

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

138k
1 add

Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

82k
code-yeongyu/
oh-my-openagent

OmO: Just type "mass ulw" keyword with your prompt. Now you are the master of graph engineering.

69k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

94k

Opinionated Oxlint rules for rejecting low-evidence TypeScript and JavaScript patterns

4.3k