Communitygithub.com

Anhvu1107/all-agent-skill

Utilisez TOUJOURS cette compétence lorsque la demande correspond à Next.js Supabase Auth : Intégration experte de Supabase Auth avec le Routeur d'application Next.js.

Qu'est-ce que all-agent-skill ?

Cette compétence fournit une intégration experte de Supabase Auth avec le routeur d'application Next.js (App Router). Elle inclut des modèles de code prêts à l'emploi pour la configuration des clients Supabase (navigateur et serveur), la mise en place d'un middleware d'authentification pour la protection des routes, la gestion des rappels OAuth, et les opérations d'authentification dans les actions serveur. La compétence met en œuvre les bonnes pratiques de sécurité, comme l'utilisation de `getUser()` au lieu de `getSession()` pour les vérifications critiques. Elle propose également une checklist de validation pour détecter les erreurs courantes (client navigateur utilisé en contexte serveur, absence de middleware, etc.) et un système de délégation pour collaborer efficacement avec d'autres compétences (base de données Supabase, routeur Next.js, déploiement Vercel). Idéale pour les développeurs utilisant des agents IA comme Claude Code ou Cursor, elle automatise la mise en place d'une authentification robuste et sécurisée dans les projets Next.js.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Anhvu1107/all-agent-skill/tree/HEAD/.agent/skills/nextjs-supabase-auth

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Next.js + Supabase Auth

Règle de lecture sélective

Commencez par :

  • references/senior-master-standard.md
  • references/usage-routing.md
  • references/quality-checklist.md

Chargez ensuite uniquement les documents hérités, scripts, ressources ou exemples correspondant à la tâche réelle de l'utilisateur.

Intégration experte de Supabase Auth avec le routeur d'application Next.js.

Capacités

  • nextjs-auth
  • supabase-auth-nextjs
  • auth-middleware
  • auth-callback

Prérequis

  • Compétences requises : nextjs-app-router, supabase-backend

Modèles

Configuration du client Supabase

Créez des clients Supabase correctement configurés pour différents contextes.

Quand l'utiliser : Configurer l'authentification dans un projet Next.js.

// lib/supabase/client.ts (Client navigateur)
'use client'
import { createBrowserClient } from '@supabase/ssr'

export function createClient() {
  return createBrowserClient(
    process.env.NEXT_PUBLIC_SUPABASE_URL!,
    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
  )
}
// lib/supabase/server.ts (Client serveur)
import { createServerClient } from '@supabase/ssr'
import { cookies } from 'next/headers'

export async function createClient() {
  const cookieStore = await cookies()
  return createServerClient(
    process.env.NEXT_PUBLIC_SUPABASE_URL!,
    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
    {
      cookies: {
        getAll() {
          return cookieStore.getAll()
        },
        setAll(cookiesToSet) {
          cookiesToSet.forEach(({ name, value, options }) => {
            cookieStore.set(name, value, options)
          })
        },
      },
    }
  )
}

Middleware d'authentification

Protégez les routes et rafraîchissez les sessions dans le middleware.

Quand l'utiliser : Vous avez besoin de protéger des routes ou de rafraîchir des sessions.

// middleware.ts
import { createServerClient } from '@supabase/ssr'
import { NextResponse, type NextRequest } from 'next/server'

export async function middleware(request: NextRequest) {
  let response = NextResponse.next({ request })

  const supabase = createServerClient(
    process.env.NEXT_PUBLIC_SUPABASE_URL!,
    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
    {
      cookies: {
        getAll() {
          return request.cookies.getAll()
        },
        setAll(cookiesToSet) {
          cookiesToSet.forEach(({ name, value, options }) => {
            response.cookies.set(name, value, options)
          })
        },
      },
    }
  )

  // Rafraîchir la session si elle a expiré
  const { data: { user } } = await supabase.auth.getUser()

  // Protéger les routes du tableau de bord
  if (request.nextUrl.pathname.startsWith('/dashboard') && !user) {
    return NextResponse.redirect(new URL('/login', request.url))
  }

  return response
}

