Communitygithub.com

Anhvu1107/all-agent-skill

Utilize sempre que o usuário mencionar Melhores Práticas Next.js, pedir para construir, depurar, revisar, documentar, automatizar, testar, configurar, migrar ou tomar decisões neste domínio, ou a tarefa depender claramente das Melhores Práticas Next.js; escopo: princípios do App Router do Next.js. Aplique o fluxo de trabalho integrado, referências, scripts, padrão Master Sênior e a revisão rigorosa do Codex antes da saída final.

O que é all-agent-skill?

Este skill fornece um guia abrangente e detalhado sobre as melhores práticas para o Next.js, com foco nos princípios do App Router. Ele é projetado para desenvolvedores e agentes de IA que precisam construir, depurar, revisar, testar ou configurar aplicações Next.js de alta qualidade. O skill inclui decisões sobre Componentes Servidor vs. Cliente, padrões de busca de dados, organização de rotas, otimização de desempenho, uso de Server Actions e muito mais, tudo baseado nas convenções oficiais e anti-padrões do Next.js. Ao seguir o fluxo de trabalho definido (incluindo a leitura seletiva da documentação de referência), o agente pode garantir que o código gerado ou revisado esteja alinhado com o padrão 'Senior Master' e passe por uma verificação rigorosa antes da saída final. O skill suporta plataformas como Claude Code, Cursor e Codex, fornecendo uma estrutura clara para decisões de arquitetura, garantindo que a aplicação seja performática, acessível e de fácil manutenção.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Melhores Práticas Next.js

Regra de Leitura Seletiva

Comece com:

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

Em seguida, carregue apenas os documentos, scripts, assets ou exemplos herdados que correspondam à tarefa real do usuário.

Princípios para o desenvolvimento com App Router do Next.js.


1. Componentes Servidor vs. Cliente

Árvore de Decisão

Precisa de...?
│
├── useState, useEffect, manipuladores de eventos
│   └── Componente Cliente ('use client')
│
├── Busca de dados direta, sem interatividade
│   └── Componente Servidor (padrão)
│
└── Ambos?
    └── Divida: Servidor pai + Cliente filho

Por Padrão

TipoUso
ServidorBusca de dados, layout, conteúdo estático
ClienteFormulários, botões, UI interativa

2. Padrões de Busca de Dados

Estratégia de Fetch

PadrãoUso
PadrãoEstático (armazenado em cache no build)
RevalidarISR (atualização baseada em tempo)
Sem cacheDinâmico (a cada requisição)

Fluxo de Dados

OrigemPadrão
Banco de dadosFetch em Componente Servidor
APIfetch com cache
Entrada do usuárioEstado do cliente + Server Action

3. Princípios de Roteamento

Convenções de Arquivo

ArquivoPropósito
page.tsxUI da rota
layout.tsxLayout compartilhado
loading.tsxEstado de carregamento
error.tsxLimite de erro
not-found.tsxPágina 404

Organização de Rotas

PadrãoUso
Grupos de rota (nome)Organizar sem URL
Rotas paralelas @slotMúltiplas páginas no mesmo nível
Interceptação (.)Modais overlay

4. Rotas de API

Manipuladores de Rota

MétodoUso
GETLer dados
POSTCriar dados
PUT/PATCHAtualizar dados
DELETERemover dados

Melhores Práticas

  • Validar entrada com Zod
  • Retornar códigos de status adequados
  • Tratar erros de forma elegante
  • Usar Edge runtime quando possível

5. Princípios de Performance

Otimização de Imagens

  • Usar o componente next/image
  • Definir prioridade para conteúdo acima da dobra
  • Fornecer placeholder de desfoque
  • Usar tamanhos responsivos

Otimização de Bundle

  • Imports dinâmicos para componentes pesados
  • Divisão de código por rota (automática)
  • Analisar com bundle analyzer

6. Metadados

Estático vs Dinâmico

TipoUso
Exportação estáticaMetadados fixos
generateMetadataDinâmico por rota

Tags Essenciais

  • title (50-60 caracteres)
  • description (150-160 caracteres)
  • Imagens Open Graph
  • URL canônica

7. Estratégia de Cache

Camadas de Cache

CamadaControle
Requisiçãoopções do fetch
Dadosrevalidate/tags
Rota completaconfiguração da rota

Revalidação

MétodoUso
Baseado em temporevalidate: 60
Sob demandarevalidatePath/Tag
Sem cacheno-store

8. Server Actions

Casos de Uso

  • Submissões de formulário
  • Mutações de dados
  • Gatilhos de revalidação

Melhores Práticas

  • Marcar com 'use server'
  • Validar todas as entradas
  • Retornar respostas tipadas
  • Tratar erros

9. Anti-Padrões

❌ Não faça✅ Faça
'use client' em todo lugarServidor por padrão
Fetch em componentes clienteFetch no servidor
Pular estados de carregamentoUse loading.tsx
Ignorar limites de erroUse error.tsx
Grandes bundles clienteImports dinâmicos

10. Estrutura do Projeto

app/
├── (marketing)/     # Grupo de rota
│   └── page.tsx
├── (dashboard)/
│   ├── layout.tsx   # Layout do dashboard
│   └── page.tsx
├── api/
│   └── [resource]/
│       └── route.ts
└── components/
    └── ui/

Lembre-se: Componentes Servidor são o padrão por um motivo. Comece por eles, adicione cliente apenas quando necessário.

Quando Usar

Este skill é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.

Limitações

  • Use este skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
  • Não trate a saída como substituta para validação, teste ou revisão específica do ambiente.
  • Pare e peça esclarecimentos se entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem faltando.

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.

Habilidades Relacionadas