CommunityProgramación y desarrollogithub.com

thanatornPik/nextjs-skill-app-workshop

Utiliza esta habilidad cuando un desarrollador pregunte cómo configurar, ejecutar o entender este proyecto Next.js. Es útil para preguntas de onboarding como '¿cómo se configura este proyecto?', '¿cómo empezar a ejecutarlo?', '¿qué stack usa?' o consultas sobre Docker/Prisma de alguien nuevo en el código.

¿Qué es nextjs-skill-app-workshop?

Esta habilidad está diseñada para guiar a desarrolladores nuevos en el proceso de onboarding de un proyecto Next.js específico, desde la clonación hasta la ejecución local. Proporciona pasos seguros y recomendados, verificando siempre la existencia de scripts en `package.json` y evitando comandos destructivos de base de datos. Soporta plataformas como Claude Code y Cursor, y se basa en la documentación real del repositorio (archivos como `package.json`, `.env.example`, `prisma/schema.json`, `Dockerfile`, `next.config.ts`). Además, incluye gotchas importantes sobre la configuración de Prisma (output personalizado a `generated/prisma`) y Docker (necesidad de `output: "standalone"` en `next.config.ts`), y recomienda usar una plantilla de tabla de setup en las respuestas.

Compatible con~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 Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Habilidad de Onboarding del Proyecto

Ayuda a los desarrolladores nuevos a entender este proyecto, desde la clonación hasta la ejecución local, haciendo referencia a los archivos reales del repositorio antes de responder.

Puntos Críticos

  • No adivinar scripts que no estén en package.json.
  • No usar comandos destructivos de base de datos durante el onboarding, como npx prisma db push, npx prisma migrate deploy, npx prisma migrate dev.
  • Si se menciona Docker, verificar tanto Dockerfile como next.config.ts.

Paso de Configuración

Verifica y ejecuta este script primero: .agents/skills/project-boarding-guide/scripts/check-onboarding.sh

Si el script no se puede ejecutar, verifica manualmente:

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

Para el onboarding general, recomienda solo estos comandos seguros:

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

Si el usuario pregunta sobre la configuración de la base de datos o datos de seed, lee este archivo: references/database-setup.md

Puntos Críticos del Proyecto

Lee más detalles en references/project-notes.md

  • Next.js App Router + TypeScript
  • Prisma usa una salida personalizada a generated/prisma
  • El Cliente Prisma se importa desde la ruta generada, no desde @prisma/client
  • El Dockerfile puede usar .next/standalone; debe tener output: "standalone" en next.config.ts
  • La interfaz de usuario principal está en tailandés

Formato de Salida

Si la consulta es sobre configuración o ajustes del proyecto, usa únicamente la plantilla en assets/templates/setup-table.md

Debe incluir al menos:

  • Una breve descripción general
  • Una tabla con los pasos de configuración
  • Los comandos a ejecutar
  • Las advertencias de este repositorio

Individual skills in this repo

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

Skills relacionados