Install the "butterbase-skills" agent skill from https://github.com/butterbase-ai/butterbase-skills/tree/main into .claude/skills/butterbase-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "butterbase-skills", then confirm the skill loads.
Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add butterbase-ai/butterbase-skills --skill butterbase-skills -a codex
Project install goes to .agents/skills/; add -g for ~/.codex/skills/.
Install the "butterbase-skills" agent skill from https://github.com/butterbase-ai/butterbase-skills/tree/main into .agents/skills/butterbase-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "butterbase-skills", then confirm the skill loads.
Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add butterbase-ai/butterbase-skills --skill butterbase-skills -a cursor
Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.
Install the "butterbase-skills" agent skill from https://github.com/butterbase-ai/butterbase-skills/tree/main into .cursor/skills/butterbase-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "butterbase-skills", then confirm the skill loads.
Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add butterbase-ai/butterbase-skills --skill butterbase-skills -a gemini-cli
Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.
Install the "butterbase-skills" agent skill from https://github.com/butterbase-ai/butterbase-skills/tree/main into .gemini/skills/butterbase-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "butterbase-skills", then confirm the skill loads.
Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
skills CLI
$ npx skills add butterbase-ai/butterbase-skills --skill butterbase-skills -a github-copilot
Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.
Install the "butterbase-skills" agent skill from https://github.com/butterbase-ai/butterbase-skills/tree/main into .github/skills/butterbase-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "butterbase-skills", then confirm the skill loads.
GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add butterbase-ai/butterbase-skills --skill butterbase-skills -a opencode
OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
Install the "butterbase-skills" agent skill from https://github.com/butterbase-ai/butterbase-skills/tree/main into .opencode/skills/butterbase-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "butterbase-skills", then confirm the skill loads.
OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
Skill name
butterbase-skills
GitHub stars
534
Token cost
~1.2k tokens
SKILL.md length
404 words
Files
46
Skills in repo
39
Repo updated
First seen
Licence
MIT
At a glance
Claude Code plugin for Butterbase — 39 guided skills, 34 slash commands, and auto-configured MCP for the AI-native backend-as-a-service.
Works in 3 steps: Sign up at butterbase.ai. → Install the MCP server across every… → Trigger OAuth once per client. In Claude…
Tasks that involve Hooks and plugins
SKILL.md covers What you get, Install, Setup and Headline skills, plus 3 more sections
Calls claude and npx; reaches api.butterbase.ai; needs BUTTERBASE_API_KEY
What it does
Butterbase Skills is an agent skill from butterbase-ai/butterbase-skills. Claude Code plugin for Butterbase — 39 guided skills, 34 slash commands, and auto-configured MCP for the AI-native backend-as-a-service.
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 47 other files (for example `.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` and `.mcp.json`).
It sits in Agent Workflows, covering Hooks and plugins and MCP servers. It works with Model Context Protocol. The repository describes itself as: Plugin for Butterbase.ai. The licence is MIT.
When your agent uses it
Tasks that involve Hooks and plugins
Tasks that involve MCP servers
Example prompts
“/butterbase-skills”
Requirements
Node.js
A credential in BUTTERBASE_API_KEY
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
1Sign up at butterbase.ai.
2Install the MCP server across every detected client
3Trigger OAuth once per client. In Claude Code: restart, then run /mcp (or claude mcp login butterbase).
What it can do on your machine
Read from SKILL.md and the folder at commit aa8ae69. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
claude
npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
api.butterbase.ai
Also links to:
npmjs.com
butterbase.ai
github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
BUTTERBASE_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Butterbase Skills loads about 1.2k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 404 words of instructions outside code blocks.
Always· name and description, kept in context so the agent knows when to use it
~39
When it runs· the whole SKILL.md, loaded when a task matches
~1.2k
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
Download SKILL.mdSave it as .claude/skills/butterbase-skills/SKILL.md (or your agent's skills folder). This skill also uses 45 other files; get the full folder from GitHub.
name
butterbase-skills
description
Claude Code plugin for Butterbase — 39 guided skills, 34 slash commands, and auto-configured MCP for the AI-native backend-as-a-service.
Claude Code plugin for Butterbase — an AI-native backend-as-a-service with Postgres, auth, storage, serverless functions, an AI gateway, RAG, realtime, and durable objects.
This plugin gives Claude deep knowledge of Butterbase's nearly 40 MCP tools, ships 39 guided skills and 34 slash commands, and auto-configures the MCP server connection.
What you get
Auto-configured MCP server — .mcp.json points Claude at https://api.butterbase.ai/mcp with your BUTTERBASE_API_KEY. All Butterbase tools available immediately.
Always-on context — CLAUDE.md teaches Claude Butterbase's environment, branding, tool shape, and core workflow.
Guided journey — /butterbase-skills:journey walks any idea from brainstorm → plan → schema → auth → functions → deploy → optional hackathon submission.
Per-capability skills — schema-design, auth-setup, function-dev, deploy-frontend, debug-rls, storage, rag-dev, realtime, durable-objects, ai, migrations, substrate, integrations, payments, and more.
Install
bash
# Add the marketplace
claude plugin marketplace add https://github.com/butterbase-ai/butterbase-skills
# Install the plugin
claude plugin install butterbase-skills@butterbase-skills
Claude Code (primary) — installed via the plugin marketplace command above; npx @butterbase/cli mcp install also covers it.
Claude Desktop / Cursor / VS Code / JetBrains / Codex / Gemini CLI / others — npx @butterbase/cli mcp install writes the right config for each, then a single /mcp (or the client's equivalent) launches the OAuth flow in your browser.
Any other MCP-capable client can connect to https://api.butterbase.ai/mcp directly — the server advertises OAuth 2.1 via the standard .well-known/oauth-protected-resource metadata. Or run the MCP server locally via @butterbase/mcp.
Related
@butterbase/mcp — stdio MCP server for non-Claude-Code clients
Butterbase Skills next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
Butterbase Skills compared with similar skills
Skill
Stars
Used in
Tokens
Auto-check
Licence
Repo updated
Butterbase Skills this skillbutterbase-ai/butterbase-skills
Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.
Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.
A skill your agent uses whenever the user wants to build, extend, debug, test, validate, locally load, package, or publish an OpenPets plugin; work with the OpenPets Plugin SDK v3, plugin manifest…
Shows how to build a Vibe plugin package in the Agent Plugins 1.0 format, with a plugin.json manifest and optional skills, MCP servers, hooks and other components.
Audits a project's agent configuration, instruction drift, hooks, MCP and AI maintainability, then reports prioritized findings with evidence and next actions.
A skill your agent uses when calling the app's AI gateway from agent tools — chat completions, embeddings, listing models, configuring defaults or BYOK, reading token/cost usage
A skill your agent uses when configuring OAuth providers (Google/GitHub/Apple/X/etc.), setting up post-login auth hooks, tuning JWT lifetimes, or generating service API keys
A skill your agent uses when building a new Butterbase app from scratch, creating a full-stack application, or when the user asks to set up a complete backend with database, auth, and deployment
A skill your agent uses when contributing to the Butterbase codebase, adding new MCP tools, creating API routes, writing migrations, or understanding the monorepo architecture
A skill your agent uses when users report access denied errors, see wrong data, RLS policies are not working, or when troubleshooting Row-Level Security issues in Butterbase
A skill your agent uses when deploying a frontend (React, Next.js, or static HTML) to a live URL on Butterbase, or when troubleshooting deployment issues like MIME type errors or blank pages
Claude Code plugin for Butterbase — 39 guided skills, 34 slash commands, and auto-configured MCP for the AI-native backend-as-a-service. Butterbase Skills is an agent skill from butterbase-ai/butterbase-skills. Claude Code plugin for Butterbase — 39 guided skills, 34 slash commands, and auto-configured MCP for the AI-native backend-as-a-service.
When should I use Butterbase Skills?
Butterbase Skills fits situations like: tasks that involve Hooks and plugins; tasks that involve MCP servers.
How do I install Butterbase Skills in Claude Code?
Run `npx skills add butterbase-ai/butterbase-skills --skill butterbase-skills -a claude-code`. Or copy the skill folder (the butterbase-ai/butterbase-skills repository) into .claude/skills/butterbase-skills in your project. Claude Code loads it when a task matches its description.
How do I install Butterbase Skills in Codex?
Run `npx skills add butterbase-ai/butterbase-skills --skill butterbase-skills -a codex`. Or copy the skill folder (the butterbase-ai/butterbase-skills repository) into .agents/skills/butterbase-skills in your project. Codex loads it when a task matches its description.
Can I use Butterbase Skills in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add butterbase-ai/butterbase-skills --skill butterbase-skills -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/butterbase-skills, .gemini/skills/butterbase-skills, .github/skills/butterbase-skills and .opencode/skills/butterbase-skills in your project.
What does Butterbase Skills need to run?
Going by SKILL.md and its folder, Butterbase Skills needs the command-line tools its instructions call (claude and npx) and credentials named BUTTERBASE_API_KEY. Our summary lists: Node.js; A credential in BUTTERBASE_API_KEY.
Does Butterbase Skills access the network?
SKILL.md names 4 domains. In commands or code: api.butterbase.ai; the agent is likely to contact it when it follows the instructions. As links in the text: npmjs.com, butterbase.ai and github.com. This is read from the text; nothing was executed.
Is Butterbase Skills safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Butterbase Skills use?
Butterbase Skills is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Butterbase Skills use?
About 1.2k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Butterbase Skills?
Skills that share tags, products or a category with Butterbase Skills: MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars), Crush Configuration (charmbracelet/crush, 29k stars), Openpets (OpenPetsHQ/openpets, 1.3k stars) and Claude Automation Recommender (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Butterbase Skills?
butterbase-ai (a GitHub organization) maintains it in butterbase-ai/butterbase-skills, which has 534 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 5, 2026.