export const config = {
  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
}

Route de rappel d'authentification

Gérez le rappel OAuth et échangez le code contre une session.

Quand l'utiliser : Utilisation de fournisseurs OAuth (Google, GitHub, etc.).

// app/auth/callback/route.ts
import { createClient } from '@/lib/supabase/server'
import { NextResponse } from 'next/server'

export async function GET(request: Request) {
  const { searchParams, origin } = new URL(request.url)
  const code = searchParams.get('code')
  const next = searchParams.get('next') ?? '/'

  if (code) {
    const supabase = await createClient()
    const { error } = await supabase.auth.exchangeCodeForSession(code)
    if (!error) {
      return NextResponse.redirect(`${origin}${next}`)
    }
  }

  return NextResponse.redirect(`${origin}/auth/error`)
}

Authentification par action serveur

Gérez les opérations d'authentification dans les actions serveur.

Quand l'utiliser : Connexion, déconnexion ou inscription à partir de composants serveur.

// app/actions/auth.ts
'use server'
import { createClient } from '@/lib/supabase/server'
import { redirect } from 'next/navigation'
import { revalidatePath } from 'next/cache'

export async function signIn(formData: FormData) {
  const supabase = await createClient()
  const { error } = await supabase.auth.signInWithPassword({
    email: formData.get('email') as string,
    password: formData.get('password') as string,
  })

  if (error) {
    return { error: error.message }
  }

  revalidatePath('/', 'layout')
  redirect('/dashboard')
}

export async function signOut() {
  const supabase = await createClient()
  await supabase.auth.signOut()
  revalidatePath('/', 'layout')
  redirect('/')
}

Obtenir l'utilisateur dans un composant serveur

Accédez à l'utilisateur authentifié dans les composants serveur.

Quand l'utiliser : Affichage de contenu spécifique à l'utilisateur côté serveur.

// app/dashboard/page.tsx
import { createClient } from '@/lib/supabase/server'
import { redirect } from 'next/navigation'

export default async function DashboardPage() {
  const supabase = await createClient()
  const { data: { user } } = await supabase.auth.getUser()

  if (!user) {
    redirect('/login')
  }

  return (
    <div>
      <h1>Bienvenue, {user.email}</h1>
    </div>
  )
}

Vérifications de validation

Utilisation de getSession() pour les vérifications d'authentification

Sévérité : ERREUR

Message : getSession() ne vérifie pas le JWT. Utilisez getUser() pour les vérifications d'authentification sécurisées.

Action corrective : Remplacez getSession() par getUser() pour les vérifications critiques de sécurité.

OAuth sans route de rappel

Sévérité : ERREUR

Message : Utilisation d'OAuth mais route de rappel manquante à app/auth/callback/route.ts

Action corrective : Créez app/auth/callback/route.ts pour gérer les redirections OAuth.

Client navigateur en contexte serveur

Sévérité : ERREUR

Message : Client navigateur utilisé dans un contexte serveur. Utilisez createServerClient à la place.

Action corrective : Importez et utilisez createServerClient depuis @supabase/ssr.

Routes protégées sans middleware

Sévérité : AVERTISSEMENT

Message : Aucun middleware.ts trouvé. Envisagez d'ajouter un middleware pour la protection des routes.

Action corrective : Créez middleware.ts pour protéger les routes et rafraîchir les sessions.

URL de redirection d'authentification codée en dur

Sévérité : AVERTISSEMENT

Message : Redirection localhost codée en dur. Utilisez origin pour la flexibilité de l'environnement.

Action corrective : Utilisez window.location.origin ou process.env.NEXT_PUBLIC_SITE_URL.

Appel d'authentification sans gestion d'erreur

Sévérité : AVERTISSEMENT

Message : Opération d'authentification sans gestion d'erreur. Vérifiez toujours les erreurs.

Action corrective : Déstructurez { data, error } et gérez le cas d'erreur.

Action d'authentification sans revalidation

Sévérité : AVERTISSEMENT

Message : Action d'authentification sans revalidatePath. Le cache peut afficher un état d'authentification obsolète.

