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

supabase-js — скилл для Claude Code: что делает и как установить

Скилл снабжает ассистента шпаргалками и синтаксисом официального SDK @supabase/supabase-js: от базовых фильтров PostgREST до загрузки файлов и Edge Functions.

MIT ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install supabase-skills@claude-settings
Открыть на GitHub

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

Скилл подключает к диалогу дерево решений для JavaScript и TypeScript SDK Supabase. Внутри собраны готовые конструкции под аутентификацию, запросы к таблицам через PostgREST, бакеты Storage, realtime-каналы и вызов функций Edge.

Помимо дерева вызовов в материалах есть типовые решения: хук авторизации для React и Next.js, работа с service_role на бэкенде без сохранения сессий и генерация типов схемы через CLI (supabase gen types typescript). Для строгой типизации таблиц в проекте придётся сначала сгенерировать database.types.ts самостоятельно.

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

  • составить типобезопасный запрос к таблице через createClient
  • настроить подписку на события базы данных через Realtime channel
  • организовать авторизацию пользователей через OAuth или пароль
  • загрузить файл в бакет и получить подписанную ссылку
  • вызвать Edge Function с передачей кастомных заголовков

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

  • Напиши запрос к Supabase с выборкой профилей и пагинацией через range
  • Покажи, как подписаться на INSERT в таблицу messages через @supabase/supabase-js
  • Сделай хук для Next.js с отслеживанием onAuthStateChange в Supabase

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

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install supabase-skills@claude-settings

Команда ставит плагин supabase-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add fcakyon/claude-codex-settings --skill supabase-js -a claude-code

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

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

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

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

Вопросы о supabase-js

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

Выполните по очереди команды: /plugin marketplace add fcakyon/claude-codex-settings, а затем /plugin install supabase-skills@claude-settings.

Что делает скилл supabase-js?

Он предоставляет модели синтаксис методов библиотеки @supabase/supabase-js, включая управление сессиями, вызовы RPC, хранилище и server-side клиент.

Нужен ли сервисный ключ для работы на бэкенде?

Да, для серверного кода без ограничений RLS передаётся SUPABASE_SERVICE_ROLE_KEY с параметром auth: { persistSession: false }.

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

SKILL.md · MIT
---
name: supabase-js
description: This skill should be used when user asks to "use supabase-js", "query Supabase database", "supabase auth", "supabase storage", "supabase realtime", "supabase edge functions", or works with the @supabase/supabase-js JavaScript/TypeScript SDK.
references:
  - supabase-js
  - auth-js
  - postgrest-js
  - storage-js
license: MIT
---

# Supabase JavaScript SDK Skill

Skill for building applications with the `@supabase/supabase-js` SDK. Covers Auth, Database (PostgREST), Storage, Realtime, and Edge Functions.

The SDK docs at https://supabase.com/docs/reference/javascript are the source of truth. The reference files alongside this skill contain source code and READMEs extracted from the monorepo for quick lookup.

## Setup

```bash
npm install @supabase/supabase-js
```

```typescript
import { createClient } from '@supabase/supabase-js'

const supabase = createClient('https://xyzcompany.supabase.co', 'public-anon-key')
```

For type-safe queries, generate types from your database schema:

```bash
supabase gen types typescript --project-id your-project-id > database.types.ts
```

```typescript
import { createClient } from '@supabase/supabase-js'
import type { Database } from './database.types'

const supabase = createClient<Database>(SUPABASE_URL, SUPABASE_ANON_KEY)
```

## Quick Decision Trees

### "I need to query data"

```
Database query?
├─ Select rows → supabase.from('table').select('*')
├─ Filter rows → .select().eq('col', val) / .gt() / .lt() / .in() / .like()
├─ Join tables → .select('*, other_table(*)') or .select('*, other_table!fk(*)')
├─ Insert → supabase.from('table').insert({ col: val })
├─ Upsert → supabase.from('table').upsert({ id: 1, col: val })
├─ Update → supabase.from('table').update({ col: val }).eq('id', 1)
├─ Delete → supabase.from('table').delete().eq('id', 1)
├─ Call RPC function → supabase.rpc('function_name', { arg: val })
├─ Count rows → .select('*', { count: 'exact', head: true })
├─ Pagination → .range(0, 9) or .limit(10).offset(20)
└─ Order → .order('created_at', { ascending: false })
```

