{
  "id": "page:docs-reference-repos-supabase-agent-skills-research",
  "_kind": "Page",
  "_file": "wiki/docs/reference-repos/supabase/agent-skills/research.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/reference-repos/supabase/agent-skills/research.md",
    "sourceKind": "repo-docs",
    "title": "supabase/agent-skills",
    "displayName": "supabase/agent-skills",
    "slug": "docs/reference-repos/supabase/agent-skills/research",
    "articlePath": "wiki/docs/reference-repos/supabase/agent-skills/research.md",
    "article": "\n# supabase/agent-skills\n\n- **GitHub**: https://github.com/supabase/agent-skills\n- **Stars**: 1,925\n- **License**: MIT\n- **Last pushed**: 2026-04-09\n- **Topics**: ai, ai-agents, skills, supabase\n- **Source**: gh-search\n\n## Description\n\nOfficial Supabase agent skills for AI-assisted development. Provides 2 skills covering all Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues) and Postgres performance best practices. Compatible with 18+ AI agents. Packaged as both Agent Skills (agentskills.io) and Claude Code marketplace plugin.\n\n## Archetype\n\n**claude-plugin** -- Ships as a Claude Code marketplace plugin (`.claude-plugin/marketplace.json`) with 2 plugins: `supabase` and `postgres-best-practices`. Also installable via `npx skills add`.\n\n## Structure\n\n- `.claude-plugin/marketplace.json` -- Claude Code marketplace manifest (name: `supabase-agent-skills`)\n- `skills/supabase/SKILL.md` -- Comprehensive Supabase development skill\n- `skills/supabase-postgres-best-practices/SKILL.md` -- Postgres optimization guidelines\n- `.mcp.json` -- MCP server configuration\n- `CLAUDE.md` -- Claude Code instructions\n- `AGENTS.md` -- GitHub Copilot agent instructions\n- `test/` -- Test suite\n- `vitest.config.ts` -- Vitest config\n\n## Key Capabilities\n\n- Covers all Supabase products: Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues\n- Client library guidance: supabase-js, @supabase/ssr with Next.js, React, SvelteKit, Astro, Remix\n- Auth troubleshooting: login, logout, sessions, JWT, cookies, RLS\n- CLI and MCP server integration\n- Postgres best practices across 8 categories prioritized by impact (Query Performance, Connection Management, Schema Design, etc.)\n\n---\n\n## Processes\n\nNone directly extractable. The skills are instruction sets (reference material for Supabase development), not multi-step workflows. The Postgres best practices skill is a decision tree / checklist, not an orchestratable process.\n\n## Plugin Ideas\n\n### 1. Database Performance Audit Plugin\n\n- **Category**: Quality Assurance & Testing\n- **Plugin name**: `db-performance-audit`\n- **Description**: Generalizes the Supabase Postgres best practices into a database-agnostic performance audit plugin. Not Supabase-specific -- applies the 8-category prioritized framework to any Postgres (or SQL) project.\n- **install.md approach**: Detect database type (Postgres, MySQL, SQLite), configure connection, install query analysis tools\n- **Key features**:\n  - 8-category audit framework: Query Performance (Critical), Connection Management (Critical), Schema Design (High), Concurrency & Locking (Medium-High), Security & RLS (Critical), Data Access Patterns (Medium), Monitoring & Diagnostics (Low-Medium), Advanced Features (Low)\n  - Schema review via breakpoints before migration\n  - Index recommendation engine\n  - RLS/security policy review\n  - Connection pooling configuration check\n- **Integration surface**: hooks (`pre-commit` for migration files), commands (`db:audit`, `db:review-migration`), breakpoint rules\n\n### 2. Marketplace Plugin Pattern Reference\n\n- **Not a plugin idea**, but supabase/agent-skills is a clean reference implementation for how external teams build Claude Code marketplace plugins. The `marketplace.json` structure, skill organization, and dual-distribution (skills CLI + Claude plugin marketplace) pattern is worth studying for babysitter's own marketplace plugin authoring docs.\n\n## Skipped\n\n- The Supabase-specific skill content is too vendor-specific for babysitter processes\n- The MCP server configuration is Supabase-specific infrastructure\n- The Agent Skills format (agentskills.io) is a different ecosystem\n\n## Library Mapping\n\n| Extractable Process | Library Status | Action | Existing Path | Target Placement |\n|-------------------|----------------|--------|---------------|------------------|\n| Database Performance Audit Framework | NEW | 8-category prioritized database performance audit methodology | - | specializations/devops-sre-platform/database-performance-audit.js |\n| Postgres Best Practices Decision Tree | NEW | Systematic Postgres optimization checklist and decision framework | - | specializations/devops-sre-platform/postgres-best-practices.js |\n| Auth Troubleshooting Workflow | NEW | Systematic authentication debugging process (login/logout/sessions/JWT) | - | specializations/security-compliance/auth-troubleshooting.js |\n| Schema Design Review Process | NEW | Database schema design review with RLS and security considerations | - | specializations/backend/schema-design-review.js |\n| Migration Review Workflow | NEW | Pre-commit migration review with performance and security checks | - | specializations/shared/migration-review-workflow.js |\n\n## Plugin Marketplace Mapping\n\n| Plugin Idea | Marketplace Status | Action | Existing Plugin | Target Placement |\n|-------------|-------------------|--------|-----------------|------------------|\n| Database Performance Audit | NEW | Database-agnostic performance audit with 8-category framework | - | plugins/a5c/marketplace/blueprints/database-performance-audit/ |\n| Migration Review Automation | NEW | Pre-commit hooks and breakpoints for database migration review | - | plugins/a5c/marketplace/blueprints/migration-review-automation/ |\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-reference-repos",
      "to": "page:docs-reference-repos-supabase-agent-skills-research",
      "kind": "contains_page"
    }
  ]
}