thanatornPik/nextjs-skill-app-workshop

Use esta habilidade quando um desenvolvedor perguntar como configurar, executar ou entender este projeto Next.js. Use para perguntas de integração como "Como configurar este projeto?", "Como executá-lo?", "Qual stack é usado?" ou perguntas sobre configuração Docker/Prisma de alguém novo no código.

O que é nextjs-skill-app-workshop?

Esta habilidade é projetada para auxiliar desenvolvedores novatos a entenderem e configurarem rapidamente um projeto Next.js, desde a clonagem até a execução local. Ela oferece instruções seguras baseadas em arquivos reais do repositório, evitando scripts destrutivos de banco de dados como `npx prisma db push`. A habilidade suporta plataformas como Claude Code, Cursor e Codex, e funciona verificando primeiro um script de configuração em `.agents/skills/project-boarding-guide/scripts/check-onboarding.sh`. Se o script não puder ser executado, ela orienta o usuário a verificar manualmente arquivos-chave: `package.json`, `.env.example`, `prisma/schema.json`, `Dockerfile` e `next.config.ts`. Para perguntas sobre configuração de banco de dados ou dados de seed, ela referencia um arquivo `references/database-setup.md`. Além disso, utiliza um template de tabela em `assets/templates/setup-table.md` para formatar a resposta, garantindo uma apresentação clara com visão geral, tabela de etapas, comandos e alertas específicos do projeto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thanatornPik/nextjs-skill-app-workshop/tree/HEAD/.agents/skills/project-onboarding-guide

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Habilidade de Integração ao Projeto

Ajuda novos desenvolvedores a entenderem este projeto, desde a clonagem até a execução local, sempre referenciando os arquivos reais do repositório antes de responder.

Pontos de Atenção

  • Não adivinhe scripts que não estão em package.json
  • Não use comandos destrutivos de banco de dados durante a integração, como npx prisma db push, npx prisma migrate deploy, npx prisma migrate dev
  • Ao mencionar Docker, verifique tanto Dockerfile quanto next.config.ts

Etapa de Configuração

Verifique e execute este script primeiro: .agents/skills/project-boarding-guide/scripts/check-onboarding.sh Se não for possível executar o script, verifique manualmente:

  • package.json
  • .env.example
  • prisma/schema.json
  • Dockerfile
  • next.config.ts

Para integração geral, recomende apenas estes comandos seguros:

npm install
cp .env.example .env
npx prisma generate
npm run lint
npm run dev

Se o usuário perguntar sobre configuração de banco de dados ou dados de seed diretamente, leia este arquivo: references/database-setup.md

Pontos de Atenção do Projeto

Leia mais detalhes em references/project-notes.md

  • Next.js App Router + TypeScript
  • Prisma usa saída personalizada para generated/prisma
  • Import do Prisma Client a partir do caminho gerado, não de @prisma/client
  • Dockerfile pode usar .next/standalone; é necessário ter output: "standalone" em next.config.ts
  • A interface principal está em Português

Formato da Saída

Se perguntar sobre configuração ou ajustes do projeto, use o template em assets/templates/setup-table.md apenas.

Deve incluir no mínimo:

  • Visão geral resumida
  • Tabela de etapas de configuração
  • Comandos a serem executados
  • Avisos específicos do repositório

Individual skills in this repo

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

Habilidades Relacionadas