About better-auth
better-auth is a reference skill for the Better Auth framework, covering authentication and authorization in TypeScript projects. It routes tasks to categorized documentation for setup, integrations, adapters, plugins, migration, and API details.
Key features
- 01Task-to-documentation category lookup
- 02Guides for setup and core concepts
- 03Database adapters and framework integrations
- 04Authentication providers and plugins
- 05Migration and configuration references
- 06Examples and CLI documentation
Use cases
- 01Find setup guidance for a Better Auth project
- 02Look up a framework integration or database adapter
- 03Check provider, plugin, or authentication options
- 04Plan an upgrade or migration
MCP support
The reference index includes documentation topics for MCP authentication and agent authentication; it does not describe an MCP server or client.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ fandhe-ai/ agent-reference-skills --skill better-authAfter installing, type/better-authin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/adapters/community-adapters.mddrizzle.mdmongodb.mdmssql.mdmysql.mdother-relational.mdpostgresql.mdprisma.mdREADME.mdsqlite.mdreferences/authentication/email-password.mdother-social-providers.mdREADME.mdsocial-apple.mdsocial-atlassian.mdsocial-cloudflare.mdsocial-cognito.mdsocial-discord.mdsocial-dropbox.mdsocial-facebook.mdsocial-figma.mdsocial-github.mdsocial-gitlab.mdsocial-google.mdsocial-huggingface.mdsocial-kakao.mdsocial-kick.mdsocial-line.mdsocial-linear.mdsocial-linkedin.mdDetails
From the project READMEBetter Auth API リファレンス
Better Auth — TypeScript 向けフレームワーク非依存の認証・認可フレームワーク。
対象 Better Auth v1.7.10(docs: GitHub tag v1.7.10、取得 2026-10-17)。1.6 からの移行は references/guides/1-7-upgrade-guide.md。
ユーザーのタスクに応じて適切な README.md を読み、そこから個別ファイルへ辿ること。
ディレクトリ構成
skills/better-auth/
SKILL.md
references/
getting-started/
README.md
installation.md
basic-usage.md
concepts/
README.md
api.md
cli.md
client.md
cookies.md
database.md
dynamic-base-url.md
email.md
hooks.md
oauth.md
plugins.md
rate-limit.md
session-management.md
typescript.md
users-accounts.md
adapters/
README.md
community-adapters.md
drizzle.md
mongodb.md
mssql.md
mysql.md
other-relational.md
postgresql.md
prisma.md
sqlite.md
integrations/
README.md
astro.md
convex.md
electron.md
elysia.md
encore.md
expo.md
express.md
fastify.md
hono.md
lynx.md
nestjs.md
next.md
nitro.md
nuxt.md
react-router.md
solid-start.md
svelte-kit.md
tanstack.md
waku.md
effect.md
examples/
README.md
astro.md
next-js.md
nuxt.md
react-router.md
svelte-kit.md
authentication/
README.md
email-password.md
social-providers-common.md
other-social-providers.md
social-apple.md
social-atlassian.md
social-cloudflare.md
social-cognito.md
social-discord.md
social-dropbox.md
social-facebook.md
social-figma.md
social-github.md
social-gitlab.md
social-google.md
social-huggingface.md
social-kakao.md
social-kick.md
social-line.md
social-linear.md
social-linkedin.md
social-microsoft.md
social-naver.md
social-notion.md
social-paybin.md
social-paypal.md
social-polar.md
social-railway.md
social-reddit.md
social-roblox.md
social-salesforce.md
social-slack.md
social-spotify.md
social-tiktok.md
social-twitch.md
social-twitter.md
social-vercel.md
social-vk.md
social-wechat.md
social-zoom.md
plugins/
README.md
admin.md
agent-auth.md
anonymous.md
api-key.md
api-key-advanced.md
api-key-reference.md
autumn.md
bearer.md
captcha.md
chargebee.md
cimd.md
commet.md
community-plugins.md
creem.md
device-authorization.md
dodopayments.md
dub.md
email-otp.md
generic-oauth.md
have-i-been-pwned.md
i18n.md
jwt.md
last-login-method.md
magic-link.md
mcp.md
multi-session.md
oauth-provider.md
oauth-proxy.md
oidc-provider.md
one-tap.md
one-time-token.md
open-api.md
organization.md
passkey.md
phone-number.md
polar.md
scim.md
scim-groups-and-roles.md
scim-reference.md
siwe.md
sso.md
stripe.md
test-utils.md
two-factor.md
username.md
infrastructure/
README.md
introduction.md
getting-started.md
dashboard.md
audit-logs.md
sentinel.md
email-service.md
sms-service.md
reference/
README.md
contributing.md
options.md
resources.md
security.md
faq.md
instrumentation.md
telemetry.md
errors.md
error-account-already-linked.md
error-account-not-linked.md
error-email-doesnt-match.md
error-email-not-found.md
error-internal-server-error.md
error-invalid-callback-request.md
error-invalid-code.md
error-no-callback-url.md
error-no-code.md
error-oauth-provider-not-found.md
error-signup-disabled.md
error-state-invalid.md
error-state-mismatch.md
error-state-not-found.md
error-unable-to-create-session.md
error-unable-to-create-user.md
error-unable-to-get-user-info.md
error-unable-to-link-account.md
error-unknown.md
guides/
README.md
1-7-upgrade-guide.md
auth0-migration.md
browser-extension.md
clerk-migration.md
create-a-db-adapter.md
dynamic-base-url.md
next-auth-migration.md
optimizing-for-performance.md
saml-sso-with-okta.md
supabase-migration.md
workos-migration.md
your-first-plugin.md
samples/
README.md
astro.md
client-setup.md
convex.md
electron.md
elysia.md
email-password-auth.md
email-verification.md
encore.md
expo.md
express.md
fastify.md
hono.md
hooks.md
lynx.md
mcp-server.md
nestjs.md
next.md
nitro.md
nuxt.md
password-reset.md
react-router.md
server-setup.md
session-management.md
sign-out.md
social-sign-in.md
solid-start.md
svelte-kit.md
tanstack.md
two-factor-auth.md
user-management.md
waku.md
scripts/
README.md
cli.md
generate.md
install.md
探索手順
タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:
- 下記マッピング表でタスクに対応するカテゴリを探す
- そのカテゴリの
references/{category}/README.mdを参照して目的のページを特定する - 該当ページの
.mdを Read して詳細を確認する
タスク → カテゴリ マッピング
| タスク | カテゴリ | 参照 README |
|---|---|---|
| インストール・初期設定・auth インスタンス作成 | getting-started | references/getting-started/README.md |
| 基本的な認証パターン・メール/パスワード・セッション取得の概要 | getting-started | references/getting-started/README.md |
| auth.api・クライアント・セッション管理・Cookie・DB・フック・レートリミット | concepts | references/concepts/README.md |
| OAuth フロー・型安全性・プラグイン概念・動的ベース URL | concepts | references/concepts/README.md |
| Prisma / Drizzle / MongoDB / SQLite / PostgreSQL / MySQL 等の DB アダプター | adapters | references/adapters/README.md |
| コミュニティ製サードパーティ DB アダプター | adapters | references/adapters/README.md |
| Next.js / Nuxt / SvelteKit / Hono / Express / Fastify / Expo 等フレームワーク統合 | integrations | references/integrations/README.md |
| Astro / React Router / TanStack / Convex / Electron / NestJS 等の統合手順 | integrations | references/integrations/README.md |
| 公式ウォークスルー実例 (Astro, Next.js, Nuxt, React Router, SvelteKit) | examples | references/examples/README.md |
| Email/Password 認証・ソーシャルログイン (GitHub, Google, Apple 等) | authentication | references/authentication/README.md |
| 特定ソーシャルプロバイダー (Discord, Microsoft, LINE, Twitter 等) の設定 | authentication | references/authentication/README.md |
| 2FA (TOTP)・パスキー・マジックリンク・SMS OTP・匿名認証 | plugins | references/plugins/README.md |
| Organization・Admin・SSO・SCIM・API Key・JWT・Bearer トークン | plugins | references/plugins/README.md |
| Stripe / Chargebee / Polar / Autumn 等の課金・サブスクリプション統合 | plugins | references/plugins/README.md |
| MCP 認証・エージェント認証・SIWE・キャプチャ・パスワード漏洩チェック | plugins | references/plugins/README.md |
| コミュニティ製プラグイン一覧を確認したい | plugins | references/plugins/README.md |
| OAuth 2.1 / OIDC プロバイダー構築・CIMD・DPoP | plugins | references/plugins/README.md |
| SCIM の groups・roles・reference | plugins | references/plugins/README.md |
| Effect HTTP server 統合 | integrations | references/integrations/README.md |
| Better Auth Infrastructure(有料。@better-auth/infra の dash / sentinel、audit logs、managed email / SMS) | infrastructure | references/infrastructure/README.md |
| 設定オプション一覧・セキュリティガイド・FAQ | reference | references/reference/README.md |
| エラーコード調査・OpenTelemetry・テレメトリー | reference | references/reference/README.md |
| コントリビューションガイド・コミュニティ動画/ブログ等のリソース集 | reference | references/reference/README.md |
| 1.6 → 1.7 アップグレード・破壊的変更(npx auth upgrade) | guides | references/guides/README.md |
| Auth.js (NextAuth) / Auth0 / Clerk / Supabase / WorkOS からの移行 | guides | references/guides/README.md |
| カスタムプラグイン作成・カスタム DB アダプター作成・パフォーマンス最適化 | guides | references/guides/README.md |
| SAML SSO (Okta)・ブラウザ拡張機能統合・動的ベース URL 詳細 | guides | references/guides/README.md |
| 典型的な使い方・動作するコード例・フレームワーク別セットアップ断片 | samples | samples/README.md |
| インストールコマンド・CLI コマンド・スキーマ生成を知りたい | scripts | scripts/README.md |