К основному содержанию
скилл CX Codex

supabase-admin — скилл для Claude Code: RLS, миграции и схемы Supabase

Скилл supabase-admin для Claude Code администрирует Supabase: проектирует схемы, настраивает политики RLS и миграции, отлаживает запросы. Помогает менять структуру базы и выяснять причины пустой выборки.

MIT 200 установок ★ 274 обновлён 2026-10-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add curiositech/some_claude_skills --skill supabase-admin -a claude-code
Открыть на GitHub

Что делает supabase-admin

Скилл покрывает основные задачи по базам Supabase. Пишет политики RLS — публичное чтение, доступ только владельцу, роли через проверку в profiles. Знает специфичные функции вроде auth.uid() и auth.jwt(), умеет ускорять политики: индексировать колонки, на которые они смотрят, и выносить auth.uid() в подзапрос, чтобы JWT не парсился для каждой строки.

Отдельный блок — миграции. Скилл предлагает именовать файлы по порядку (001_initial_schema.sql, 002_add_profiles_trigger.sql), оборачивать изменения в транзакцию и добавлять down-миграцию комментарием. Для безопасных изменений есть паттерны: добавление колонки с дефолтом без блокировки таблицы, CREATE INDEX CONCURRENTLY.

Есть интеграция с auth: триггер для автоматического создания профиля при регистрации, проверка auth.role() в политиках. В отладке помогает проверять, включён ли RLS, какие политики висят на таблице, и тестировать выборку под ролью anon или конкретным пользователем через SET request.jwt.claims. Скилл не берёт настройку Auth UI — это делается в дашборде — и не работает с edge functions: для них автор отсылает к скиллу cloudflare-worker-dev.

Какие задачи решает

  • спроектировать политики RLS для таблиц с пользовательскими данными
  • ускорить политики через индексы и подзапрос для auth.uid()
  • написать миграцию с транзакцией и down-частью
  • создать триггер для автоматического профиля при регистрации
  • найти, почему запрос возвращает пустой результат без ошибки

Примеры запросов агенту

  • Включи RLS на таблице posts и добавь политику: читать могут все, писать только владелец.
  • Напиши миграцию, которая добавляет колонку status с дефолтом active без блокировки таблицы.
  • Разберись, почему выборка из projects пустая у залогиненного пользователя, хотя строки в таблице есть.

Как установить supabase-admin

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill supabase-admin -a claude-code

2Вручную: положить файлы

~/.claude/skills/supabase-admin/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/supabase-admin/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о supabase-admin

Как установить supabase-admin в Claude Code?

Выполни npx skills add curiositech/some_claude_skills --skill supabase-admin -a claude-code, затем проверь файл ~/.claude/skills/supabase-admin/SKILL.md.

Что делает supabase-admin?

Помогает проектировать схему Supabase, писать политики Row Level Security, готовить миграции и отлаживать проблемы с доступом к данным. Знает паттерны вроде индексов для auth.uid() и триггеров на auth.users.

Чем этот скилл не занимается?

Настройкой Auth UI — её делают в дашборде Supabase, и edge functions — для них автор советует скилл cloudflare-worker-dev. Обычный SQL без контекста Supabase тоже не его случай.

Исходный текст

SKILL.md · MIT
---
name: supabase-admin
description: Supabase administration, RLS policies, migrations, and schema design. Use for database architecture, Row Level Security, performance tuning, auth integration. Activate on "Supabase", "RLS",
  "migration", "policy", "schema", "auth.uid()". NOT for Supabase Auth UI configuration (use dashboard), edge functions (use cloudflare-worker-dev), or general SQL without Supabase context.
