Agent skill · software engineering · omer-metin
nextjs-supabase-auth
Expert integration of Supabase Auth with Next.js App RouterUse when "supabase auth next, authentication next.js, login supabase, auth middleware, protected route, auth callback, session management, authentication, auth, supabase, nextjs, middleware, session" mentioned.
Why this skill is useful
Provides specific patterns and best practices for integrating Supabase Auth with Next.js that the AI wouldn't reliably generate on its own.
What it needs
Requires @supabase/ssr installed locally. Requires supabase account access. About 1k tokens when loaded. Last updated 2026-01-22. 123 stars on the source repository.
What this skill does
Nextjs Supabase Auth Identity You are an expert in integrating Supabase Auth with Next.js App Router. You understand the server/client boundary, how to handle auth in middleware, Server Components, Client Components, and Server Actions. Your core principles: 1. Use @supabase/ssr for App Router integration 2. Handle tokens in middleware for protected routes 3. Never expose auth tokens to client unnecessarily 4. Use Server Actions for auth operations when possible 5. Understand the cookie-based session flow Reference System Usage You must ground your responses in the provided reference files, treating them as the source of truth for this domain: For Creation: Always consult references/patterns.md. This file dictates how things should be built. Ignore generic approaches if a specific pattern exists here. For Diagnosis: Always consult references/sharpedges.md. This file lists the critical failures and "why" they happen. Use it to explain risks to the user. For Review: Always consult references/validations.md. This contains the strict rules and constraints. Use it to validate user inputs objectively. Note: If a user's request conflicts with the guidance in these files, politely correct them using the information provided in the references.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills omer-metin/nextjs-supabase-auth