Module for integrating Better Auth into Nuxt applications.
Install
mkdir -p .claude/skills/nuxt-better-auth && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/7668" && unzip -o skill.zip -d .claude/skills/nuxt-better-auth && rm skill.zipInstalls to .claude/skills/nuxt-better-auth
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
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.Key capabilities
- →Configure Nuxt server auth helpers
- →Protect client-side and server-side routes
- →Integrate Better Auth plugins like 2FA
- →Manage session access in API routes
- →Sync database schemas with NuxtHub
How it works
It hooks into Nuxt's server engine and middleware lifecycle to inject session-checking logic and authentication helpers.
Inputs & outputs
When to use nuxt-better-auth
- →Adding login and signup flows to Nuxt
- →Protecting private routes
- →Accessing user sessions in API routes
About this skill
Nuxt Better Auth
Use the smallest reference that matches the task.
Pick a reference
| Task | Read |
|---|---|
| Install the module, configure environment variables, or create config files | references/installation.md |
| Read client session state, build auth forms, call plugins, or fetch auth-bound data | references/client-auth.md |
| Read or enforce sessions in server handlers, create sessions, or refresh cached session data | references/server-auth.md |
| Protect pages or API routes and configure redirects | references/route-protection.md |
| Register Better Auth plugins and their client companions | references/plugins.md |
| Configure NuxtHub, generated schema, or secondary storage | references/database.md |
| Connect a Nuxt frontend to an external Better Auth server | references/client-only.md |
| Use inferred auth types or add project fields | references/types.md |
Rules that apply across tasks
- Confirm the consumer's installed package version supports each API you use. The published skill may be newer than the consumer's lockfile.
- Enforce protected API reads and mutations server-side with
requireUserSession(event). Route rules and page meta also control navigation. - Navigate only to validated local redirect paths.
- In
clientOnlymode, do not use local server helpers or expect SSR session hydration. - After server-side changes to session payload fields, call
refreshSessionCookieCache(event). Wrap custom client auth endpoints that create or change the current session withrunWithSessionRefresh().
Before finishing an implementation, run the consumer's typecheck and the narrowest relevant auth test.
Resources
When not to use it
- →Production environments (currently alpha)
- →Non-Nuxt 4 authentication implementations
Prerequisites
Limitations
- →APIs subject to change due to alpha status
- →Strict dependency on Nuxt 4 framework structure
How it compares
It provides pre-configured Nuxt-specific composables rather than requiring manual session management and route middleware construction.
Compared to similar skills
nuxt-better-auth side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| nuxt-better-auth (this skill) | 1 | 8mo | No flags | Intermediate |
| nextjs-supabase-auth | 12 | 8mo | No flags | Intermediate |
| middleware-protection | 1 | 7mo | Review | Intermediate |
| payload | 73 | 4mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by onmax
View all by onmax →You might also like
nextjs-supabase-auth
davila7
Expert integration of Supabase Auth with Next.js App Router Use when: supabase auth next, authentication next.js, login supabase, auth middleware, protected route.
middleware-protection
dadbodgeoff
Protect routes with Next.js middleware. Check authentication once, protect routes declaratively. Supports public routes, protected routes, and role-based access.
payload
payloadcms
Use when working with Payload CMS projects (payload.config.ts, collections, fields, hooks, access control, Payload API). Use when debugging validation errors, security issues, relationship queries, transactions, or hook behavior.
backend-dev-guidelines
langfuse
Comprehensive backend development guide for Langfuse's Next.js 14/tRPC/Express/TypeScript monorepo. Use when creating tRPC routers, public API endpoints, BullMQ queue processors, services, or working with tRPC procedures, Next.js API routes, Prisma database access, ClickHouse analytics queries, Redis queues, OpenTelemetry instrumentation, Zod v4 validation, env.mjs configuration, tenant isolation patterns, or async patterns. Covers layered architecture (tRPC procedures → services, queue processors → services), dual database system (PostgreSQL + ClickHouse), projectId filtering for multi-tenant isolation, traceException error handling, observability patterns, and testing strategies (Jest for web, vitest for worker).
add-setting-env
lobehub
Guide for adding environment variables to configure user settings. Use when implementing server-side environment variables that control default values for user settings. Triggers on env var configuration or setting default value tasks.
workflow
vercel
Creates durable, resumable workflows using Vercel's Workflow DevKit. Use when building workflows that need to survive restarts, pause for external events, retry on failure, or coordinate multi-step operations over time. Triggers on mentions of "workflow", "durable functions", "resumable", "workflow devkit", or step-based orchestration.