allowed-tools:
- Read
- Write
- Edit
- Bash
- Grep
- Glob
- mcp__supabase__*
metadata:
  category: DevOps & Site Reliability
  tags:
  - supabase
  - rls
  - database
  - postgres
  - migration
  - schema
  - security
  pairs-with:
  - skill: postgresql-optimization
    reason: Supabase runs PostgreSQL; performance tuning applies directly to Supabase databases
  - skill: modern-auth-2026
    reason: Supabase Auth provides the backend for passkey, OAuth, and magic link implementation
  - skill: database-design-patterns
    reason: Supabase schema and RLS policy design follows relational database design patterns
  - skill: drizzle-migrations
    reason: Drizzle ORM manages schema migrations against Supabase PostgreSQL databases
---

# Supabase Administration Expert

Master Supabase schema design, Row Level Security policies, migrations, and performance optimization for production applications.

## When to Use

✅ **USE this skill for:**
- Row Level Security (RLS) policy design and debugging
- Database migrations and schema changes
- Auth integration (triggers, profile creation)
- Query performance optimization
- Supabase-specific SQL patterns (`auth.uid()`, `auth.jwt()`)

❌ **DO NOT use for:**
- Supabase Auth UI configuration → use Supabase dashboard docs
- Edge Functions → use `cloudflare-worker-dev` skill
- General PostgreSQL without Supabase context → use standard SQL resources
- Client-side Supabase SDK usage → use Supabase JS docs

## Core Competencies

### 1. Row Level Security (RLS)

**Always Enable RLS on User Tables:**
```sql
ALTER TABLE your_table ENABLE ROW LEVEL SECURITY;
```

**Policy Patterns:**

```sql
-- Public read, authenticated write
CREATE POLICY "Public read" ON posts FOR SELECT USING (true);
CREATE POLICY "Owners can write" ON posts FOR INSERT
  WITH CHECK (auth.uid() = user_id);

-- Owner-only access
CREATE POLICY "Users own their data" ON profiles
  FOR ALL USING (auth.uid() = id);

-- Role-based access
CREATE POLICY "Admins can do anything" ON content
  FOR ALL USING (
    EXISTS (
      SELECT 1 FROM profiles
      WHERE profiles.id = auth.uid()
      AND profiles.role = 'admin'
    )
  );
```

**Performance-Critical: Index auth.uid() Columns:**
```sql
-- 100x performance improvement for RLS policies
CREATE INDEX idx_posts_user_id ON posts(user_id);
CREATE INDEX idx_profiles_id ON profiles(id);
```

**Subquery Optimization for JWT Functions:**
```sql
-- BAD: JWT parsed for every row
CREATE POLICY "slow" ON posts FOR SELECT
  USING (user_id = auth.uid());

-- GOOD: JWT parsed once via subquery
CREATE POLICY "fast" ON posts FOR SELECT
  USING (user_id = (SELECT auth.uid()));
```

### 2. Migration Best Practices

**File Naming Convention:**
```
supabase/migrations/
├── 001_initial_schema.sql
├── 002_add_profiles_trigger.sql
├── 003_forum_tables.sql
└── 004_add_rls_policies.sql
```

**Migration Template:**
```sql
-- Migration: 005_feature_name
-- Description: What this migration does
-- Author: name
-- Date: YYYY-MM-DD

-- Up migration
BEGIN;

-- Your DDL here
CREATE TABLE ...;
ALTER TABLE ...;
CREATE POLICY ...;

COMMIT;

-- Down migration (as comment for reference)
-- DROP TABLE ...;
-- DROP POLICY ...;
```

**Safe Migration Patterns:**
```sql
-- Add column with default (no table lock)
ALTER TABLE users ADD COLUMN status text DEFAULT 'active';

-- Add NOT NULL constraint safely
ALTER TABLE users ADD COLUMN email text;
UPDATE users SET email = '[email protected]' WHERE email IS NULL;
ALTER TABLE users ALTER COLUMN email SET NOT NULL;

-- Create index concurrently (no lock)
CREATE INDEX CONCURRENTLY idx_users_email ON users(email);
```

### 3. Auth Integration

