开发敏感数据github未标认证来源可访问许可证需确认审计提醒

better-auth（Better Auth 认证）

Agent Skill

用于辅助安全审计、权限检查、凭据风险、认证流程和常见漏洞排查。它适合让 Agent 梳理敏感配置、检查依赖风险、分析鉴权逻辑或生成安全复核清单。使用时不能把工具输出直接当最终结论，涉及密钥、令牌、用户数据或生产系统时，应先确认最小权限、脱敏方式和操作边界。

总安装

970

周安装

GitHub Stars

下载量

317

CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息，不托管安装包，也不代用户安装。

GitHub

来源数

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：better-auth（Better Auth 认证）
来源仓库：https://github.com/oakoss/agent-skills
仓库路径：skills/better-auth
安装命令：
npx skills add https://github.com/oakoss/agent-skills --skill better-auth
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

skills.shnpx skills

npx skills add https://github.com/oakoss/agent-skills --skill better-auth

简介

better-auth 用于辅助安全审计、权限检查和认证流程分析。

它适合梳理敏感配置、检查依赖风险或生成安全复核清单。
使用时不能将工具输出直接当作最终结论。
涉及密钥、令牌或生产系统时，应先确认最小权限和操作边界。
适用宿主包括 Codex、Claude、Cursor、Gemini CLI，接入前应确认版本、权限和运行环境要求。

SKILL.md

better-auth

Package: better-auth@1.4.15 (ESM-only since v1.4.0) Docs: https://better-auth.com/docs | GitHub: https://github.com/better-auth/better-auth

Environment Setup

Variable	Purpose
`BETTER_AUTH_SECRET`	Encryption secret (min 32 chars). Generate: `openssl rand -base64 32`
`BETTER_AUTH_URL`	Base URL (e.g., `https://example.com`)

Only define baseURL/secret in config if env vars are NOT set. CLI looks for auth.ts in: ./, ./lib, ./utils, or ./src.

Core Config Options

Option	Notes
`appName`	Optional display name
`baseURL`	Only if `BETTER_AUTH_URL` not set
`basePath`	Default `/api/auth`. Set `/` for root.
`secret`	Only if `BETTER_AUTH_SECRET` not set
`database`	Required unless using stateless mode (v1.4+)
`secondaryStorage`	Redis/KV for sessions and rate limits
`emailAndPassword`	`{enabled: true}` to activate
`socialProviders`	`{google: {clientId, clientSecret},...}`
`plugins`	Array of plugins
`trustedOrigins`	CSRF whitelist

Plugin Reference

Plugin	Description
twoFactor	TOTP, email OTP, backup codes
organization	Multi-tenant orgs, teams, invitations, RBAC
admin	User management, impersonation, banning
passkey	WebAuthn passwordless login
magicLink	Email-based passwordless login
jwt	JWT tokens with key rotation, JWKS
oauthProvider	Build your own OAuth 2.1 provider (separate `@better-auth/oauth-provider` package)
sso	Enterprise SSO with OIDC, OAuth2, SAML 2.0 (separate `@better-auth/sso` package)
scim	Enterprise user provisioning (separate `@better-auth/scim` package)
stripe	Payment and subscription management
bearer	API token auth for mobile/CLI
apiKey	Token-based auth with rate limits
oneTap	Google One Tap frictionless sign-in
anonymous	Guest user access without PII
genericOAuth	Custom OAuth providers with PKCE
emailOTP	Email-based one-time password auth
phoneNumber	Phone/SMS-based OTP sign-in
username	Username-based sign-in (alternative to email)
multiSession	Multiple accounts in same browser
openAPI	Interactive API docs at `/api/auth/reference`

Session Strategies

Strategy	Format	Use Case
Compact (default)	Base64url + HMAC-SHA256	Smallest, fastest
JWT	Standard JWT	Interoperable
JWE	A256CBC-HS512 encrypted	Most secure

Getting Started

For new projects or first-time Better Auth setup, use the official interactive setup skill:

npx skills add better-auth/skills -s create-auth-skill

This walks through framework detection, database selection, auth method choices, plugin setup, and generates the initial configuration.

Anti-Patterns

