# supabase-python

Скилл supabase-python настраивает архитектуру FastAPI с аутентификацией через Supabase и доступом к базе данных через SQLModel или SQLAlchemy.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 298 установок · ★ 713 у репозитория
- Автор: alinaqi
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/alinaqi/maggy/tree/HEAD/skills/supabase-python/SKILL.md
- Обновлён: 2026-10-13
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/supabase-python

## Что делает

Скилл задаёт чёткое разделение ответственности в бэкенде: операции с данными идут через SQLAlchemy или SQLModel, а авторизация пользователей, хранилище файлов и реалтайм отдаются клиенту `supabase-py`. Шаблон раскладывает код по папкам `src/api`, `src/core`, `src/db` и `src/services`, исключая путаницу между сессиями базы и клиентскими SDK.

Внутри описаны готовые сниппеты: асинхронный движок сессий на `asyncpg`, валидация JWT через `HTTPBearer` в зависимостях FastAPI, базовые модели `Profile` и `Post`, а также фабрики клиентов с `anon` и `service_role` ключами.

Для запуска проекта понадобятся переменные окружения `SUPABASE_URL`, `SUPABASE_ANON_KEY` и строка подключения `DATABASE_URL` к PostgreSQL.

## Требования
- Работает с: Supabase

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill supabase-python -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/supabase-python/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/supabase-python/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill supabase-python -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/supabase-python/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill supabase-python -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/supabase-python/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alinaqi/maggy skills/supabase-python
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/supabase-python/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill supabase-python -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/alinaqi/maggy --path skills/supabase-python
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/supabase-python/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill supabase-python -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/alinaqi/maggy/tree/HEAD/skills/supabase-python/SKILL.md

## Когда брать
- Разделить логику запросов к БД через SQLModel и сервисы Supabase
- Настроить валидацию JWT-токенов Supabase в зависимостях FastAPI
- Собрать типовую файловую структуру для асинхронного FastAPI-проекта
- Подключить асинхронную сессию asyncpg с пулом соединений

## Примеры запросов агенту
- Добавь эндпоинт регистрации пользователя через supabase auth в FastAPI
- Создай модель SQLModel для профиля пользователя с привязкой к таблице auth.users
- Настрой зависимость get_current_user для проверки токена через supabase-py

## Похожие
- [supabase](https://affpapa.org/nevibecode/skills/mindrally-supabase.md) — скилл · 954 установки
- [supabase-development](https://affpapa.org/nevibecode/skills/supabase-development.md) — скилл · 740 установок
- [supabase-audit-tables-read](https://affpapa.org/nevibecode/skills/supabase-audit-tables-read.md) — скилл · 533 установки
- [supabase-agent-skills](https://affpapa.org/nevibecode/skills/supabase-agent-skills.md) — скилл · 252 установки
- [supabase-admin](https://affpapa.org/nevibecode/skills/supabase-admin.md) — скилл · 200 установок
- [supabase-postgres-best-practices](https://affpapa.org/nevibecode/skills/supabase-postgres-best-practices-2.md) — скилл · 146 установок

Из того же набора: [alinaqi/maggy](https://affpapa.org/nevibecode/by/alinaqi/maggy.md) — 61 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
