TL;DR
npx skillbook install code-review
Claude Codeの SKILL.md をnpmみたいに検索・インストール・切り替えできるCLIツールをOSSで公開しました。Cursor / GitHub Copilot / Windsurfにも対応。
| URL | |
|---|---|
| Web | https://skillbooks.dev |
| GitHub | https://github.com/hatyibei/skillbook |
| npm | https://www.npmjs.com/package/skillbook |
背景
チームでClaude Codeを業務効率化に導入して、すぐにスキル管理が破綻しました。
問題1: プロジェクトごとにSKILL.mdを手動コピペ。どれが最新かわからない。
問題2: 業務によって使いたいスキルが違う（開発 vs ドキュメント vs レビュー）。毎回 .claude/skills/ を手動で入れ替えるのは非現実的。
問題3: チーム内でスキルを共有する仕組みがない。Slackでファイルを送り合う運用に限界。
npmやpipみたいなパッケージマネージャーがほしい。なかったので作りました。
基本的な使い方
初期化〜インストール
# 初期化
npx skillbook init claude-code
# 検索
npx skillbook search "コードレビュー"
# インストール（.claude/skills/ にシンボリックリンクが張られる）
npx skillbook install code-review
# 確認
npx skillbook ls
pnpm / bun でも動きます。
pnpm dlx skillbook install code-review
bunx skillbook init claude-code
スキルセット（一番の推し機能）
複数スキルをセットにして、ワンコマンドで一括切り替え。
# セット作成
npx skillbook create dev-set --skills code-review,tdd-test-generator,git-expert
# 装備
npx skillbook equip dev-set
# 解除して別セットに切り替え
npx skillbook unequip
npx skillbook equip docs-set
実装はシンボリックリンクの張り替えだけ。ファイルコピーなし。
実際のチーム運用では、朝 dev-set で開発 → 午後 docs-set でドキュメント、のように使っています。
スキルの公開
npx skillbook login
npx skillbook publish
105以上のスキルが登録済み。
コマンド一覧
| コマンド | 説明 |
|---|---|
init <agent> |
環境初期化 |
search <keyword> |
キーワード検索 |
install <name> |
インストール |
uninstall <name> |
アンインストール |
equip <set> |
スキルセット装備 |
unequip |
全解除 |
create <set> |
セット作成 |
publish |
公開 |
login / register
|
アカウント |
ls |
一覧 |
st |
装備状態 |
browse |
カテゴリ別ブラウズ |
get <name> |
スキル詳細 |
get-set <name> |
セット詳細 |
対応エージェント
| エージェント | スキルディレクトリ |
|---|---|
| Claude Code | .claude/skills/ |
| Cursor | .cursor/rules/ |
| GitHub Copilot | .github/copilot/ |
| Windsurf | .windsurf/rules/ |
アーキテクチャ
CLI (Node.js) ←→ API (Express / Cloud Run) ←→ Firestore
↑
Web ← Cloudflare Workers
技術選定の理由
Cloud Run — scale-to-zeroでトラフィックがなければ$0。個人OSSに最適。
Firestore — 無料枠が大きい。スキルのメタデータとユーザー管理に使用。
Cloudflare Workers — Cloud RunにカスタムドメインをCNAMEで向けると、Hostヘッダーの不一致で404になる。WorkerでHostを書き換えるリバースプロキシで解決。SSL設定はFullモード。
シングルHTML — Webカタログは1ファイル。CSS/JSすべてインライン。ビルドツールなし。
セキュリティ
| 対策 | 詳細 |
|---|---|
| レート制限 | IP単位。登録5回/時、ログイン10回/15分、publish 10回/時 |
| サニタイズ | HTMLタグ除去 + 長さ制限 |
| 認証 | Admin keyでbulk操作保護 |
| CORS | 許可オリジンのみ |
| WAF | Cloudflare |
Agent API
AIエージェントから直接叩けるAPI。
GET /api/agent/search?q=testing&agent=claude-code
GET /api/agent/skill/{name}
レスポンスはLLMのコンテキストウィンドウ向けに最適化されたJSON。MCPサーバーへの組み込みを想定。
ランニングコスト
ドメイン代 $10.18/年のみ。 Cloud Run + Firestoreの無料枠内で収まっています。
Webカタログ
RPGの武器屋モチーフのUI。レアリティ表示、カテゴリフィルタ、SKILL.mdプレビュー、ワンクリックコピー。
ロードマップ
- バージョン管理（semver）
- プライベートレジストリ（チーム/組織向け）
- エージェント間スキル互換チェック
- A/Bテスト
- VS Code拡張
まとめ
Claude CodeのSKILL.md管理を、npmライクなCLIで解決するツールです。
npx skillbook init claude-code
フィードバック・Issue・PR・スキルの投稿、歓迎です。