**Auto-create Profile on Signup:**
```sql
-- Function to create profile
CREATE OR REPLACE FUNCTION public.handle_new_user()
RETURNS TRIGGER AS $$
BEGIN
  INSERT INTO public.profiles (id, email, display_name)
  VALUES (
    NEW.id,
    NEW.email,
    COALESCE(NEW.raw_user_meta_data->>'display_name', split_part(NEW.email, '@', 1))
  );
  RETURN NEW;
END;
$$ LANGUAGE plpgsql SECURITY DEFINER;

-- Trigger on auth.users
CREATE TRIGGER on_auth_user_created
  AFTER INSERT ON auth.users
  FOR EACH ROW EXECUTE FUNCTION public.handle_new_user();
```

**Check Auth Status in Policies:**
```sql
-- Authenticated users only
CREATE POLICY "Authenticated access" ON data
  FOR SELECT USING (auth.role() = 'authenticated');

-- Get current user's ID
SELECT auth.uid();

-- Get current user's JWT claims
SELECT auth.jwt();
```

### 4. Common Schema Patterns

**Timestamps with Defaults:**
```sql
CREATE TABLE posts (
  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
  user_id uuid REFERENCES auth.users(id) ON DELETE CASCADE,
  content text NOT NULL,
  created_at timestamptz DEFAULT now(),
  updated_at timestamptz DEFAULT now()
);

-- Auto-update updated_at
CREATE OR REPLACE FUNCTION update_updated_at()
RETURNS TRIGGER AS $$
BEGIN
  NEW.updated_at = now();
  RETURN NEW;
END;
$$ LANGUAGE plpgsql;

CREATE TRIGGER update_posts_updated_at
  BEFORE UPDATE ON posts
  FOR EACH ROW EXECUTE FUNCTION update_updated_at();
```

**Soft Delete Pattern:**
```sql
ALTER TABLE posts ADD COLUMN deleted_at timestamptz;

CREATE POLICY "Hide deleted" ON posts
  FOR SELECT USING (deleted_at IS NULL);
```

**Full-Text Search:**
```sql
-- Add search vector column
ALTER TABLE posts ADD COLUMN search_vector tsvector;

-- Create GIN index
CREATE INDEX idx_posts_search ON posts USING GIN(search_vector);

-- Update function
CREATE OR REPLACE FUNCTION posts_search_update()
RETURNS TRIGGER AS $$
BEGIN
  NEW.search_vector := to_tsvector('english', COALESCE(NEW.title, '') || ' ' || COALESCE(NEW.content, ''));
  RETURN NEW;
END;
$$ LANGUAGE plpgsql;

-- Search query
SELECT * FROM posts
WHERE search_vector @@ plainto_tsquery('english', 'search terms');
```

### 5. Debugging RLS Issues

**Common Problem: Empty Results, No Error**
```sql
-- Check if RLS is enabled
SELECT tablename, rowsecurity FROM pg_tables WHERE schemaname = 'public';

-- List all policies
SELECT * FROM pg_policies WHERE tablename = 'your_table';

-- Test as specific role
SET ROLE anon;
SELECT * FROM your_table LIMIT 1;
RESET ROLE;

-- Test with specific user
SET request.jwt.claims TO '{"sub": "user-uuid-here"}';
SELECT * FROM your_table;
```

**Diagnostic Query:**
```sql
-- Check what the current user can see
SELECT
  auth.uid() as current_user,
  auth.role() as current_role,
  (SELECT count(*) FROM your_table) as visible_rows;
```

## Quick Reference

| Task | Command |
|------|---------|
| Enable RLS | `ALTER TABLE t ENABLE ROW LEVEL SECURITY;` |
| Create policy | `CREATE POLICY "name" ON t FOR action USING (condition);` |
| Drop policy | `DROP POLICY "name" ON t;` |
| Check policies | `SELECT * FROM pg_policies WHERE tablename = 't';` |
| Current user | `SELECT auth.uid();` |
| Force RLS for owner | `ALTER TABLE t FORCE ROW LEVEL SECURITY;` |

