この記事は GitHub Dockyard Advent Calendar 2025🎄 の 24 日目の記事 です。
なおかつ、Microsoft Azure Tech Advent Calendar 2025🎄 の 23 日目の記事 です。
こんにちは、「スキルを作るスキルってメタすぎない？」とワクワクが止まらないアーキテクトのやまぱんです。
補足コメントや質問、いいね、拡散、ぜひお願いします 🥺！
間違っていたら 優しく 教えてください！
TL;DR
- Skill Creator を使って skill-finder という Agent Skills を自作しました
- Skill Creator は「Skill を作るための Skill」。対話するだけで
SKILL.mdやスクリプトのひな形を自動生成 - 「やりたいこと」を伝えるだけで、近いスキルを探せる のが skill-finder の強み
- 作る前にまず探す！14 ソース・195 以上のスキルをインデックスから検索・インストール・お気に入り管理できるメタスキル
- ローカルインデックスにないスキルも GitHub リポジトリを直接検索して発見・追加できる
- Python / PowerShell 両対応、GitHub CLI と連携してスキルの発見から導入までワンストップ
👉 動画デモはこちら
skill-finder は「スキルを探すためのスキル」。やりたいことを伝えるだけで、最適なスキルを提案してくれます。現時点で 14 ソース・195 以上のスキルをインデックス済み。任意のリポジトリを追加したり、インデックスを更新したりも自由にできます。
⚠️ 注意: この記事の内容（スキル数、ソース数、機能など）は 2025 年 12 月時点のものです。Agent Skills はまだ新しいエコシステムなので、仕様やツールが変わる可能性があります。skill-finder 自体もアップデートしていますので、最新情報は skill-finder リポジトリ を確認してください。
この記事の前提
- Agent Skills の概要を知っている（前回の記事 参照）
- GitHub Copilot や Claude Code を使ったことがある
- 「自分でも Skills を作ってみたい！」と思っている人向け
前提ツール（GitHub 検索機能を使う場合）
- GitHub CLI（gh）がインストール・認証済み
- Python 3.x または PowerShell 5.1+
きっかけ：Skill Creator がアツい！
前回の記事「🔥 はじめての Agent Skills 🔥 12 選＆リポジトリ一覧！」で、Skill Creator を紹介しました。
🌟 冬休みに試す予定！！
と書いていたのですが...待ちきれずにクリスマスイブにやっちゃいました。想像以上に楽しかったので、その体験記をお届けします！
Skill Creator とは？
Anthropic 公式が提供する「Skill を作るための Skill」です。
skills/skill-creator/
├── SKILL.md # メインの指示書
├── scripts/
│ ├── init_skill.py # 新規 Skill 初期化スクリプト
│ ├── package_skill.py # Skill パッケージ化スクリプト
│ └── quick_validate.py # Skill 検証スクリプト
└── references/
├── workflows.md # ワークフロー設計パターン
└── output-patterns.md # 出力形式のベストプラクティス
ref: anthropics/skills - skill-creator
何を作った？：skill-finder の紹介
今回作ったのは skill-finder という Agent Skills です。
解決したかった課題
スキルを作ろうと思ったとき、ふと思いました。
「これ、もう誰か作ってない？」
すでに似たスキルがあるなら、それを使うか、ベースにしてエンハンスすればいい。使ってみてフィードバックや PR を上げれば、エコシステム全体が良くなる。ゼロから車輪の再発明をするより、ずっと建設的ですよね。
でも、スキルを探すのが意外と面倒なんですよ：
- リポジトリごとにスキルを探し回るのが手間
- 「やりたいこと」で検索できない
- 気になったスキルをすぐにインストールしたい
作る前に、まず探す。 やりたいことに近いスキルがあれば、それを使うか参考にすればいい。
→ 「スキルを探すためのスキル」 があれば便利じゃない？
skill-finder の機能
| 機能 | 説明 |
|---|---|
| ローカル検索 | 195 以上のスキルから高速オフライン検索 |
| タグ検索 |
#azure #bicep のようなタグで絞り込み |
| GitHub 検索 | ローカルにない場合、GitHub API で SKILL.md を検索 |
| インストール | 見つけたスキルをローカルにダウンロード |
| お気に入り | よく使うスキルをスター管理 |
| 統計情報 | インデックスの統計とカテゴリ内訳を表示 |
| 自動更新 | 全ソースを GitHub から一括更新 |
| 類似スキル | カテゴリベースのおすすめ表示 |
ファイル構成
skill-finder/
├── SKILL.md # スキル定義（Agent への指示書）
├── README.md # ドキュメント
├── LICENSE.txt # MIT License
├── assets/
│ └── demo.mp4 # デモ動画
├── scripts/
│ ├── search_skills.py # Python スクリプト
│ └── Search-Skills.ps1 # PowerShell スクリプト
└── references/
├── skill-index.json # スキルインデックス（48+ skills）
└── starred-skills.json # お気に入りスキル
ref: aktsmm/Agent-Skills - skill-finder
開発プロセス：Skill Creator との対話
ここからが本題です！Skill Creator を使った開発体験を紹介します。
Step 1: 「こんなスキルが欲しい」と伝える
GitHub Copilot（Claude Opus 4.5）に、こんな感じで依頼しました：
🧑 User:
Agent Skills を検索・管理できるスキルを作りたいです。
skill-finder という名前で、以下の機能が欲しいです：
- ローカルのインデックスからスキルを検索
- GitHub API でスキルを探す
- 見つけたスキルをインストール
- お気に入り管理
🤖 Copilot:
skill-finder というスキルを作成しますね！
Skill Creator の init_skill.py を実行してひな形を生成します。
Copilot が Skill Creator を使って、自動でディレクトリ構造を作ってくれました。
Step 2: 対話しながら機能を追加
ひな形ができたら、対話しながら機能を足していきます。
🧑 User:
検索のロジックを考えてほしい。
ローカル → GitHub API → Web 検索のフォールバックにしたい。
🤖 Copilot:
3 段階のフォールバックですね。
SKILL.md に検索フローを追加しました。
scripts/search_skills.py も作成しましょうか？
🧑 User:
お願いします！あと PowerShell 版も欲しい。
🤖 Copilot:
両方作成しました。
Python 版と PowerShell 版の両方を一気に作ってもらえるのが楽でした。
Step 3: 使いながら改善
実際に使ってみると「ここ使いにくいな」という点が出てきます。
- 「インデックス更新ボタンが出ないときがある」→ 常に表示するよう修正
- 「検索結果が多いと見づらい」→ サマリー表示機能を追加
- 「エージェントの挙動がブレる」→ Agent Instructions を強化
こういう改善も Copilot に伝えるだけでサクサク直してもらえます。
Step 4: Agent Instructions を詳細に定義
最後に、エージェントの振る舞いを詳細に定義しました。これが skill-finder の真骨頂です。
## Agent Instructions
> ⚠️ **CRITICAL**: AI agents MUST follow these instructions.
### Skill Search Workflow
1. **Search ALL sources in local index**
2. **Recommend from results** (when multiple hits)
3. **If not found → Propose web search**
4. **After returning results → Propose next actions**
Agent Instructions とは？
SKILL.md 内に書く「エージェント向けの行動指示」です。
検索結果の出力フォーマット、次のアクション提案、チェックリストなどを定義します。
これにより、エージェントが一貫した振る舞いをしてくれます。
使ってみよう
せっかく作ったので、ぜひ使ってみてください！
インストール
skill-finder リポジトリ から取得して、所定のディレクトリに配置するだけです。
-
GitHub Copilot:
~/.github/skills/skill-finder/ -
Claude Code:
~/.claude/skills/skill-finder/
詳しい手順は README を参照してください。
やりたいことを伝えるだけ
skill-finder をインストールしたら、あとは自然言語で依頼するだけ。
🧑 User:
Azure 関連のスキルを探して
🤖 Agent:
7 リポジトリ、195 スキルから検索しました（最終更新: 2025-12-25）
| Skill | Description | Source |
| ---------------- | ---------------------------- | ------------------ |
| azure-env-builder| Azure 環境構築自動化 | aktsmm-agent-skills|
| mcp-builder | MCP サーバー構築 | aktsmm-agent-skills|
### おすすめ: azure-env-builder
理由: Azure 環境構築に特化、Bicep テンプレート付き
---
次のアクション:
1. 「azure-env-builder の詳細を見せて」
2. 「azure-env-builder をインストールして」
3. 「Web でもっと探して」
ローカルにないスキルも GitHub から探せる
ローカルインデックスにないスキルも、GitHub CLI を使って直接検索できます。
🧑 User:
Salesforce に役立つスキルの提案
🤖 Agent:
GitHub 検索して... Salesforce スキルが見つかりました！
| リポジトリ | URL | Trust |
| --------------------------------- | ---- | --------- |
| Zaxizuz/salesforce-claude-skills | View | Community |
含まれるスキル（4つ）:
| Skill | Description |
| ------------------------ | ---------------------------- |
| salesforce-apex | Apex 開発支援 |
| salesforce-claude-skills | Salesforce Claude 統合 |
| salesforce-orchestrator | Salesforce オーケストレーション |
| salesforce-qa | Salesforce QA/テスト |
---
次のアクション:
1. ➕ このソースをインデックスに追加する？
2. 🔍 各スキルの詳細を見る？
3. 📦 特定のスキルをインストールする？
裏側では GitHub CLI を活用した多段階検索を実行しています：
# SKILL.md を含むリポジトリをコード検索
gh search code "path:**/SKILL.md salesforce" --limit 20 --json repository,path,textMatches
# リポジトリ検索
gh search repos "salesforce claude skill" --limit 10 --json fullName,description,url
# 発見したリポジトリのスキル一覧を取得
gh api repos/Zaxizuz/salesforce-claude-skills/contents --jq '.[].name'
インデックスにないリポジトリも自動で発見し、追加を提案してくれます。
「作る前にまず探す」 を徹底できる、skill-finder の真骨頂です 🔥
デモ動画
実際の動作はこちら。
日本語デモ:
English Demo:
学び：Skill Creator を使った感想
良かった点
-
ひな形生成が楽
-
init_skill.pyで一発。ディレクトリ構造やライセンスも自動生成 - TODO コメント付きなので、何を書けばいいか迷わない
-
-
ベストプラクティスが学べる
-
references/workflows.mdやoutput-patterns.mdが参考になる - 「こういう構造にすると効果的なのか」という発見
-
-
対話しながら育てられる
- Copilot と壁打ちしながら SKILL.md を改善
- 「こういう機能も欲しい」→ 即座に反映
- GitHub Copilot の活用については GitHub Copilot Advent Calendar 2025 が参考になります
Tips
- description は簡潔に: 1024 文字以内、できれば 2〜3 文で
- Agent Instructions は具体的に: 曖昧な指示だとエージェントの挙動がブレる
- スクリプトは Python + PowerShell 両対応: ユーザー環境を選ばない
収録ソース一覧
skill-finder には以下のリポジトリがプリセットで登録されています（2025-12-25 時点で 14 ソース、195+ スキル）：
| Source | Type | Description |
|---|---|---|
| anthropics/skills | Official | Anthropic 公式 Claude Skills |
| github/awesome-copilot | Official | GitHub 公式 Copilot リソース集 |
| obra/superpowers | Community | 高品質なスキル・エージェント集 |
| ComposioHQ/awesome-claude-skills | Awesome | Claude Skills キュレーションリスト |
| K-Dense-AI/claude-scientific-skills | Community | 科学系スキル（大量！） |
| openshift-eng/ai-helpers | Community | HyperShift クラスタ作成 |
| fcakyon/claude-codex-settings | Community | Azure/GCloud/Slack 等ツール設定 |
| enuno/claude-command-and-control | Community | 並列エージェント実行・ワークフロー |
| jeremylongshore/claude-code-plugins-plus-skills | Community | AI SDK マルチエージェント |
| Chachamaru127/claude-code-harness | Community | ワークフロー・開発支援 |
| danielmiessler/Personal_AI_Infrastructure | Community | AI インフラ・オブザーバビリティ |
| lackeyjb/playwright-skill | Community | Playwright テストスキル |
| aktsmm/Agent-Skills | Community | Azure・開発系スキル by yamapan |
自分で新しいソースを追加することも可能です。Copilot に話しかけるだけ：
「https://github.com/owner/repo をソースに追加して」
まとめ
「スキルでスキルを作る」という体験は、まさに Agent Skills の真骨頂でした。
- Skill Creator は Skill 開発の入門として最適
- ひな形生成 → 対話で育成 → 完成 のフローがスムーズ
- 作ったスキルは GitHub Copilot / Claude 両方で使える
- 作る前にまず探す。skill-finder で既存スキルをチェックしよう
皆さんもぜひ、自分だけの Agent Skills を作ってみてください。
skill-finder を試してみたい方へ
skill-finder リポジトリ を ~/.github/skills/（Copilot）または ~/.claude/skills/（Claude）に配置するだけ！
Issue や PR も大歓迎です！
参考
- Skill Creator - Anthropic 公式
- skill-finder - aktsmm/Agent-Skills
- Agent Skills Specification
- 前回の記事：はじめての Agent Skills