### "I need authentication"

```
Auth?
├─ Email/password sign up → supabase.auth.signUp({ email, password })
├─ Email/password sign in → supabase.auth.signInWithPassword({ email, password })
├─ OAuth (Google, GitHub, etc.) → supabase.auth.signInWithOAuth({ provider: 'google' })
├─ Magic link → supabase.auth.signInWithOtp({ email })
├─ Phone OTP → supabase.auth.signInWithOtp({ phone })
├─ Sign out → supabase.auth.signOut()
├─ Get current user → supabase.auth.getUser()
├─ Get session → supabase.auth.getSession()
├─ Listen to auth changes → supabase.auth.onAuthStateChange((event, session) => {})
├─ Reset password → supabase.auth.resetPasswordForEmail(email)
├─ Update user → supabase.auth.updateUser({ data: { name: 'New' } })
└─ Admin operations → supabase.auth.admin.listUsers() / .deleteUser(id)
```

### "I need file storage"

```
Storage?
├─ Upload file → supabase.storage.from('bucket').upload('path/file.png', file)
├─ Download file → supabase.storage.from('bucket').download('path/file.png')
├─ Get public URL → supabase.storage.from('bucket').getPublicUrl('path/file.png')
├─ Create signed URL → supabase.storage.from('bucket').createSignedUrl('path', 3600)
├─ List files → supabase.storage.from('bucket').list('folder')
├─ Move file → supabase.storage.from('bucket').move('old/path', 'new/path')
├─ Remove file → supabase.storage.from('bucket').remove(['path/file.png'])
├─ Create bucket → supabase.storage.createBucket('name', { public: false })
└─ List buckets → supabase.storage.listBuckets()
```

### "I need realtime"

```
Realtime?
├─ Listen to DB changes → supabase.channel('name')
│    .on('postgres_changes', { event: 'INSERT', schema: 'public', table: 'messages' }, handler)
│    .subscribe()
├─ Broadcast messages → channel.send({ type: 'broadcast', event: 'cursor', payload: { x, y } })
├─ Listen to broadcasts → .on('broadcast', { event: 'cursor' }, handler)
├─ Presence (who's online) → channel.track({ user_id, online_at })
│    .on('presence', { event: 'sync' }, () => channel.presenceState())
├─ Unsubscribe → supabase.removeChannel(channel)
└─ Unsubscribe all → supabase.removeAllChannels()
```

### "I need edge functions"

```
Edge Functions?
├─ Invoke function → supabase.functions.invoke('function-name', { body: { key: 'val' } })
├─ With custom headers → .invoke('fn', { headers: { 'x-custom': 'val' }, body })
└─ Set region → .invoke('fn', { body, region: 'us-east-1' })
```

## Common Patterns

### Server-side with service role key

```typescript
// Server-side only - bypasses RLS
const supabase = createClient(SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, {
  auth: { persistSession: false }
})
```

### React/Next.js auth

```typescript
import { createClient } from '@supabase/supabase-js'
import { useEffect, useState } from 'react'

const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY)

function useUser() {
  const [user, setUser] = useState(null)
  useEffect(() => {
    supabase.auth.getUser().then(({ data }) => setUser(data.user))
    const { data: { subscription } } = supabase.auth.onAuthStateChange(
      (_, session) => setUser(session?.user ?? null)
    )
    return () => subscription.unsubscribe()
  }, [])
  return user
}
```

### Typed database queries

```typescript
// Generated types give autocomplete for table names, column names, and return types
const { data, error } = await supabase
  .from('profiles')        // autocompleted table name
  .select('id, username')  // autocompleted columns
  .eq('id', userId)        // type-safe filter
  .single()                // returns single row or error
// data is typed as { id: string; username: string } | null
```

## Package Index

| Package | Sub-client | Reference |
|---------|-----------|-----------|
| `@supabase/supabase-js` | `createClient()` | `references/supabase-js/` |
| `@supabase/auth-js` | `.auth` | `references/auth-js/` |
| `@supabase/postgrest-js` | `.from()`, `.rpc()` | `references/postgrest-js/` |
| `@supabase/realtime-js` | `.channel()`, `.realtime` | `references/realtime-js/` |
| `@supabase/storage-js` | `.storage` | `references/storage-js/` |
| `@supabase/functions-js` | `.functions` | `references/functions-js/` |

© fcakyon · MIT · fcakyon/claude-codex-settings

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

Все скиллы по теме «Бэкенд и API» →
supabase-audit-tables-list yoanbernabeu Скилл supabase-audit-tables-list для Claude Code и других агентов перечисляет таблицы, открытые через PostgREST API Supabase, и классифицирует их по уровню риска. Запускается перед проверкой RLS-политик или инвентаризацией публичной схемы. CX Codex +1 524установок supabase-migration-assistant davila7 Команда supabase-migration-assistant создаёт и проверяет миграции базы данных Supabase. Помогает генерировать SQL, обновлять типы TypeScript и готовить откат изменений. CX Codex +1 982установок supabase-schema-sync davila7 Команда supabase-schema-sync сверяет локальную схему базы данных с удалённым проектом Supabase через MCP-сервер. Помогает быстро находить расхождения и готовить файлы миграций. CX Codex +1 1 405установок supabase-automation BuildWithClaude Community Скилл supabase-automation автоматизирует запросы к базам Supabase, управление таблицами, запуск SQL и мониторинг сервисов через Rube MCP прямо из чата с агентом. CX Codex +1 ★ 3 785звёзд репо Supabase supabase Подключает проекты Supabase к ИИ-ассистентам по протоколу MCP. Помогает проверять конфигурацию и запрашивать данные из таблиц. CX Codex +1 ★ 3 022звёзд репо supabase-admin ruvnet Команда supabase-admin делает из агента администратора Supabase: схемы PostgreSQL, RLS-политики, авторизация и бакеты — всё через MCP-сервер, без CLI. CX Codex +1 ★ 850звёзд репо

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

Весь набор →
yolo-training Скилл yolo-training диагностирует графики обучения YOLO26 и results.csv, объясняет переобучение и низкий mAP, подсказывает, какой параметр менять. CX Codex +1 ★ 1 216звёзд репо supabase-cli Скилл учит агента управлять проектами через Supabase CLI: поднимать локальный стек, писать миграции, тестировать edge functions и генерировать типы TypeScript. CX Codex +1 ★ 1 216звёзд репо payment-testing Правило payment-testing собирает нюансы локальной проверки входа, Stripe, подписок, возвратов и backoffice. Помогает разобраться, почему тестовый сценарий ведёт себя не так, как ожидалось. CX Codex +1 ★ 1 216звёзд репо troubleshooting Правило troubleshooting с чек-листом для диагностики локального стека Polar: занятые порты, Docker, база данных, MinIO и фронтенд-сборка. CX Codex +1 ★ 1 216звёзд репо create-pr Скилл create-pr для Claude Code готовит pull request для ревью: проверяет ветку и изменения, собирает результаты проверок и публикует PR через gh. CX Codex +1 ★ 1 216звёзд репо electron Скилл для управления десктоп-приложениями на Electron (Slack, VS Code, Discord, Figma, Notion, Spotify) через Chrome DevTools Protocol. CX Codex +1 ★ 1 216звёзд репо pull Команда pull для Claude Code синхронизирует локальную конфигурацию, схему базы и Edge Functions со связанным проектом Supabase. Обновляет локальные данные одной командой. CX Codex +1 ★ 1 216звёзд репо hetzner-deploy Скилл hetzner-deploy для управления инфраструктурой Hetzner Cloud через CLI hcloud: серверы, сети, файрволы, балансировщики, DNS-зоны и тома. CX Codex +1 ★ 1 216звёзд репо

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

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