Action corrective : Ajoutez revalidatePath('/', 'layout') après les opérations d'authentification.

Protection de route côté client uniquement

Sévérité : AVERTISSEMENT

Message : La protection de route côté client provoque un affichage fugitif du contenu. Utilisez le middleware.

Action corrective : Déplacez la protection vers middleware.ts pour une meilleure expérience utilisateur.

Collaboration

Déclencheurs de délégation

  • database|rls|queries|tables -> supabase-backend (L'authentification a besoin de la couche base de données)
  • route|page|component|layout -> nextjs-app-router (L'authentification a besoin des modèles Next.js)
  • deploy|production|vercel -> vercel-deployment (L'authentification a besoin de la configuration de déploiement)
  • ui|form|button|design -> frontend (L'authentification a besoin de composants d'interface)

Pile d'authentification complète

Compétences : nextjs-supabase-auth, supabase-backend, nextjs-app-router, vercel-deployment

Flux de travail :

1. Configuration de la base de données (supabase-backend)
2. Mise en œuvre de l'authentification (nextjs-supabase-auth)
3. Protection des routes (nextjs-app-router)
4. Configuration du déploiement (vercel-deployment)

SaaS protégé

Compétences : nextjs-supabase-auth, stripe-integration, supabase-backend

Flux de travail :

1. Authentification utilisateur (nextjs-supabase-auth)
2. Synchronisation client (stripe-integration)
3. Contrôle d'abonnement (supabase-backend)

Compétences connexes

Fonctionne bien avec : nextjs-app-router, supabase-backend

Quand l'utiliser

  • L'utilisateur mentionne ou sous-entend : supabase auth next
  • L'utilisateur mentionne ou sous-entend : authentication next.js
  • L'utilisateur mentionne ou sous-entend : login supabase
  • L'utilisateur mentionne ou sous-entend : auth middleware
  • L'utilisateur mentionne ou sous-entend : protected route
  • L'utilisateur mentionne ou sous-entend : auth callback
  • L'utilisateur mentionne ou sous-entend : session management

Limitations

  • Utilisez cette compétence uniquement lorsque la tâche correspond clairement au champ décrit ci-dessus.
  • Ne considérez pas le résultat comme un substitut à une validation, un test ou une revue experte spécifique à l'environnement.
  • Arrêtez-vous et demandez des clarifications si les entrées requises, les autorisations, les limites de sécurité ou les critères de succès sont absents.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches 007: Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Agentfolio: Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Animejs Animation: Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astropy: Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astro: Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Emotional ARC Designer: One sentence - what this skill does and when to invoke it

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Fixing Motion Performance: Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches I18n Localization: Internationalization and localization patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Interactive Portfolio: Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches JQ: Expert jq usage for JSON querying, filtering, transformation, and pipeline integration.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Landing Page Generator: Generates high-converting Next.js/React landing pages with Tailwind CSS.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches LEX: Centralized ''Truth Engine'' for cross-jurisdictional legal context (US, EU, CA) and contract scaffolding.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Magic Animator: AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Makepad Animation: CRITICAL: Use for Makepad animation system.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs APP Router Patterns: Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

Anhvu1107/all-agent-skill

ALWAYS use this when the user mentions Nextjs Best Practices, asks to build, debug, review, document, automate, test, configure, migrate, or make decisions in this domain, or the task clearly depends on Nextjs Best Practices; scope: Next.js App Router principles. Apply the bundled workflow, references, scripts, Senior Master standard, and Codex strict review gate before final output.

Anhvu1107/all-agent-skill

description: ALWAYS use this when the work is specifically about modern Next.js or React architecture, data flow, rendering strategy, routing, or performance-sensitive frontend behavior.

Anhvu1107/all-agent-skill

ALWAYS use this when the task involves reading, extracting, splitting, merging, rotating, creating, validating, OCR-ing, form-filling, or otherwise producing or modifying PDF files.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches React Nextjs Development: React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when working with Remotion code, video compositions, rendering logic, timing, media assets, or React-based motion workflows.

Skills associés