supabase-agent-skills — скилл для Claude Code: работа с Supabase
Скилл для агентов, который даёт им доступ к Supabase API и инструментам работы с PostgreSQL. Устанавливается один раз, потом агент сам разбирается со схемой БД, миграциями и запросами.
MIT 252 установок ★ 61 обновлён 2026-10-24
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a claude-codeЧто делает supabase-agent-skills
supabase-agent-skills расширяет возможности AI-кодеров (Claude Code, Cursor, Copilot и других) специальными инструментами для работы с Supabase: интроспекцией схемы, review запросов, помощью с миграциями. Агент получает контекст о структуре БД и может предлагать оптимальные решения прямо в коде.
Установка — одна команда вроде npx skills add akillness/jeo-skills --skill supabase-agent-skills -a claude-code. После этого скилл кешируется в локальной директории агента (для Claude Code — ~/.claude/skills/). Если нужен не весь пакет, можно выбрать отдельные скиллы через флаг --skill.
Если скилл не загружается, есть fallback: прямые SQL-команды и Supabase CLI. Важно помнить про guardrails — не запускать деструктивные миграции без подтверждения и хранить ключи в переменных окружения, не в коде.
Какие задачи решает
- интроспектировать схему PostgreSQL прямо из редактора
- проверить качество SQL-запросов перед выполнением
- помочь агенту разобраться со структурой Supabase без лишних вопросов
- откатиться на прямые CLI-команды, если скилл недоступен
Примеры запросов агенту
- Разбери таблицы в нашей Supabase и предложи оптимальный индекс
- Проверь миграцию на проблемы с производительностью
- Помощь с запросом к users и orders, там нужен JOIN
Как установить supabase-agent-skills
1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a claude-code2Вручную: положить файлы
~/.claude/skills/supabase-agent-skills/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/supabase-agent-skills/
1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a codex2Вручную: положить файлы
.agents/skills/supabase-agent-skills/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a cursor2Вручную: положить файлы
.cursor/skills/supabase-agent-skills/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install akillness/jeo-skills .agent-skills/supabase-agent-skills/SKILL.md2Вручную: положить файлы
.github/skills/supabase-agent-skills/SKILL.md1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a gemini-cli2Командой платформы
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/supabase-agent-skillsВручную: положить файлы
.devin/skills/supabase-agent-skills/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о supabase-agent-skills
Как установить supabase-agent-skills в Claude Code?
Выполни команду npx skills add akillness/jeo-skills --skill supabase-agent-skills -a claude-code. Скилл установится в ~/.claude/skills/supabase-agent-skills/.
Что делает supabase-agent-skills?
Даёт AI-агентам встроенные инструменты для работы с Supabase: показывает схему БД, проверяет SQL, помогает с миграциями и оптимизацией запросов.
Что делать, если скилл не загружается?
Используй прямые команды Supabase CLI и SQL. Убедись, что Node.js и npm установлены, и повтори установку скилла. Все операции с БД можно выполнить через стандартные инструменты.
Исходный текст
SKILL.md · MIT
--- name: supabase-agent-skills description: > Install and use Supabase Agent Skills (`supabase/agent-skills`) with AI coding agents. Covers install modes, skill selection, plugin path, verification, and safe fallback for direct Supabase CLI/database workflows. allowed-tools: Bash Read Write Edit Glob Grep WebFetch license: MIT metadata: tags: supabase, postgres, agent-skills, ai-agent, database, backend, cli version: "1.0" source: https://github.com/supabase/agent-skills --- # supabase-agent-skills Use this skill when the task involves enabling Supabase workflows for AI agents using the open-source `supabase/agent-skills` package. ## When to use - Install Supabase skill packs for Claude/Codex/Copilot/Cursor style agents - Select only specific Supabase skills instead of bulk install - Verify that skill installation succeeded before relying on generated code - Route to direct SQL/CLI checks when skill loading is unavailable ## Instructions ### Step 1: Verify prerequisites - Confirm Node.js and npm/npx are available. - Confirm project actually uses Supabase/Postgres before installing extra skills. ```bash node -v npm -v ``` ### Step 2: Install skill package Use one of these paths: ```bash # Install all Supabase skills npx skills add supabase/agent-skills # Install specific skill only npx skills add supabase/agent-skills --skill supabase npx skills add supabase/agent-skills --skill supabase-postgres-best-practices ``` ### Step 3: Optional Claude plugin path If using Claude plugin workflow: ```bash claude plugin marketplace add supabase/agent-skills claude plugin install supabase@supabase-agent-skills ``` ### Step 4: Verify and smoke test - Confirm installed skill list includes Supabase entries. - Run one bounded task (schema introspection or query review) and inspect output quality. - If results are weak, fall back to direct commands and SQL inspection. ### Step 5: Fallback strategy When agent skill loading is unavailable: - Use direct Supabase CLI and SQL workflow. - Keep migration/review steps explicit; do not rely on hidden agent assumptions. ## Guardrails - Do not run destructive SQL/migrations without explicit confirmation. - Prefer read-only verification first (`SELECT`, schema introspection, dry-run if available). - Keep credentials in environment/secret manager; never hardcode tokens in repo files. ## Evidence - direct page retrieval: https://github.com/supabase/agent-skills - direct page retrieval: https://supabase.com/docs/guides/getting-started/ai-skills
© akillness · MIT · akillness/jeo-skills