butterbase-skills
Plugin for Butterbase.ai
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/butterbase-ai--butterbase-skills)HTML
<a href="/listings/butterbase-ai--butterbase-skills"><img src="/api/listings/butterbase-ai--butterbase-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
claude plugin marketplace add https://github.com/butterbase-ai/butterbase-skills claude plugin install butterbase-skills@butterbase-skills
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 20 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "butterbase-skills",
- "description": "Butterbase plugin marketplace",
- "owner": {
- "name": "Butterbase",
- "email": "ken@butterbase.ai"
- },
- "plugins": [
- {
- "name": "butterbase-skills",
- "description": "Build full-stack apps with Butterbase — AI-Native Backend-as-a-Service. Skills for app creation, schema design, frontend deployment, RLS debugging, serverless functions, and contributing.",
- "version": "0.2.0",
- "source": "./",
- "author": {
- "name": "Butterbase",
- "email": "ken@butterbase.ai"
- }
- }
- ]
- }
README.md · README · 123 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Butterbase Skills
- Claude Code plugin for [Butterbase](https://butterbase.ai) — 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.
- ## Installation
- ```bash
- claude plugin marketplace add https://github.com/butterbase-ai/butterbase-skills
- claude plugin install butterbase-skills@butterbase-skills
- ```
- ## Setup
- Sign-in is OAuth — no API key copy-paste needed.
- 1. **Sign up** at [butterbase.ai](https://butterbase.ai).
- 2. **Install the MCP server across every detected client** with one command:
- ```bash
- 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 tools are available immediately after consent.
- ## Available Skills
- Skills are namespaced by the plugin name, e.g. `butterbase-skills:build-app`.
- ### Building blocks
- | 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?" |
- ### Guided journey
- `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" |
- ### Slash commands
- 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`.
- ## 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
- - **39 skills and 34 slash commands** — Guided workflows for building, deploying, debugging, and contributing, plus the end-to-end journey
- ## 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:
- ```bash
- export CONTROL_API_URL=http://localhost:4000
- ```
- ## Office clients
- 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](https://docs.butterbase.ai/core-concepts/office-clients/).
- ## Also Available
- - **[@butterbase/sdk](https://www.npmjs.com/package/@butterbase/sdk)** — TypeScript SDK for client-side and server-side use
- - **[@butterbase/cli](https://www.npmjs.com/package/@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
- 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.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.