Skills: スキルの共有とマーケット
最終更新:2026-08-31
一人のベストプラクティスは経験、一群人のベストプラクティスは標準——共有で Skills を個人ツールからチーム資産へ。
1. 共有方式
(1) Git リポジトリ共有
最も基本的な共有方式で、Git でバージョン管理:
TEXT
📖 参照専用
チーム Skills リポジトリ構造
├── skills/
│ ├── code-review.md
│ ├── auto-test.md
│ ├── deploy.md
│ └── security-scan.md
├── README.md(インデックスと使用説明)
└── CHANGELOG.md(バージョン変更記録)
(2) プロジェクト内埋め込み
Skills をプロジェクトディレクトリに直接配置:
| プラットフォーム | ディレクトリ | 作用範囲 |
|---|---|---|
| Claude Code | .claude/skills/ |
現在のプロジェクト |
| Cursor | .cursor/rules/ |
現在のプロジェクト |
| OpenCode | skills/ |
現在のプロジェクト |
(3) グローバルインストール
すべてのプロジェクトに有効:
BASH
# Claude Code グローバル Skills
~/.claude/skills/
# ユーザーレベル設定
~/.config/opencode/skills/
2. 公開フロー
(1) Skill 品質チェックリスト
公開前に必ずチェック:
TEXT
📖 参照専用
公開前チェック
├── [ ] プロンプトが完全かつ具体的
├── [ ] Frontmatter 情報が正確(name、description、triggers)
├── [ ] 使用サンプルを含む
├── [ ] 少なくとも2つのプロジェクトでテスト通過
├── [ ] プロジェクトの機密情報を含まない
├── [ ] 依存ツールを説明済み
└── [ ] README 説明を含む
(2) Skill パッケージ構造
TEXT
📖 参照専用
公開パッケージ構造
├── skill-name.md # Skill メインファイル
├── README.md # 使用説明
├── examples/ # 使用サンプル
│ └── example-1.md
└── CHANGELOG.md # 変更記録
(3) バージョン番号の規約
TEXT
📖 参照専用
セマンティックバージョニング:MAJOR.MINOR.PATCH
MAJOR:互換性のないプロンプト変更(出力フォーマットの変更)
MINOR:後方互換の機能追加(レビュー観点の追加)
PATCH:後方互換の問題修正(プロンプトの曖昧さ修正)
例:
1.0.0 → 最初の正式版
1.1.0 → セキュリティレビュー観点を追加
1.1.1 → レビュー出力フォーマットの問題を修正
2.0.0 → 出力フォーマットを再構築(旧版と互換性なし)
3. 発見とインストール
(1) 発見チャネル
| チャネル | 特徴 | 適している |
|---|---|---|
| GitHub リポジトリ | バージョン管理、追跡可能 | チーム内共有 |
| コミュニティフォーラム | 議論+フィードバック | 汎用 Skill |
| 公式マーケット | 品質レビューあり | 高品質 Skill |
| 同僚の推薦 | 信頼度が高い | 業界固有 Skill |
(2) インストールフロー
BASH
# 方法1:直接コピー
cp community/code-review.md .claude/skills/
# 方法2:Git submodule
git submodule add https://github.com/team/skills.git .claude/skills-external
# 方法3:シンボリックリンク(開発時に使用)
ln -s ~/shared-skills/code-review.md .claude/skills/code-review.md
(3) 依存管理
YAML
# Skill 依存宣言
dependencies:
tools:
- Read
- Bash
skills:
- name: base-review
version: ">=1.0.0"
mcp_servers:
- database
4. チームスキルライブラリの実践
▶ 例:チーム Skills ライブラリの構築
Alice はチームのために標準化されたスキルライブラリを構築しました:
TEXT
📖 参照専用
チームスキルライブラリ
├── 01-実行系/ # タスクを直接実行する Skill
│ ├── deploy.md
│ ├── test-runner.md
│ └── lint-fix.md
├── 02-レビュー系/ # 分析と評価の Skill
│ ├── code-review.md
│ ├── security-scan.md
│ └── performance-check.md
├── 03-補助系/ # 提案を提供する Skill
│ ├── doc-generator.md
│ └── refactor-advisor.md
└── README.md # インデックスと使用ガイド
Bob は言います:「Skills ライブラリは単にファイルを集めることではない——分類、インデックス、バージョン管理が必要で、そうでなければ雑多なファイルと同じだ。」
❓ よくある質問
Q コミュニティ Skill をそのまま信頼していいですか?
A いけません。インストール前にプロンプトの内容を必ずレビューし、悪意のある指示(シークレットファイルの読み込み、危険なコマンドの実行など)が含まれていないことを確認してください。
Q チーム Skill と個人 Skill の競合をどう処理しますか?
A チーム Skill が個人 Skill より優先度が高くなります。個人カスタマイズはグローバルディレクトリに、チーム標準はプロジェクトディレクトリに配置します。
Q Skill 更新後に旧プロジェクトと互換性がない場合の対応は?
A セマンティックバージョニングを使用します。メジャーバージョン変更は非互換を意味し、旧プロジェクトはメジャーバージョンを固定します。
📖 まとめ
- 3つの共有方式:Git リポジトリ、プロジェクト内埋め込み、グローバルインストール
- 公開フロー:品質チェック → パッケージング → バージョン番号 → 公開
- 発見とインストール:GitHub、コミュニティ、マーケット + 依存管理
- チームスキルライブラリ:分類管理、インデックス保守、バージョンロック
📝 練習問題
- 基礎問題(難易度⭐):作成した Skill を Git リポジトリに整理し、README インデックスを書いてください。
- 応用問題(難易度⭐⭐):チーム向けに分類スキルライブラリを作成し、実行系、レビュー系、補助系それぞれ少なくとも1つの Skill を含めてください。
- チャレンジ問題(難易度⭐⭐⭐):バージョン宣言、互換性チェック、自動更新通知をサポートする Skill 依存管理システムを設計してください。