favorite-stack

favorite-stack

お気に入りの技術スタックで Web アプリを作るためのプロジェクトテンプレート＋ AI スキルです。

スタック： Node.js 24 · TypeScript (tsgo) · Vite · Vitest · SQLite · Alpine.js · Pico.css · Pino · oxlint · oxfmt · pnpm

---

スキルのインストール

このリポジトリには Agent Skills 標準に準拠したスキルが含まれており、Claude Code・GitHub Copilot CLI・Gemini CLI など多くの AI ツールで使えます。

npx skills（推奨）

# すべての AI ツールに一括インストール（インタラクティブ）
npx skills add https://github.com/oharato/favorite-stack

# エージェントを指定してインストール
npx skills add https://github.com/oharato/favorite-stack -a claude-code -a github-copilot -a gemini-cli

# 確認プロンプトをスキップ
npx skills add https://github.com/oharato/favorite-stack -a claude-code -y

# グローバルインストール（全プロジェクトで使えるようにする）
npx skills add https://github.com/oharato/favorite-stack -a claude-code -g

Claude Code — プラグインとしてインストール

/plugin marketplace add oharato/favorite-stack
/plugin install favorite-stack@oharato/favorite-stack

インストール後、/reload-plugins で反映。

手動インストール

skills/favorite-stack/ ディレクトリをエージェントのスキルフォルダにコピーまたはシンボリックリンクします。

エージェント	プロジェクト	グローバル
Claude Code	.claude/skills/	~/.claude/skills/
GitHub Copilot	.agents/skills/	~/.copilot/skills/
Gemini CLI	.agents/skills/	~/.gemini/skills/

# 例：Claude Code にシンボリックリンクで追加
ln -s $(pwd)/skills/favorite-stack .claude/skills/favorite-stack

---

プロジェクトテンプレートとして使う

# リポジトリをコピーして新しいプロジェクトを作成
cp -r favorite-stack my-new-app
cd my-new-app

# 依存関係をインストール
pnpm install

# 開発サーバー起動
pnpm dev

コマンド

pnpm dev              # Vite 開発サーバー
pnpm build            # プロダクションビルド
pnpm test             # Vitest（1回実行）
pnpm test:watch       # Vitest（ウォッチ）
pnpm lint             # oxlint
pnpm fmt              # oxfmt
pnpm typecheck        # tsgo --noEmit
pnpm check            # lint + fmt + typecheck
pnpm sync-ai          # AGENTS.md を GEMINI.md / copilot-instructions.md に同期

---

AI 指示ファイルの構成

ファイル	対象	説明
AGENTS.md	全ツール共通	プロジェクトレベルの指示（唯一の正源）
CLAUDE.md	Claude Code	@AGENTS.md でインポート
GEMINI.md	Gemini CLI	AGENTS.md のコピー
.github/copilot-instructions.md	GitHub Copilot	AGENTS.md のコピー
skills/favorite-stack/SKILL.md	全ツール	Agent Skills スタンダード準拠のスキル本体

AGENTS.md を編集したら pnpm sync-ai を実行してください。