SWSkillsWay.ai
View Repo ↗
Skillset · / supabase / agent-skills

supabasesupabase/agent-skills

PurposeA collection of Agent Skills by Supabase that equips AI coding agents (Claude Code, Cursor, etc.) with accurate, standardized knowledge for Supabase and Postgres tasks. Following the Agent Skills format, it ships two skills: a comprehensive Supabase development guide and a Postgres best-practices optimizer. Once installed, skills are auto-discovered and used by the agent when relevant. Ideal for AI-assisted database design, auth setup, query tuning, and migrations without manual skill invocation.
Skill Count
2
Required CLI
supabase
Domains
BusinessCoding
Forms
Cli ManualStyle GuideWorkflow
Skillset Analysis

Core Idea

Principles & Methodology

The author's design philosophy, what sets this apart from peer projects, and quick notes on the key workflows. Skill names mentioned in the text auto-link to their detail pages.

Core Idea

These Supabase Agent Skills provide modular, standardized instruction sets to help AI agents work accurately with Supabase and Postgres.

Design Principles

  • Standard-compliant: Follow the Agent Skills format, compatible with 18+ agents.
  • Auto-discovery: Skills are loaded automatically by the agent when relevant tasks are detected.
  • Focused scope: Two key skills cover broad Supabase dev and Postgres performance.

Key Skills

  • supabase: Full-coverage Supabase product integration and troubleshooting.
  • supabase-postgres-best-practices: Prioritized Postgres optimization references.

Best Practice

Install via npx skills add or Claude Code plugin; then just describe tasks like "Optimize this Postgres query" and the agent selects skills contextually.

Installation

One command to install the entire Skillset.

Copy and run in your terminal to add supabase/agent-skills to your Agent environment.

$npx skills add supabase/agent-skills
SkillsWay.ai · Heads-Up Agent Skills InspectorUnderstand Agent Skills before you install.

Skill Relationships

Usage Relationships Between Skills

Skill → Skill usage relationships, with cross-layer references. Same color blocks indicate the same skill form.

Relationship Count
2
Standalone Skills
0
Most Referencing
  • supabase-postgres-best-practices1 downstream skills
  • supabase1 downstream skills
Most Referenced
  • supabase1 upstream skills
  • supabase-postgres-best-practices1 upstream skills

Note: Each dependency line reads as "the current Skill depends on" the Skill it points to.

Skill Composition

How skills in this set are triggered

Each skill is designed for a specific kind of caller — some only fire when you name them, others load automatically when the model judges them relevant. The split below summarises both modes at a glance.

User-Invoked0

These skills only fire when you call them by name. The agent will not load them on its own — they stay inert until invoked.

No skill in this set is recommended for manual invocation.

Model-Invoked2

These skills are loaded automatically by the agent when it judges the context relevant. You usually don't need to call them yourself.

supabasesupabase-postgres-best-practices

Skill List

2 Skills · Filter by name or domain

supabase

A skill for any Supabase task: Database, Auth, Edge Functions, CLI/MCP, schemas. Verifies via changelog/docs, applies security checklists (RLS/JWT), uses supabase CLI and MCP. Produces secure, verified implementations and migrations, avoiding common vulnerabilities.

→
Domain
CodingBusiness
Form
Cli ManualWorkflow
Location
skills/supabase/SKILL.md

supabase-postgres-best-practices

Supabase-maintained Postgres best-practices skill for writing, reviewing, and optimizing queries, schemas, and configs. It offers 8 prioritized rule categories with reference files containing SQL examples and diagnostics. Value: faster queries, safer RLS, and scalable database design.

→
Domain
Coding
Form
Style Guide
Location
skills/supabase-postgres-best-practices/SKILL.md

Showing 2 / 2