Official Supabase plugin distribution repo for Claude Code, Cursor, Codex, and Gemini. It bundles:

Want to contribute? Read CONTRIBUTING.md first.

• skills/supabase for general Supabase product guidance
• skills/supabase-postgres-best-practices for Postgres performance and schema guidance
• vendor-specific plugin manifests and MCP adapters for each supported surface

supabase-plugin/
├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── .codex-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── .cursor-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── .app.json
├── assets/
│   └── logo.svg
├── AGENTS.md
├── CLAUDE.md
├── README.md
├── .github/workflows/
│   ├── sync-agent-skills.yml
│   └── validate-plugin-manifests.yml
├── gemini-extension.json
├── mcp/
│   ├── claude-code/.mcp.json
│   └── cursor/mcp.json
└── skills/
    ├── .upstream.json
    ├── supabase/
    └── supabase-postgres-best-practices/

Validate the plugin manifest:

claude plugin validate .claude-plugin/plugin.json

Validate the marketplace wrapper:

claude plugin validate .claude-plugin/marketplace.json

Run the plugin locally:

claude --plugin-dir .

Then use /reload-plugins after edits and verify the namespaced skills:

• /supabase:supabase
• /supabase:supabase-postgres-best-practices

• The root skills/ directory must contain real files. Do not switch it back to a symlink or submodule-backed path.
• Vendored skills are synced from supabase/agent-skills release assets through .github/workflows/sync-agent-skills.yml.