Communitygithub.com

ComeOnOliver/skillshub

Mutations, gestion de formulaires et appels de type RPC. À utiliser lors de l'implémentation de Server Actions, de mutations de formulaires ou de mutations de données de type RPC dans Next.js.

Qu'est-ce que skillshub ?

Ce skill fournit un guide complet pour implémenter des Server Actions dans Next.js, en utilisant le répertoire `app/` (App Router). Il couvre la directive `'use server'`, la gestion des formulaires avec l'attribut `action`, les états d'attente via `useFormStatus` et `useActionState`, et le raffraîchissement des données avec `revalidatePath` ou `revalidateTag`. Il insiste sur la validation des entrées (Zod), les vérifications d'autorisation dans chaque action, ainsi que les mises à jour optimistes avec `useOptimistic`. Le skill est conçu pour les développeurs Next.js souhaitant construire des mutations côté serveur sans créer d'API endpoints, tout en respectant les standards de sécurité et de performance. Il s'applique principalement aux fichiers `actions.ts` et aux composants `.tsx` utilisant des Server Actions, et inclut des anti-patrons à éviter pour maintenir un code robuste et prévisible.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/HoangNguyen0403/agent-skills-standard/nextjs-server-actions

Demander à votre IA préférée

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

Documentation

Server Actions

Priorité : P1 (HAUTE)

[!ATTENTION] Si le projet utilise le répertoire pages/ au lieu de l'App Router, ignorez complètement ce skill.

Gérez les soumissions de formulaires et les mutations sans créer d'API endpoints.

Consignes d'implémentation

  • Directive : Commencez toujours le fichier ou la fonction par 'use server'. Accédez à formData.get('title') pour les champs de formulaire typés. Exportez des fonctions asynchrones pour les mutations.

  • Gestion des formulaires : Utilisez la propriété action de <form> pour déclencher des actions via action={createPost}. Utilisez useFormStatus() pour les états d'attente — disabled={pending} sur les boutons. Utilisez useActionState (React 19/Next.js 15) pour l'état de formulaire avec action={action} et <form action={action}>.

  • Rafraîchissement des données : Déclenchez les mises à jour de l'interface utilisateur en utilisant revalidatePath('/') ou revalidateTag('nom-du-tag') après une mutation réussie.

  • Interactivité : Pour les déclencheurs non liés à un formulaire, invoquez les actions via le hook useTransition pour gérer l'interface de chargement et éviter de bloquer la page.

  • Mises à jour optimistes : Utilisez useOptimistic pour afficher immédiatement l'état attendu de l'interface avant que le serveur confirme la mutation.

  • Sécurité : Assainissez toutes les saisies provenant de FormData. Effectuez des vérifications d'authentification dans chaque action (await auth()). Limitez les téléchargements de fichiers par taille et par type MIME.

  • Formulaire : <form action={createPost}> (les améliorations progressives fonctionnent sans JS).

  • Gestionnaire d'événement : onClick={() => createPost(data)}.

  • État d'attente : Utilisez le hook useFormStatus (doit être à l'intérieur d'un composant rendu dans le formulaire).

P1 : Standard opérationnel

1. Sécuriser et valider

Validez toujours les entrées avec un schéma z.object({ et safeParse avant de les traiter. Vérifiez l'autorisation au sein de l'action. Voir Exemple d'action sécurisée.

2. États d'attente

Utilisez useActionState (React 19/Next.js 15+) pour la gestion d'état et useFormStatus pour les états de chargement des boutons.

Contraintes

  • Fermetures : Évitez de définir des actions à l'intérieur des composants pour éviter les frais généraux de cryptage de fermeture cachée et les bugs de sérialisation.
  • Redirection : Utilisez redirect() pour la navigation de succès ; cette fonction lève une erreur que Next.js intercepte pour gérer la redirection.

Anti-patrons

  • Pas d'entrées de Server Action non validées : Validez toujours avec Zod avant le traitement.
  • Pas de vérifications d'authentification ignorées : Vérifiez la session/utilisateur dans chaque action, pas seulement dans le middleware.
  • Pas d'actions définies dans les composants : Définissez-les dans actions.ts pour éviter les bugs de fermeture.
  • Pas de redirect() dans try/catch : redirect() lève une erreur ; l'intercepter supprime la redirection.

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés