虎の穴ラボの古賀です。

主な担当は各プロダクトのセキュリティ対応、アーキテクト検討、フロントエンド設計＆実装です。

最近の推しは「ちいかわ」です。火曜日と金曜日の朝はめざましテレビでちいかわを見て出勤しています。最近は、「あのこを討伐」編が可愛すぎてしかたありません。

今回は社内向けにプライベートなClaude Codeのスキルマーケットを開設した際の手順を共有します。みなさまも社内でスキルマーケットを開設してみてはいかがでしょうか？

1. 目的

虎の穴ラボの社内ではAIによる開発の効率化や品質向上を進めていきたいと思っていますが、ノウハウの共有がwikiやドキュメント、スライド、Slackの会話などに散らばっていて、必要な情報やノウハウを見つけるのが難しいと感じました。また、お互いにどのようにClaude Codeを活用しているかフルリモートという環境もあって共有しづらい状況とも感じました。

そこで、社内で有用なスキルやツールを共有・活用できる環境を提供して共有しづらい状況を改善するために、社内向けのClaude Codeスキルマーケットを開設することにしました。

2. スキルとは？

SKILL.mdファイルに作業手順やワークフローを書くと、Claude Codeがそのスキルを認識して利用できるようになる仕組みです。

たとえば、以下のようなスキルを作成しました。

/run-checks → プロジェクトのテスト・静的解析を自動検出して実行
/rails-review-team → Agent Teamsで5人の専門家が並列にPRレビュー
/generate-scenario-test → GitHubのマイルストーンからスプレッドシートに貼れるシナリオテストを自動生成

SKILLの実体は単なるMarkdownファイルです。Claude Codeはユーザーが特定のキーワード（トリガーワード）やスラッシュから始まるコマンドを入力すると、インストールされたプラグインのSKILL.mdを自動的に読み込んでくれます。

普段からよく使っていてエンジニアなら馴染みのあるMarkdownで済むのはありがたいです。

3. スキルマーケットの概要

前述しましたが 特徴は「Markdownだけで完結する」こと でビルドもデプロイも不要で、コードを一行も書かずにClaude Codeの機能をさくっと拡張できます。

CLAUDE.mdのようにMarkdownを作成して保存するだけで、チーム全員が使えるスキルが完成します。

スキルマーケットを選んだ理由は、1〜2コマンドでインストールできてMarkdownで簡単に作成して共有できるため、社内の誰もが気軽に自分のスキルを作成・共有できて目的を達成できると考えたからです。

この方式だとエンジニア以外のマーケターやデザイナーもスキルを作成しやすいと思います。

エンジニアの場合も、相対ファイルパスの参照できるため、もしコードが必要になったらコードのテンプレートやスニペットを相対パスで参照することでスキルに含めることもできます。

スキルマーケットのサンプル

こちらは実際の社内向けのスキルマーケットに近いサンプルです。スキルは入っていませんがテンプレートとして利用できます。また、マーケットプレイス経由のスキルの導入はClaude Codeしか使えませんが、スキルはCopilotやCodex、Open Codeなどのエージェントも利用できます。

https://github.com/kght6123/skill-marketplace-template

4. スキルを追加または更新したい場合の運用フロー

社内の誰もが気軽に自分のスキルを作成・共有できることを目指しているので、運用フローはGitHubのよくある運用に合わせてシンプルにしています。以下の手順でスキルの追加や更新を行います。

Issueを建てる → PRを作る（Issue本人以外でもOK） → PRのレビュー依頼をする → レビュー＆マージ、場合によっては修正依頼 → Releaseタグ付与する

5. スキルの例

今回、作成した社内全体向けのスキルマーケットはプロダクト固有のものはいれない（プロダクト固有のものはこれを参考にチームに限定されたリポジトリを作ってください。）というルールにしています。

ひとつのGitHubの組織（Organizations）に複数のプロダクトが含まれている関係上、今後の拡張性やスキル自体の汎用性も考慮して全体とプロダクト別で分けてGitHubのリポジトリの権限で利用の可否を分けられるようにしました。

導入OKなスキル例

RubyやRails、Javaなど言語固有のもの
見積もりなどの手法
ユニットテストやE2Eテストの手法
開発原則関連のスキル

導入NGなスキル例

自社サービス固有の仕様のAPIテストを作るスキル（フレームワーク汎用のAPIテスト作成なら良い）
特定プロダクトのwikiを参照するスキル
特定プロダクトの環境構築をするスキル

・・・など

6. スキルマーケットとスキルの作り方

GitHubにプライベートリポジトリ（plugin-marketplace等）を作成して、そこにスキルをMarkdownファイルで追加していく形になります。

以下の手順で進めます。

最初の方でも紹介しましたが、こちらのリポジトリをテンプレートとして利用できます。

https://github.com/kght6123/skill-marketplace-template

6.1. 前提条件

Claude Code 2.1.44
GitHubリポジトリの管理権限
gh CLIがインストールされたローカル環境

6.2. リポジトリ構成

プライベートリポジトリの構成は以下のようになっています。スキルは plugins/{name}/skills/{name}/SKILL.md にMarkdownファイルで追加します。

plugin-marketplace/
├── .claude-plugin/
│   └── marketplace.json              # マーケットプレイス定義
├── plugins/                          # プラグイン群
│   └── {my-plugin}/
│       ├── .claude-plugin/
│       │   └── plugin.json           # プラグインマニフェスト
│       └── skills/
│           └── {my-skill}/
│               └── SKILL.md          # スキル定義（ここが本体）
└── README.md

リポジトリ構成を見るとわかるように、スキルはpluginsの中のskillsとして公開します。実態はプラグインの一機能です。

6.3. プラグインの中にスキルを作る方法（3ステップ）

プラグインとスキルに必要なファイル群を作成します。

Step 1: ディレクトリとplugin.jsonを作成

# ディレクトリ作成
mkdir -p plugins/{my-plugin}/.claude-plugin
mkdir -p plugins/{my-plugin}/skills/{my-skill}

// plugins/{my-plugin}/.claude-plugin/plugin.json
{
  "name": "my-plugin",
  "description": "○○するスキル群"
}

Step 2: SKILL.mdを作成

テンプレート（templates/SKILL_TEMPLATE.md）をコピーして書き換えます。

---
name: my-skill
description: ○○するスキル。「トリガー1」「トリガー2」「トリガー3」などで使用。
---

# スキル名

## 概要

このスキルが何をするかを簡潔に説明。

## ワークフロー

### Step 1: 最初のステップ
具体的な作業手順を記述。

### Step 2: 次のステップ
次の作業手順を記述。

### Step 3: 完了
最終的な出力や結果について。

テンプレートのサンプル（全体）はこちらにあります。

https://github.com/kght6123/skill-marketplace-template/blob/main/templates/SKILL_TEMPLATE.md

フロントマターのルール：

項目	必須	説明
`name`	Yes	スキルの識別名。ディレクトリ名と一致させる
`description`	Yes	スキルの説明。スキルが使われるトリガーワードを含める
`argument-hint`	No	引数のヒント。例: `[フロントエンド\|バックエンド\|all]`
`allowed-tools`	No	許可するツール。例: `Bash(npm:*)`

Step 3: marketplace.jsonに登録してPRを出す

.claude-plugin/marketplace.json の plugins 配列にエントリを追加します。

{
  "name": "my-plugin",
  "description": "○○するスキル群",
  "source": "./plugins/my-plugin"
}

最後にリポジトリにコミット＆プッシュします。

6.4. プラグインのインストール方法

次のようにコマンドを実行して、マーケットプレイスの追加とスキルのインストールを行います。

# マーケットプレイスを追加
claude plugin marketplace add 組織名/plugin-marketplace

# 好きなスキルをインストール
claude plugin install hello-world@組織名-plugin-marketplace

プライベートリポジトリなので、インストールにはSSH認証または gh auth login などによる認証が必要です。

実際にClaude Codeで以下のようにスキルが利用可能になります。

❯ /plugin marketplace add kght6123/skill-marketplace-template 
  ⎿  Successfully added marketplace: skill-marketplace-template                                                                               

❯ /plugin install example-skill@skill-marketplace-template                                                                                    
  ⎿  ✓ Installed example-skill. Restart Claude Code to load new plugins.                                                                      

# Claude Codeを再起動後、スラッシュコマンドでスキルが利用可能に

❯ /example-skill  <how do I create a skill>