better-auth-integrations — скилл для Claude Code: установка
Помогает подключить Better Auth к веб-фреймворкам на TypeScript: Next.js, SvelteKit, Remix, Express и Hono. Настраивает обработчики /api/auth/* и работу с cookies в SSR.
npx skills add bobmatnyc/claude-mpm-skills --skill better-auth-integrations -a claude-codeЧто делает better-auth-integrations
Скилл содержит инструкции по интеграции Better Auth в TypeScript-проекты. Он описывает подключение роута /api/auth/* для Next.js, SvelteKit, Remix, Express и Hono. Задача — настроить обмен куками и заголовками в SSR.
Внутри зафиксированы адаптеры под фреймворки. Для Next.js App Router используется toNextJsHandler(auth). Страницы Pages Router оборачиваются через toNodeHandler(auth.handler). Для серверных экшенов Next.js скилл предписывает добавить плагин nextCookies() из better-auth/next-js, потому что без него экшены не смогут сохранить сессионные cookies.
Кастомные парсеры тела запроса перед обработчиком Better Auth ломают приём данных. Поэтому в Pages Router обязательно отключают bodyParser. Базовый путь на клиенте и сервере должен быть строго одинаковым.
Какие задачи решает
- настроить catch-all маршрут
/api/auth/*для Next.js App Router - подключить обработчик аутентификации в Next.js Pages Router с отключением
bodyParser - настроить сохранение cookies в серверных экшенах Next.js через плагин
nextCookies - согласовать базовый путь аутентификации между клиентом и сервером
Примеры запросов агенту
- Подключи Better Auth к Next.js App Router и настрой обработчики в
/api/auth/[...all]/route.ts - Настрой Better Auth в Next.js Pages Router без конфликтов со встроенным парсером тела запроса
- Добавь плагин
nextCookiesдля Better Auth, чтобы серверные экшены могли ставить сессионные cookies
Как установить better-auth-integrations
1Через Skills CLI (Vercel)
npx skills add bobmatnyc/claude-mpm-skills --skill better-auth-integrations -a claude-code2Вручную: положить файлы
~/.claude/skills/better-auth-integrations/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/better-auth-integrations/
1Через Skills CLI (Vercel)
npx skills add bobmatnyc/claude-mpm-skills --skill better-auth-integrations -a codex2Вручную: положить файлы
.agents/skills/better-auth-integrations/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add bobmatnyc/claude-mpm-skills --skill better-auth-integrations -a cursor2Вручную: положить файлы
.cursor/skills/better-auth-integrations/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install bobmatnyc/claude-mpm-skills better-auth-integrations2Вручную: положить файлы
.github/skills/better-auth-integrations/SKILL.md1Через Skills CLI (Vercel)
npx skills add bobmatnyc/claude-mpm-skills --skill better-auth-integrations -a gemini-cli2Командой платформы
gemini skills install https://github.com/bobmatnyc/claude-mpm-skills --path toolchains/platforms/auth/better-auth/better-auth-integrationsВручную: положить файлы
.devin/skills/better-auth-integrations/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add bobmatnyc/claude-mpm-skills --skill better-auth-integrations -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о better-auth-integrations
Как установить better-auth-integrations в Claude Code?
Выполните команду npx skills add bobmatnyc/claude-mpm-skills --skill better-auth-integrations -a claude-code. Навык сохранится в ~/.claude/skills/better-auth-integrations/SKILL.md.
Что делает скилл better-auth-integrations?
Он даёт модели правила и сниппеты для интеграции Better Auth в Next.js, Remix, SvelteKit, Express и Hono. Скилл помогает настроить роуты /api/auth/* и передачу заголовков и cookies при SSR.
Зачем отключать bodyParser в Next.js Pages Router при работе с Better Auth?
Better Auth самостоятельно парсит тело входящих запросов. Если встроенный парсер Next.js обработает запрос раньше библиотеки, обработчик авторизации завершится с ошибкой.
Исходный текст
SKILL.md · MIT
---
name: better-auth-integrations
description: Better Auth framework integrations for TypeScript. Use when wiring route handlers in Next.js, SvelteKit, Remix, Express, Hono, or other web frameworks.
user-invocable: false
disable-model-invocation: true
progressive_disclosure:
entry_point:
summary: "Better Auth framework integrations for TypeScript. Use when wiring route handlers in Next.js, SvelteKit, Remix, Express, Hono, or other web frameworks."
when_to_use: "When implementing authentication, authorization, or security."
quick_start: "1. Review the core concepts below. 2. Apply patterns to your use case. 3. Follow best practices for implementation."
references:
- frameworks.md
- nextjs.md
---
# Better Auth Integrations
## Goals
- Mount the Better Auth handler at `/api/auth/*` (or a custom base path).
- Use framework helpers where available.
- Ensure cookies and headers flow correctly in SSR and server actions.
## Quick start
1. Create an `auth` instance (see `better-auth-core`).
2. Add a catch-all route for `/api/auth/*`.
3. Use a framework helper (or `auth.handler`) to return a Response.
### Next.js App Router
```ts
import { auth } from "@/lib/auth";
import { toNextJsHandler } from "better-auth/next-js";
export const { GET, POST } = toNextJsHandler(auth);
```
### Next.js Pages Router
```ts
import { auth } from "@/lib/auth";
import { toNodeHandler } from "better-auth/node";
export const config = { api: { bodyParser: false } };
export default toNodeHandler(auth.handler);
```
## Cookie handling in Next.js server actions
Use the `nextCookies` plugin so server actions set cookies correctly.
```ts
import { betterAuth } from "better-auth";
import { nextCookies } from "better-auth/next-js";
export const auth = betterAuth({
// ...config
plugins: [nextCookies()],
});
```
## Guardrails
- Keep the base path consistent between server and client.
- Prefer framework helpers when available.
- Avoid running custom body parsers before the auth handler.
## References
- `toolchains/platforms/auth/better-auth/better-auth-integrations/references/nextjs.md`
- `toolchains/platforms/auth/better-auth/better-auth-integrations/references/frameworks.md`
© bobmatnyc · MIT · bobmatnyc/claude-mpm-skills