Add 260+ Claude Code skills from skills.sh
Complete collection of AI agent skills including: - Frontend Development (Vue, React, Next.js, Three.js) - Backend Development (NestJS, FastAPI, Node.js) - Mobile Development (React Native, Expo) - Testing (E2E, frontend, webapp) - DevOps (GitHub Actions, CI/CD) - Marketing (SEO, copywriting, analytics) - Security (binary analysis, vulnerability scanning) - And many more... Synchronized from: https://skills.sh/ Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
92
nuxt-better-auth/skill.md
Normal file
92
nuxt-better-auth/skill.md
Normal file
@@ -0,0 +1,92 @@
|
||||
---
|
||||
name: nuxt-better-auth
|
||||
description: Use when implementing auth in Nuxt apps with @onmax/nuxt-better-auth - provides useUserSession composable, server auth helpers, route protection, and Better Auth plugins integration.
|
||||
license: MIT
|
||||
---
|
||||
|
||||
# Nuxt Better Auth
|
||||
|
||||
Authentication module for Nuxt 4+ built on [Better Auth](https://www.better-auth.com/). Provides composables, server utilities, and route protection.
|
||||
|
||||
> **Alpha Status**: This module is currently in alpha (v0.0.2-alpha.14) and not recommended for production use. APIs may change.
|
||||
|
||||
## When to Use
|
||||
|
||||
- Installing/configuring `@onmax/nuxt-better-auth`
|
||||
- Implementing login/signup/signout flows
|
||||
- Protecting routes (client and server)
|
||||
- Accessing user session in API routes
|
||||
- Integrating Better Auth plugins (admin, passkey, 2FA)
|
||||
- Setting up database with NuxtHub
|
||||
- Using clientOnly mode for external auth backends
|
||||
|
||||
**For Nuxt patterns:** use `nuxt` skill
|
||||
**For NuxtHub database:** use `nuxthub` skill
|
||||
|
||||
## Available Guidance
|
||||
|
||||
| File | Topics |
|
||||
| -------------------------------------------------------------------- | ---------------------------------------------------------------------- |
|
||||
| **[references/installation.md](references/installation.md)** | Module setup, env vars, config files |
|
||||
| **[references/client-auth.md](references/client-auth.md)** | useUserSession, signIn/signUp/signOut, BetterAuthState, safe redirects |
|
||||
| **[references/server-auth.md](references/server-auth.md)** | serverAuth, getUserSession, requireUserSession |
|
||||
| **[references/route-protection.md](references/route-protection.md)** | routeRules, definePageMeta, middleware |
|
||||
| **[references/plugins.md](references/plugins.md)** | Better Auth plugins (admin, passkey, 2FA) |
|
||||
| **[references/database.md](references/database.md)** | NuxtHub integration, Drizzle schema, custom tables with FKs |
|
||||
| **[references/client-only.md](references/client-only.md)** | External auth backend, clientOnly mode, CORS |
|
||||
| **[references/types.md](references/types.md)** | AuthUser, AuthSession, type augmentation |
|
||||
|
||||
## Usage Pattern
|
||||
|
||||
**Load based on context:**
|
||||
|
||||
- Installing module? → [references/installation.md](references/installation.md)
|
||||
- Login/signup forms? → [references/client-auth.md](references/client-auth.md)
|
||||
- API route protection? → [references/server-auth.md](references/server-auth.md)
|
||||
- Route rules/page meta? → [references/route-protection.md](references/route-protection.md)
|
||||
- Using plugins? → [references/plugins.md](references/plugins.md)
|
||||
- Database setup? → [references/database.md](references/database.md)
|
||||
- External auth backend? → [references/client-only.md](references/client-only.md)
|
||||
- TypeScript types? → [references/types.md](references/types.md)
|
||||
|
||||
**DO NOT read all files at once.** Load based on context.
|
||||
|
||||
## Key Concepts
|
||||
|
||||
| Concept | Description |
|
||||
| ---------------------- | --------------------------------------------------------------- |
|
||||
| `useUserSession()` | Client composable - user, session, loggedIn, signIn/Out methods |
|
||||
| `requireUserSession()` | Server helper - throws 401/403 if not authenticated |
|
||||
| `auth` route mode | `'user'`, `'guest'`, `{ user: {...} }`, or `false` |
|
||||
| `serverAuth()` | Get Better Auth instance in server routes |
|
||||
|
||||
## Quick Reference
|
||||
|
||||
```ts
|
||||
// Client: useUserSession()
|
||||
const { user, loggedIn, signIn, signOut } = useUserSession()
|
||||
await signIn.email({ email, password }, { onSuccess: () => navigateTo('/') })
|
||||
```
|
||||
|
||||
```ts
|
||||
// Server: requireUserSession()
|
||||
const { user } = await requireUserSession(event, { user: { role: 'admin' } })
|
||||
```
|
||||
|
||||
```ts
|
||||
// nuxt.config.ts: Route protection
|
||||
routeRules: {
|
||||
'/admin/**': { auth: { user: { role: 'admin' } } },
|
||||
'/login': { auth: 'guest' },
|
||||
'/app/**': { auth: 'user' }
|
||||
}
|
||||
```
|
||||
|
||||
## Resources
|
||||
|
||||
- [Module Docs](https://github.com/onmax/nuxt-better-auth)
|
||||
- [Better Auth Docs](https://www.better-auth.com/)
|
||||
|
||||
---
|
||||
|
||||
_Token efficiency: Main skill ~300 tokens, each sub-file ~800-1200 tokens_
|
||||
Reference in New Issue
Block a user