better-auth SKILL.md skillA

better-auth from secondsky/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add secondsky/claude-skills/better-auth@v3.1.0

Pins v3.1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
secondsky/claude-skills
Path
plugins/better-auth/skills/better-auth/SKILL.md
Versions recorded
5
Latest version
v3.1.0, committed Aug 3, 2026
First version recorded
Jan 18, 2026
Size
29,942 bytes
Repository stars
247
License
MIT

Skill for integrating Better Auth - comprehensive TypeScript authentication framework for Cloudflare D1, Next.js, Nuxt, and 15+ frameworks. Use when adding auth, encountering D1 adapter errors, or implementing OAuth/2FA/RBAC features.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# better-auth

**Status**: Production Ready
**Last Updated**: 2026-04-08
**Package**: `better-auth@1.6.0` (ESM-only)
**Dependencies**: Drizzle ORM or Kysely (required for D1 complex use cases; D1 native support available in v1.5+)

---

## Quick Start (5 Minutes)

### Installation

**Option 1: Drizzle ORM (Recommended)**
```bash
bun add better-auth drizzle-orm drizzle-kit
```

**Option 2: Kysely**
```bash
bun add better-auth kysely @noxharmonium/kysely-d1
```

### ⚠️ v1.4.0+ Requirements

better-auth v1.4.0+ is **ESM-only**. Ensure:

**package.json**:
```json
{
  "type": "module"
}
```

**Upgrading from v1.3.x?** Load `references/migration-guide-1.4.0.md`
**Upgrading from v1.4.x?** Load `references/migration-guide-1.5.0.md`

### ⚠️ CRITICAL: D1 Adapter Requirements

**v1.5.0+**: D1 is now natively supported. Pass your D1 binding directly:

```typescript
// ✅ SIMPLEST - D1 native (v1.5.0+)
import { betterAuth } from "better-auth";

const auth = betterAuth({
    database: env.DB, // D1 binding, auto-detected
});
```

For complex schemas, use Drizzle ORM:
```typescript
// ✅ RECOMMENDED for complex schemas - Drizzle
import { drizzleAdapter } from "better-auth/adapters/drizzle";
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add secondsky/claude-skills/better-auth@sha256:d1874a7729ad4ab3

The line at the top of this page pins the label v3.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ozu46wlh7qmxvoac.svg)](https://markdownregistry.com/a/art_ozu46wlh7qmxvoac)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jan 18, 2026 and Aug 3, 2026, about one every 49 days.

versioncommittedcommitsizeaudit
v3.1.0 latest2026-08-03 ddd6f10 29,942 BA view · diff
v3.1.02026-05-14 120edd6 29,939 BA view · diff
v3.1.02026-04-08 2e4f739 29,280 BA view · diff
v2.2.02026-04-02 89c5e89 23,807 BA view · diff
v2.2.02026-01-18 24a0f27 23,803 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (29942 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

secondsky/claude-skills · 247 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ozu46wlh7qmxvoac
GET https://markdownregistry.com/api/v1/resolve?ref=secondsky/claude-skills/better-auth
GET https://markdownregistry.com/api/v1/blob/d1874a7729ad4ab3775c17480739783b8a6d41fedf40d456c13b00b191c85055

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from secondsky/claude-skills

AGENTS.md AGENTS.md file
secondsky/claude-skills · AGENTS.md
git:20260829.7ecf025 · audit A · 247 stars
CLAUDE.md CLAUDE.md file
secondsky/claude-skills · CLAUDE.md
git:20260917.a0994f7 · audit A · 247 stars
aceternity-ui SKILL.md skill
secondsky/claude-skills · plugins/aceternity-ui/skills/aceternity-ui/SKILL.md · 100+ animated React components (Aceternity UI) for Next.js with Tailwind. Use for hero sections, parallax, 3D effects…
v1.1.0 · audit A · 247 stars
api-authentication SKILL.md skill
secondsky/claude-skills · plugins/api-authentication/skills/api-authentication/SKILL.md · Secure API authentication with JWT, OAuth 2.0, API keys. Use for authentication systems, third-party integrations…
git:20260402.75421fa · audit A · 247 stars
api-changelog-versioning SKILL.md skill
secondsky/claude-skills · plugins/api-changelog-versioning/skills/api-changelog-versioning/SKILL.md · Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API…
git:20260402.75421fa · audit A · 247 stars
api-contract-testing SKILL.md skill
secondsky/claude-skills · plugins/api-contract-testing/skills/api-contract-testing/SKILL.md · Verifies API contracts between services using consumer-driven contracts, schema validation, and tools like Pact. Use…
git:20260402.75421fa · audit A · 247 stars
api-design-principles SKILL.md skill
secondsky/claude-skills · plugins/api-design-principles/skills/api-design-principles/SKILL.md · Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight…
git:20260402.75421fa · audit A · 247 stars
api-error-handling SKILL.md skill
secondsky/claude-skills · plugins/api-error-handling/skills/api-error-handling/SKILL.md · Implements standardized API error responses with proper status codes, logging, and user-friendly messages. Use when…
git:20260402.75421fa · audit A · 247 stars
api-filtering-sorting SKILL.md skill
secondsky/claude-skills · plugins/api-filtering-sorting/skills/api-filtering-sorting/SKILL.md · Builds flexible API filtering and sorting systems with query parameter parsing, validation, and security. Use when…
git:20260402.75421fa · audit A · 247 stars
api-gateway-configuration SKILL.md skill
secondsky/claude-skills · plugins/api-gateway-configuration/skills/api-gateway-configuration/SKILL.md · Configures API gateways for routing, authentication, rate limiting, and request transformation in microservice…
git:20260402.75421fa · audit A · 247 stars
api-pagination SKILL.md skill
secondsky/claude-skills · plugins/api-pagination/skills/api-pagination/SKILL.md · Implements efficient API pagination using offset, cursor, and keyset strategies for large datasets. Use when building…
git:20260402.75421fa · audit A · 247 stars
api-rate-limiting SKILL.md skill
secondsky/claude-skills · plugins/api-rate-limiting/skills/api-rate-limiting/SKILL.md · Implements API rate limiting using token bucket, sliding window, and Redis-based algorithms to protect against abuse…
git:20260402.75421fa · audit A · 247 stars

Every file in secondsky/claude-skills

Other files named better-auth

better-auth SKILL.md skill
giuseppe-trisciuoglio/developer-kit · plugins/developer-kit-typescript/skills/better-auth/SKILL.md · Provides Better Auth integration patterns for NestJS backend and Next.js frontend with Drizzle ORM and PostgreSQL. Use…
git:20260324.a02e282 · audit A · 367 stars
better-auth SKILL.md skill
fusengine/agents · plugins/nextjs-expert/skills/better-auth/SKILL.md · Use when implementing Next.js authentication with Better Auth — OAuth, 2FA, magic links, SSO, Stripe billing, or…
git:20260927.43a351c · audit A · 36 stars
better-auth SKILL.md skill
vodailocz/kilo-kit-mcp · skills/engineering/better-auth/SKILL.md · Implement authentication and authorization with Better Auth - a framework-agnostic TypeScript authentication framework…
v2.0.0 · audit A · 27 stars
better-auth SKILL.md skill
tamnguyendinh/anvien · internal/aicontext/skills/better-auth/SKILL.md · Use when the user asks to implement Better Auth.
v2.0.0 · audit A · 12 stars

Browse by kind, by grade A, or by owner.