Communitygithub.com

Anhvu1107/all-agent-skill

Úsalo SIEMPRE cuando el usuario mencione prácticas recomendadas de Next.js, pida construir, depurar, revisar, documentar, automatizar, probar, configurar, migrar o tomar decisiones en este dominio, o la tarea dependa claramente de las prácticas recomendadas de Next.js; alcance: principios de App Router de Next.js. Aplica el flujo de trabajo incluido, referencias, estándar Senior Master y la compuerta de revisión estricta de Codex antes de la salida final.

¿Qué es all-agent-skill?

Este skill de agente de IA proporciona un conjunto completo de mejores prácticas para desarrollar aplicaciones con Next.js, centrándose en el App Router. Está diseñado para ayudar a desarrolladores y agentes de IA a construir, depurar, revisar, documentar, automatizar, probar, configurar, migrar o tomar decisiones dentro del ecosistema de Next.js. El skill está optimizado para plataformas como Claude Code, Cursor y Codex, y se activa cuando el usuario menciona explícitamente prácticas recomendadas de Next.js o tareas relacionadas. El contenido incluye guías detalladas sobre la selección entre componentes de servidor y cliente, patrones de obtención de datos, principios de enrutamiento, manejo de rutas API, optimización del rendimiento, gestión de metadatos, estrategias de caché, acciones de servidor, antipatrones y estructura de proyectos. El agente debe consultar primero los documentos de referencia incluidos (senior-master-standard.md, usage-routing.md y quality-checklist.md) antes de aplicar el flujo de trabajo. El skill también especifica cuándo usarlo y sus limitaciones, como no sustituir la validación o revisión experta específica del entorno, y solicitar aclaraciones si faltan entradas, permisos o criterios de éxito necesarios.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Anhvu1107/all-agent-skill/tree/HEAD/.agent/skills/nextjs-best-practices

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Prácticas recomendadas de Next.js

Regla de lectura selectiva

Comienza con:

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

Luego carga solo los documentos, scripts, activos o ejemplos heredados que coincidan con la tarea real del usuario.

Principios para el desarrollo con App Router de Next.js.


1. Componentes de servidor vs cliente

Árbol de decisión

¿Necesita...?
│
├── useState, useEffect, controladores de eventos
│   └── Componente Cliente ('use client')
│
├── Obtención directa de datos, sin interactividad
│   └── Componente Servidor (por defecto)
│
└── ¿Ambos?
    └── Divide: Servidor padre + Cliente hijo

Por defecto

TipoUso
ServidorObtención de datos, diseño, contenido estático
ClienteFormularios, botones, UI interactiva

2. Patrones de obtención de datos

Estrategia de obtención

PatrónUso
Por defectoEstático (almacenado en caché en compilación)
RevalidarISR (actualización basada en tiempo)
Sin almacenamientoDinámico (cada solicitud)

Flujo de datos

OrigenPatrón
Base de datosObtención en componente servidor
APIfetch con almacenamiento en caché
Entrada del usuarioEstado del cliente + acción del servidor

3. Principios de enrutamiento

Convenciones de archivos

ArchivoPropósito
page.tsxUI de la ruta
layout.tsxDiseño compartido
loading.tsxEstado de carga
error.tsxLímite de error
not-found.tsxPágina 404

Organización de rutas

PatrónUso
Grupos de rutas (nombre)Organizar sin URL
Rutas paralelas @slotMúltiples páginas al mismo nivel
Interceptación (.)Superposiciones modales

4. Rutas API

Manejadores de ruta

MétodoUso
GETLeer datos
POSTCrear datos
PUT/PATCHActualizar datos
DELETEEliminar datos

Prácticas recomendadas

  • Validar entrada con Zod
  • Devolver códigos de estado apropiados
  • Manejar errores correctamente
  • Usar Edge runtime cuando sea posible

5. Principios de rendimiento

Optimización de imágenes

  • Usar el componente next/image
  • Establecer prioridad para contenido visible
  • Proporcionar marcador de posición borroso
  • Usar tamaños responsivos

Optimización del paquete

  • Importaciones dinámicas para componentes pesados
  • División de código basada en rutas (automática)
  • Analizar con bundle analyzer

6. Metadatos

Estáticos vs dinámicos

TipoUso
Exportación estáticaMetadatos fijos
generateMetadataDinámico por ruta

Etiquetas esenciales

  • title (50-60 caracteres)
  • description (150-160 caracteres)
  • Imágenes de Open Graph
  • URL canónica

7. Estrategia de almacenamiento en caché

Capas de caché

CapaControl
Solicitudopciones de fetch
Datosrevalidate/tags
Ruta completaconfiguración de ruta

Revalidación

MétodoUso
Basada en tiemporevalidate: 60
Bajo demandarevalidatePath/Tag
Sin cachéno-store

8. Acciones del servidor

Casos de uso

  • Envíos de formularios
  • Mutaciones de datos
  • Disparadores de revalidación

Prácticas recomendadas

  • Marcar con 'use server'
  • Validar todas las entradas
  • Devolver respuestas tipadas
  • Manejar errores

9. Antipatrones

❌ No hacer✅ Hacer
'use client' en todas partesServidor por defecto
Obtener datos en componentes clienteObtener datos en servidor
Saltar estados de cargaUsar loading.tsx
Ignorar límites de errorUsar error.tsx
Paquetes cliente grandesImportaciones dinámicas

10. Estructura del proyecto

app/
├── (marketing)/     # Grupo de rutas
│   └── page.tsx
├── (dashboard)/
│   ├── layout.tsx   # Diseño del panel
│   └── page.tsx
├── api/
│   └── [resource]/
│       └── route.ts
└── components/
    └── ui/

Recuerda: Los Componentes Servidor son la opción predeterminada por una razón. Empieza allí, agrega cliente solo cuando sea necesario.

Cuándo usar

Este skill es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la descripción general.

Limitaciones

  • Usa este skill solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como un sustituto de la validación, pruebas o revisión experta específica del entorno.
  • Detente y solicita aclaraciones si faltan entradas, permisos, límites de seguridad o criterios de éxito requeridos.

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

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 request matches Nextjs Supabase Auth: Expert integration of Supabase Auth with Next.js App Router

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 relacionados