Communityコーディング&開発github.com

Next.js プロジェクトセットアップスキル (thanatornPik/nextjs-skill-app-workshop)

開発者がこのNext.jsプロジェクトのセットアップ、実行、理解方法について質問したときに使用します。新規参入者からの「プロジェクトの設定方法」「実行方法」「使用スタック」「Docker/Prismaのセットアップ」などのオンボーディング質問に対応します。

nextjs-skill-app-workshop) とは?

このスキルは、開発者がNext.jsプロジェクト(App Router + TypeScript、Prisma ORM、Docker対応)をクローンからローカル実行までスムーズにオンボーディングするためのガイドを提供します。具体的には、package.jsonに基づいた安全なスクリプトの案内、データベース破壊的操作の禁止、Dockerとnext.config.tsの整合性チェックなど、プロジェクト固有の注意点を網羅します。特に、Prisma Clientのカスタム出力パスやDockerfileのstandalone設定といったGotchasを明確に指示し、過剰なコマンド実行を防ぎます。対応プラットフォームはClaude CodeなどのAIエージェントで、オンボーディングスクリプト(check-onboarding.sh)の実行を推奨し、設定テンプレートを使った表形式の出力が可能です。このスキルは、新規メンバーがプロジェクトのツールスタックや設定を理解し、安全に環境を構築するのに役立ちます。

対応~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 コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

プロジェクトオンボーディングスキル

このプロジェクトをクローンからローカル実行までの流れを、新しい開発者が理解できるように支援します。回答の際は、リポジトリ内の実際のファイルを参照してください。

注意点(Gotchas)

  • package.json に存在しないスクリプトは推測しないでください。
  • オンボーディング中にデータベースを破壊するコマンド(例:npx prisma db push、npx prisma migrate deploy、npx prisma migrate dev)は使用しないでください。
  • Docker について言及する場合は、Dockerfile と next.config.ts の両方を確認してください。

セットアップ手順

最初に以下のスクリプトを確認・実行してください:.agents/skills/project-boarding-guide/scripts/check-onboarding.sh

スクリプトが実行できない場合は、以下のファイルを直接確認してください:

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

一般的なオンボーディングでは、以下の安全なコマンドのみを推奨します:

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

ユーザーがデータベースのセットアップやシードデータについて直接質問した場合は、このファイルを読んでください: references/database-setup.md

プロジェクトの注意点

詳細は references/project-notes.md を参照してください。

  • Next.js App Router + TypeScript
  • Prisma はカスタム出力先 generated/prisma を使用
  • Prisma Client のインポートは @prisma/client ではなく生成されたパスを使用
  • Dockerfile は .next/standalone を使用する可能性があります;next.config.ts に output: "standalone" が必要です
  • メインUIはタイ語です

出力形式

セットアップやプロジェクト設定に関する質問の場合は、assets/templates/setup-table.md のテンプレートのみを使用してください。

最低限以下を含める必要があります:

  • 簡単な概要
  • セットアップ手順の表
  • 実行するコマンド
  • このリポジトリの注意点

Individual skills in this repo

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

関連スキル