Anti-Pattern	Correct Approach
Using `d1Adapter`	Use Drizzle or Kysely adapter with `provider: "sqlite"`
Using table name in config	Use ORM model name, not DB table name
Forgetting CLI after plugin changes	Re-run `npx @better-auth/cli@latest generate`
`tanstackStartCookies()` not last plugin	Must be the last plugin in array (TanStack Start)
Checking `session` for login state	Check `session?.user` — session object is always truthy
Missing `nodejs_compat` flag	Required in `wrangler.toml` for Cloudflare Workers
Kysely CamelCasePlugin with auth	Use separate Kysely instance without the plugin
Using old `reactStartCookies` import	Renamed to `tanstackStartCookies` from `better-auth/tanstack-start` in v1.4.14

Common Mistakes

Mistake	Correct Pattern
Setting `baseURL` and `secret` in config when env vars are already set	Only define these in config if `BETTER_AUTH_URL` and `BETTER_AUTH_SECRET` env vars are NOT set
Using CommonJS require syntax with better-auth v1.4+	better-auth is ESM-only since v1.4.0; use `import` syntax exclusively
Not re-running CLI generate after adding or changing plugins	Always run `npx @better-auth/cli@latest generate` after plugin changes to update DB schema
Checking `session` object truthy state for login detection	Check `session?.user` instead; the session object itself is always truthy
Using `d1Adapter` directly for Cloudflare D1	Use Drizzle or Kysely adapter with `provider: "sqlite"` for D1 compatibility

Breaking Changes

Version	Change
v1.4.14	`reactStartCookies` renamed to `tanstackStartCookies` (import from `better-auth/tanstack-start`)
v1.4.6	`allowImpersonatingAdmins` defaults to `false`
v1.4.0	ESM-only (no CommonJS); SSO, SCIM, OAuth Provider moved to separate packages
v1.3.0	Multi-team table structure: new `teamMembers` table needed

Delegation

When working on auth, delegate to:

application-security — Security architecture and threat modeling
database — Drizzle ORM schema and migrations
tanstack-start — TanStack Start integration patterns

Resources

Docs: https://better-auth.com/docs
Options Reference: https://better-auth.com/docs/reference/options
LLMs.txt: https://better-auth.com/llms.txt
Changelog: https://www.better-auth.com/changelogs
TanStack Start: https://www.better-auth.com/docs/integrations/tanstack
Expo: https://www.better-auth.com/docs/integrations/expo

References

Database Adapters — Drizzle, Kysely, Prisma adapters, Cloudflare Workers factory pattern
Session Management — Cookie cache, stateless sessions, storage priority, freshAge constraints
Plugins and Social Auth — Plugin setup, OAuth 2.1 provider, admin RBAC, social provider scopes
Email and Password — Verification, password reset, timing attack prevention, hashing (scrypt, argon2), token security
Two-Factor Authentication — TOTP, email/SMS OTP, backup codes, trusted devices, 2FA session flow
Organizations — Multi-tenant orgs, teams, invitations, RBAC, dynamic access control, lifecycle hooks
Configuration — User/account config, rate limiting, hooks, CSRF, trusted origins, cookie/OAuth security, production checklist
Framework Integration — TanStack Start setup, Expo/React Native, client imports, type safety
Migration Guides — Migrate from NextAuth/Auth.js, Clerk, or Supabase Auth with schema mappings and session strategies
Troubleshooting — D1 consistency, CORS, OAuth redirect, admin 403, nanostore refresh, known bugs

适合场景

用户想查找某类 Agent Skill 时

需要根据任务场景推荐可安装能力包时

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明，方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用；具体调用方式请以来源页面和 README 为准。

平台分布

Codex

34.15%

按下载量换算108

Claude

28.38%

按下载量换算90

Cursor

18.63%

按下载量换算59

Gemini CLI

9.02%

按下载量换算29

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

可疑

权限和风险

敏感数据

该 Skill 可能接触密钥、Token、环境变量或敏感配置，应进入高风险复核队列，默认不自动发布。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果，不能写成本站确认安全。当前只有一个来源，正式发布前建议补源仓库或其他目录站核验。

来源信息

GitHub 仓库

github.com

/oakoss/agent-skills

SKILL.md 来源

github.com

/oakoss/agent-skills/tree/main/skills/better-auth

skills-sh

skills.sh

/oakoss/agent-skills/better-auth

继续浏览同类 Skills

更多开发 Skills（21,746）返回 Skills 目录

上一个 Skill

better-auth（Better Auth 认证）

下一个 Skill

better-auth-integrations（更好的身份验证集成）