mirror of
https://github.com/supabase/agent-skills.git
synced 2026-03-27 10:09:26 +08:00
2f78f8f169
- Add references/getting-started-locally.md for local development - Update SKILL.md with Local Development reference - Add CLI usage note recommending npx for version consistency Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
75 lines
2.1 KiB
Markdown
75 lines
2.1 KiB
Markdown
# supabase
|
|
|
|
> **Note:** `CLAUDE.md` is a symlink to this file.
|
|
|
|
## Overview
|
|
|
|
Guides and best practices for working with Supabase. Covers getting started, Auth, Database, Storage, Edge Functions, Realtime, supabase-js SDK, CLI, and MCP integration. Use for any Supabase-related questions.
|
|
|
|
## Structure
|
|
|
|
```
|
|
supabase/
|
|
SKILL.md # Main skill file - read this first
|
|
AGENTS.md # This navigation guide
|
|
CLAUDE.md # Symlink to AGENTS.md
|
|
references/ # Detailed reference files
|
|
```
|
|
|
|
## Usage
|
|
|
|
1. Read `SKILL.md` for the main skill instructions
|
|
2. Browse `references/` for detailed documentation on specific topics
|
|
3. Reference files are loaded on-demand - read only what you need
|
|
|
|
## Reference Categories
|
|
|
|
| Priority | Category | Impact | Prefix |
|
|
|----------|----------|--------|--------|
|
|
| 1 | Row Level Security | CRITICAL | `rls-` |
|
|
| 2 | Connection Pooling | CRITICAL | `conn-` |
|
|
| 3 | Schema Design | HIGH | `schema-` |
|
|
| 4 | Migrations | HIGH | `migrations-` |
|
|
| 5 | Performance | CRITICAL | `perf-` |
|
|
| 6 | Security | CRITICAL | `security-` |
|
|
|
|
Reference files are named `{prefix}-{topic}.md` (e.g., `query-missing-indexes.md`).
|
|
|
|
## Available References
|
|
|
|
**Connection Pooling** (`conn-`):
|
|
- `references/db/conn-pooling.md`
|
|
|
|
**Migrations** (`migrations-`):
|
|
- `references/db/migrations-diff.md`
|
|
- `references/db/migrations-idempotent.md`
|
|
- `references/db/migrations-testing.md`
|
|
|
|
**Performance** (`perf-`):
|
|
- `references/db/perf-indexes.md`
|
|
- `references/db/perf-query-optimization.md`
|
|
|
|
**Row Level Security** (`rls-`):
|
|
- `references/db/rls-common-mistakes.md`
|
|
- `references/db/rls-mandatory.md`
|
|
- `references/db/rls-performance.md`
|
|
- `references/db/rls-policy-types.md`
|
|
- `references/db/rls-views.md`
|
|
|
|
**Schema Design** (`schema-`):
|
|
- `references/db/schema-auth-fk.md`
|
|
- `references/db/schema-extensions.md`
|
|
- `references/db/schema-jsonb.md`
|
|
- `references/db/schema-realtime.md`
|
|
- `references/db/schema-timestamps.md`
|
|
|
|
**Security** (`security-`):
|
|
- `references/db/security-functions.md`
|
|
- `references/db/security-service-role.md`
|
|
|
|
**getting** (`getting-`):
|
|
- `references/getting-started-locally.md`
|
|
|
|
---
|
|
|
|
*19 reference files across 6 categories* |