butterbase-ai/butterbase-skills

Auth Setup configures OAuth providers, JWT lifetimes, post-login hooks, and service API keys for Butterbase apps. Use it when setting up end-user sign-in or auth-related backend behavior.

Build App walks through creating a complete Butterbase app, including backend provisioning, schema design, RLS, and deployment. Use it when starting a new app or setting up auth and database-backed features.

Butterbase AI Gateway lets agents call an app's AI gateway for chat completions, embeddings, model listing, config updates, and usage reporting. Use it to manage defaults, BYOK keys, and token or cost usage.

Butterbase Agents helps design, deploy, and debug declarative LLM/tool graphs for Butterbase apps. Use it for stateful multi-step workflows, MCP tool registration, access controls, limits, and agent run debugging.

Butterbase Preflight checks that a Butterbase account, MCP connection, API key, and app_id are in place before platform-touching actions. Use it to verify setup and write the results to preflight state files.

Butterbase Skills gives Claude Code guided workflows for Butterbase, including app building, schema design, auth, functions, deploys, and debugging. It also auto-configures the Butterbase MCP connection and context.

Contributing covers the Butterbase monorepo layout, coding conventions, and the steps for adding MCP tools, API routes, and database migrations. Use it when working on the codebase or extending the control API and MCP server.

Debug RLS helps troubleshoot Row-Level Security issues in Butterbase when users see access denied errors, wrong rows, or policy failures. It uses role simulation to test how policies behave for anon, user, and service requests.

Durable Objects helps you build stateful per-key actors for chat rooms, multiplayer rooms, rate limiters, and long-running agents. Use it when a single key needs persistent in-memory state plus storage across requests.

Frontend Deployment packages and uploads React, Next.js static exports, or plain HTML to a live Butterbase URL. Use it to set build-time env vars, configure CORS, and troubleshoot blank pages or MIME type errors.

Function Dev covers developing, deploying, and debugging Butterbase serverless functions. Use it for HTTP endpoints, webhooks, cron jobs, WebSocket triggers, database access, and environment variables.

Integrations tells you when to use Butterbase's manage_integrations tool instead of adding a third-party SDK. Use it for email, Slack, calendar, CRM, docs, and project management actions covered by Composio.

Journey AI configures the AI stage of the Butterbase journey by setting gateway defaults and optional BYOK. Use it when a plan includes LLM or embeddings setup and the AI section needs to be applied and smoke-tested.

Journey Agents builds the agents listed in 02-plan.md by delegating each one to the agents skill, then registers any required MCP servers, validates the specs, creates the agents, and smokes them. Use it during the agents stage of a Butterbase journey.

Journey Auth configures OAuth providers and optional auth hooks as the auth stage of a Butterbase build journey. Use it after schema setup when an app needs end-user sign-in.

Journey Deploy verifies a deployed Butterbase app end to end after build. It checks the live URL, invokes deployed functions, and confirms auth flow before allowing submission.

Journey Docs primes Butterbase documentation for the capabilities listed in a plan before build stages run. It reads the plan, fetches relevant topic docs, and writes a cache other stages can reuse.

Journey Durable Objects deploys per-key stateful actors as part of the Butterbase journey. Use it when a plan includes Durable Objects such as chat rooms, multiplayer sessions, or rate limiters.

Journey Frontend builds or adopts the frontend stage of a Butterbase journey and deploys it with the app ID and API URL set. Use it when the plan includes a frontend step and the app should be scaffolded, built, and published.

Journey Functions implements the functions stage of the Butterbase journey by building each planned function, deploying it, and running a smoke test. Use it when the plan includes backend functions to ship.

Journey Idea turns a rough app concept into a structured brief by asking one concrete question at a time. It captures the first user, first action, must-haves, and Butterbase capability tags in docs/butterbase/01-idea.md.

Journey Plan turns a Butterbase idea brief and capability map into a concrete app plan. Use it to define tables, auth, functions, storage, AI features, frontend stack, and hackathon scope cuts.

Journey RAG creates RAG collections and ingests seed documents as stage 3g of the Butterbase guided journey. Use it when the plan includes a knowledge base and you need to prepare retrieval data and verify it with a smoke query.

Journey RLS installs row-level security policies for Butterbase user-owned tables during the guided build flow. Use it after schema planning or when the journey reaches the RLS stage, and it can fold into the schema stage in hackathon mode.

Journey Realtime enables the realtime stage of the Butterbase journey by configuring WebSocket subscriptions for the tables in the plan. Use it when the plan includes realtime needs and you want the stage executed and verified.