Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/butterbase-ai--butterbase-skills/badge.svg)](/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

i

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.

  1. {
  2. "name": "butterbase-skills",
  3. "description": "Butterbase plugin marketplace",
  4. "owner": {
  5. "name": "Butterbase",
  6. "email": "ken@butterbase.ai"
  7. },
  8. "plugins": [
  9. {
  10. "name": "butterbase-skills",
  11. "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.",
  12. "version": "0.2.0",
  13. "source": "./",
  14. "author": {
  15. "name": "Butterbase",
  16. "email": "ken@butterbase.ai"
  17. }
  18. }
  19. ]
  20. }
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.

  1. # Butterbase Skills
  2. Claude Code plugin for [Butterbase](https://butterbase.ai) — the AI-Native Backend-as-a-Service.
  3. 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.
  4. ## Installation
  5. ```bash
  6. claude plugin marketplace add https://github.com/butterbase-ai/butterbase-skills
  7. claude plugin install butterbase-skills@butterbase-skills
  8. ```
  9. ## Setup
  10. Sign-in is OAuth — no API key copy-paste needed.
  11. 1. **Sign up** at [butterbase.ai](https://butterbase.ai).
  12. 2. **Install the MCP server across every detected client** with one command:
  13. ```bash
  14. npx @butterbase/cli mcp install
  15. ```
  16. This walks Claude Code, Cursor, VS Code, JetBrains, Codex, Gemini CLI, and the rest, and prints per-client OAuth follow-up hints.
  17. 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.
  18. The plugin auto-loads its skills and CLAUDE.md context as soon as Claude Code starts. All tools are available immediately after consent.
  19. ## Available Skills
  20. Skills are namespaced by the plugin name, e.g. `butterbase-skills:build-app`.
  21. ### Building blocks
  22. | Skill | Description | Example prompts |
  23. |-------|-------------|-----------------|
  24. | `butterbase-skills:build-app` | Build a complete app from scratch | "Build me a blog with auth and comments" |
  25. | `butterbase-skills:schema-design` | Design database schemas | "Design a schema for an e-commerce app" |
  26. | `butterbase-skills:deploy-frontend` | Deploy frontends to live URLs | "Deploy my React app to production" |
  27. | `butterbase-skills:debug-rls` | Debug Row-Level Security | "Users are seeing each other's data" |
  28. | `butterbase-skills:function-dev` | Develop serverless functions | "Create a cron job to clean up expired sessions" |
  29. | `butterbase-skills:auth-setup` | OAuth providers, auth hooks, JWT lifetimes, service keys | "Add Google and GitHub sign-in" |
  30. | `butterbase-skills:storage` | File uploads/downloads, presigned URLs, storage ACLs | "Let users upload profile pictures" |
  31. | `butterbase-skills:realtime` | WebSocket subscriptions, presence, multiplayer state | "Show new messages live without refreshing" |
  32. | `butterbase-skills:durable-objects` | Stateful per-key actors (rooms, rate limiters, long-running agents) | "Build a multiplayer game room" |
  33. | `butterbase-skills:ai` | AI gateway: chat, embeddings, models, defaults, BYOK, usage | "Summarize each post with an LLM" |
  34. | `butterbase-skills:rag-dev` | Knowledge bases, document ingestion, semantic search, Q&A | "Let users ask questions about our docs" |
  35. | `butterbase-skills:agents` | Declarative LLM/tool-graph agents, MCP servers, access controls | "Create a support agent that can look up orders" |
  36. | `butterbase-skills:meetings` | Meeting bots that join, record, and transcribe Zoom/Meet/Teams/Webex calls | "Build a sales-call notetaker" |
  37. | `butterbase-skills:integrations` | Third-party SaaS (email, SMS, Slack, calendar, CRM, ...) via built-in integrations | "Send a welcome email when someone signs up" |
  38. | `butterbase-skills:payments` | Stripe Connect payments through `manage_billing` | "Charge users a monthly subscription" |
  39. | `butterbase-skills:substrate` | Read/write the per-user agent-memory substrate | "Remember my customers across apps" |
  40. | `butterbase-skills:migrations` | Move an app between regions, check, abort, or reverse a move | "Move my app to the EU region" |
  41. | `butterbase-skills:templates` | Publish, browse, and clone public app templates | "Publish my app as a template" |
  42. | `butterbase-skills:contributing` | Contribute to Butterbase | "How do I add a new MCP tool?" |
  43. ### Guided journey
  44. `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.
  45. | Skill | Description | Example prompts |
  46. |-------|-------------|-----------------|
  47. | `butterbase-skills:journey` | Orchestrates the full idea → plan → build → deploy flow | "I have an idea for an app" |
  48. | `butterbase-skills:journey-idea` | Stage 1: one-question-at-a-time idea brainstorm | "I want to build something that..." |
  49. | `butterbase-skills:journey-plan` | Stage 2: turn the idea into a concrete Butterbase plan | "Plan out the tables and auth" |
  50. | `butterbase-skills:journey-preflight` | Verify account, MCP connection, API key, and app ID | "Am I set up to build?" |
  51. | `butterbase-skills:journey-docs` | Prime the relevant Butterbase docs before building | — |
  52. | `butterbase-skills:journey-schema` | Apply the plan's tables | — |
  53. | `butterbase-skills:journey-rls` | Install the plan's RLS policies | — |
  54. | `butterbase-skills:journey-auth` | Configure the plan's OAuth providers and auth hooks | — |
  55. | `butterbase-skills:journey-storage` | Configure the plan's storage buckets and ACLs | — |
  56. | `butterbase-skills:journey-functions` | Implement and deploy the plan's functions | — |
  57. | `butterbase-skills:journey-realtime` | Enable realtime on the plan's tables | — |
  58. | `butterbase-skills:journey-durable` | Deploy the plan's Durable Object classes | — |
  59. | `butterbase-skills:journey-ai` | Configure the plan's AI gateway defaults | — |
  60. | `butterbase-skills:journey-rag` | Create the plan's RAG collections and ingest seed docs | — |
  61. | `butterbase-skills:journey-agents` | Build and deploy the plan's agents | — |
  62. | `butterbase-skills:journey-frontend` | Scaffold and deploy the plan's frontend | — |
  63. | `butterbase-skills:journey-deploy` | Smoke-test the deployed app | "Check my app actually works" |
  64. | `butterbase-skills:journey-substrate` | Optional: link the app to your substrate | — |
  65. | `butterbase-skills:journey-templates` | Optional: publish the app as a template | — |
  66. | `butterbase-skills:journey-submit` | Optional: submit the app to a hackathon | "Submit my app to the hackathon" |
  67. ### Slash commands
  68. 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`.
  69. ## What's Included
  70. - **`.mcp.json`** — Auto-configures the Butterbase MCP server connection (HTTPS endpoint)
  71. - **`CLAUDE.md`** — Always-on context: environment variables, workflows, patterns, documentation references
  72. - **39 skills and 34 slash commands** — Guided workflows for building, deploying, debugging, and contributing, plus the end-to-end journey
  73. ## Local Development
  74. If you're running the Butterbase monorepo locally, the MCP server URL defaults to `http://localhost:4000/mcp`. Set this in your environment:
  75. ```bash
  76. export CONTROL_API_URL=http://localhost:4000
  77. ```
  78. ## Office clients
  79. 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`.
  80. 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/).
  81. ## Also Available
  82. - **[@butterbase/sdk](https://www.npmjs.com/package/@butterbase/sdk)** — TypeScript SDK for client-side and server-side use
  83. - **[@butterbase/cli](https://www.npmjs.com/package/@butterbase/cli)** — CLI tool for project scaffolding and backend management
  84. - **`butterbase_docs` MCP tool** — Call with any topic (auth, storage, functions, etc.) for comprehensive reference docs
  85. ## License
  86. MIT
  87. 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.
  88. `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.
  89. `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 in

Free to use. If it’s helped, pass it on.