📖 スキルの書 — The SkillBook

RPG-style skill management for AI agents
AIエージェントのスキルを探す・装備する・共有する。日本語で読めるスキルカタログ。

🌐 Web カタログ ・ 🚀 始める ・ 📋 コマンド ・ 🤖 対応エージェント

---

なぜ SkillBook？

AIエージェント（Claude Code, Cursor, Copilot...）が増えるなか、スキル（SKILL.md / .cursorrules）の管理が課題になっています。

• プロジェクトごとにスキルファイルを手動コピペしていませんか？
• チームで「この業務にはどのスキルセットがいい？」と迷っていませんか？
• 他の人が作った便利なスキルを探す場所がありませんか？

SkillBook はこれを解決します。RPGの装備システムのメタファーで、スキルの探索・装備・切り替え・共有をワンコマンドで。

クイックスタート

インストール不要。お好みのパッケージマネージャで即実行。

# npm
npx skillbook init claude-code

# pnpm
pnpm dlx skillbook init claude-code

# bun
bunx skillbook init claude-code

# カタログからスキルを検索
npx skillbook search "コードレビュー"

# スキルを取得して装備
npx skillbook get code-review
npx skillbook get design-army

# スキルセットを作って一括装備
npx skillbook create dev-set --skills code-review,design-army
npx skillbook equip dev-set

# 別の業務に切り替え
npx skillbook unequip
npx skillbook equip sales-kit

グローバルインストールする場合:

npm install -g skillbook    # npm
pnpm add -g skillbook       # pnpm
bun add -g skillbook        # bun

# 以降 npx なしで実行可能
skillbook search "テスト"
skillbook equip dev-set

仕組み

~/.skillbook/
  store/          ← 全スキルの実体（SKILL.md + リソース）
  sets/           ← スキルセット定義（JSON）
  config.json     ← 設定（使用エージェント、プロジェクト等）

.claude/skills/   ← シンボリックリンク（equip時に自動生成）
  code-review → ~/.skillbook/store/code-review
  design-army → ~/.skillbook/store/design-army

equip はシンボリックリンクの張り替えだけ。軽量で高速。バックエンド不要のローカル動作。

コマンド一覧

コマンド	説明
init [agent]	プロジェクト初期化（default: claude-code）
search <query>	カタログからスキル検索
get <name>	カタログからスキルを取得
get-set <name>	カタログからスキルセットを取得
add <name>	新規スキルをローカルに追加
import <path|url>	ローカル/Gitからスキルをインポート
install <npm-pkg>	npmパッケージからスキルをインストール
create <set>	スキルセットを作成
equip <set>	スキルセットを装備（アクティブ化）
unequip	装備解除
fork <set>	スキルセットをフォーク
agent [name]	エージェント切替
publish <set>	npmパッケージとして公開
login	SkillBook アカウントにログイン
browse	Webカタログをブラウザで開く
list / ls	スキル・セット一覧
status / st	現在の状態表示
help	ヘルプ表示

対応エージェント

エージェント	スキルディレクトリ	ステータス
Claude Code	.claude/skills/	✅ フルサポート
Cursor	.cursor/skills/	✅ フルサポート
GitHub Copilot	.github/copilot/skills/	✅ フルサポート
Codex	.codex/skills/	✅ サポート
Gemini CLI	.gemini/skills/	✅ サポート
Windsurf	.windsurf/skills/	✅ サポート
Goose	.goose/skills/	✅ サポート
Kiro	.kiro/skills/	✅ サポート
Roo Code	.roo/skills/	✅ サポート

三層アーキテクチャ

Layer	内容	例
Layer 1: 素材	個別スキル	code-review, design-army
Layer 2: 合成	名前付きスキルセット	@user/sales-kit
Layer 3: 組織	企業テンプレート	@company/onboarding

Web カタログ

skillbooks.dev — RPGテーマのスキルカタログサイト。

• 🔍 105+ スキルを日本語で検索
• ⚔️ レアリティ別フィルタ（Common / Rare / Epic / Legendary）
• 📋 SKILL.md のプレビューとワンクリックコピー
• ⭐ コミュニティレビュー
• 🤖 エージェントフレンドリーAPI（api.skillbooks.dev）

Agent API

AIエージェントが直接スキルを検索・取得できるAPI。LLMのコンテキストウィンドウに最適化されたJSON形式。

# スキル検索
curl https://api.skillbooks.dev/api/agent/search?q=testing&agent=claude-code

# スキル詳細（SKILL.md含む）
curl https://api.skillbooks.dev/api/agent/skill/tdd-test-generator

# おすすめスキル
curl https://api.skillbooks.dev/api/agent/discover?agent=claude-code

# スキル公開（要API key）
curl -X POST https://api.skillbooks.dev/api/agent/publish \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"my-skill","description":"...","content":"# My Skill\n..."}'

セルフホスト

git clone https://github.com/hatyibei/skillbook.git
cd skillbook

# バックエンド（要 GCP + Firestore）
cd backend && npm install && npm start

# Web（静的ファイル配信）
cd web && npx serve .

プロジェクト構成

skillbook/
  cli/            ← CLI ツール（Node.js / npm パッケージ）
  backend/        ← API サーバー（Express + Firestore on Cloud Run）
  web/            ← Web カタログ（シングルHTML + nginx on Cloud Run）
  docs/           ← ドキュメント・画像素材

Contributing

PRやIssue歓迎です！スキルの追加は特に大歓迎。

# 新しいスキルを追加するには
npx skillbook add my-awesome-skill
# SKILL.mdを編集して内容を書く
# PRを送る

License

MIT

---

Built with ❤️ by AI Tech Lead Team