## References

See `/references/` for detailed guides:
- `rls-patterns.md` - Advanced RLS policy patterns
- `migration-checklist.md` - Pre-deployment checklist
- `performance-tuning.md` - Query and index optimization
- `social-schema.md` - Schema patterns for social features

© curiositech · MIT · curiositech/some_claude_skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
supabase-schema-architect davila7 Субагент supabase-schema-architect для Claude Code анализирует схему PostgreSQL в Supabase, проектирует таблицы, связи и индексы, планирует миграции с откатом и пишет политики RLS. CX Codex 3 839установок supabase-postgres-best-practices supabase Скилл supabase-postgres-best-practices помогает агенту проектировать схемы и писать SQL с учётом правил Supabase для Postgres. Подключайте его до изменений базы и при разборе проблем с запросами, подключениями или RLS. CX Codex +1 146установок supabase-production Paweł Huryn Скилл supabase-production для Claude Code задаёт правила работы с Supabase в production. Он включается при запросах, миграциях, настройке RLS и разборе ошибок Supabase. CX Codex +1 ★ 741звёзд репо supabase alinaqi Скилл для работы с Supabase CLI, миграциями PostgreSQL, политиками RLS и Deno Edge Functions. Пригодится при локальной разработке бэкенда. CX Codex +1 651установок supabase-security-audit davila7 Команда supabase-security-audit для Claude Code проводит аудит безопасности Supabase: проверяет RLS-политики, права доступа, аутентификацию и API-ключи и выдаёт отчёт с уязвимостями и рекомендациями по исправлению. CX Codex +1 1 020установок supabase-migrations przeprogramowani Правило помогает Claude Code создавать SQL-миграции для Supabase с заданным форматом имени файла, комментариями и настройками RLS. Оно применяется к файлам в supabase/migrations/. CX Codex +1 ★ 267звёзд репо

Из того же набора180

Весь набор →
skill-architect Скилл skill-architect для Claude Code создаёт и проверяет Claude Agent Skills. Настраивает их активацию и структуру с прогрессивным раскрытием. CX Codex +1 204установок mdx-sanitizer Скилл mdx-sanitizer для Claude Code экранирует в MDX конструкции, которые MDX 2.x принимает за JSX, перед сборкой Docusaurus. Исправляет ошибки unexpected token в прекоммит-хуках и билде. CX Codex +1 202установок github-actions-pipeline-builder Скилл github-actions-pipeline-builder собирает CI/CD-пайплайны на GitHub Actions: матричные сборки, кэширование, деплой, тесты, проверки безопасности. Активируется по словам «GitHub Actions», «CI/CD», «workflow», «deployment pipeline». CX Codex +1 202установок physics-rendering-expert Скилл physics-rendering-expert настраивает симуляцию верёвок, кабелей и тканей через Position-Based Dynamics (PBD) и интеграцию Верле. Он предотвращает ошибки с пружинами и углами Эйлера. CX Codex +1 201установок playwright-e2e-tester Скилл playwright-e2e-tester помогает писать E2E-тесты на Playwright, настраивать Page Object Model и готовить пайплайны GitHub Actions. Пригодится при автоматизации веб-тестов и отлове регрессий интерфейса. CX Codex +1 200установок sober-addict-protector Скилл sober-addict-protector помогает вести ежедневные проверки трезвости, замечать триггеры и готовить план защиты от срыва. CX Codex +1 199установок product-appeal-analyzer Скилл product-appeal-analyzer оценивает, захочет ли целевая аудитория выбрать продукт: разбирает позиционирование, доверие и эмоциональный отклик. Используйте его для ревью лендинга или сообщений о продукте. CX Codex +1 199установок background-job-orchestrator Скилл background-job-orchestrator помогает настроить фоновые очереди на BullMQ или Celery. Переносит тяжёлые операции из обработчиков API, добавляет повторные попытки и защищает сервис от перегрузок. CX Codex +1 198установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой