# better-auth-scaffold

Скилл better-auth-scaffold раскладывает Better Auth по файлам в проекте Next.js с App Router и Drizzle: шаблоны, три набора плагинов, генерация схемы и миграции.

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

## Что делает

Скилл собирает обвязку Better Auth в проекте Next.js с App Router и адаптером Drizzle. Он подставляет значения в шаблоны и пишет `lib/auth.ts`, `lib/auth-client.ts`, catch-all роут `app/api/auth/[...all]/route.ts`, `middleware.ts` и `.env.example`. Пресетов три: `minimal` с почтой и паролем, `social` с Google и GitHub, `advanced` — social плюс `twoFactor` и `magicLink`.

Обязательные параметры: `db_provider` (`pg`, `mysql` или `sqlite`) и `app_name`; остальное скилл берёт из `config.json`, иначе спрашивает. Блоки `// PRESET[...]` вырезаются по выбранному пресету, `protected_paths` разворачиваются в маршруты для middleware. Существующий файл с другим содержимым не перезаписывается молча: сначала diff и выбор — перезаписать, смёржить или пропустить. Потом `npx @better-auth/cli@latest generate`, `npx drizzle-kit generate` и `npx drizzle-kit migrate`; заглушка `db/schema/auth.ts` меняется на настоящую схему.

Остаётся ручная часть: `.env.example` копируется в `.env.local`, секрет берётся из `openssl rand -base64 32`, для `social` и `advanced` нужны redirect URI в консолях провайдеров, для `advanced` — рабочий `lib/email.ts`. Шаблоны держат конвенции: `lib/auth.ts` только для сервера, `nextCookies()` идёт последним плагином, секреты через `process.env`. Middleware проверяет лишь наличие cookie, так что настоящая валидация сессии остаётся на страницах.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill better-auth-scaffold -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill better-auth-scaffold -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill better-auth-scaffold -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pproenca/dot-skills skills/.experimental/better-auth-scaffold
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill better-auth-scaffold -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pproenca/dot-skills --path skills/.experimental/better-auth-scaffold
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill better-auth-scaffold -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.experimental/better-auth-scaffold/SKILL.md

## Когда брать
- поднять вход по почте и паролю в новом проекте Next.js
- добавить Google и GitHub к уже существующей схеме Drizzle
- дописать недостающий catch-all роут для Better Auth
- сгенерировать схему авторизации и прогнать миграции через `drizzle-kit`
- разорвать редирект-петлю middleware, добавив страницу входа

## Примеры запросов агенту
- Настрой Better Auth в этом проекте: Postgres, название приложения Academy, пресет social
- Добавь авторизацию в Next.js с Drizzle, нужен вход по почте и паролю плюс twoFactor
- Инициализируй auth и закрой middleware маршруты `/dashboard` и `/billing`

## Похожие
- [better-auth](https://affpapa.org/nevibecode/skills/better-auth.md) — скилл · 3800 установок
- [safe-action-better-auth](https://affpapa.org/nevibecode/skills/safe-action-better-auth.md) — скилл · 499 установок
- [better-auth-authentication](https://affpapa.org/nevibecode/skills/better-auth-authentication.md) — скилл · 406 установок
- [better-auth-core](https://affpapa.org/nevibecode/skills/better-auth-core.md) — скилл · 376 установок
- [nuxt-better-auth](https://affpapa.org/nevibecode/skills/nuxt-better-auth.md) — скилл · 2100 установок
- [better-auth-security-best-practices](https://affpapa.org/nevibecode/skills/better-auth-security-best-practices.md) — скилл · 52200 установок

Из того же набора: [pproenca/dot-skills](https://affpapa.org/nevibecode/by/pproenca/dot-skills.md) — 139 карточек

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