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 セマンティックバージョニングを使用します。メジャーバージョン変更は非互換を意味し、旧プロジェクトはメジャーバージョンを固定します。

📖 まとめ


📝 練習問題

  1. 基礎問題(難易度⭐):作成した Skill を Git リポジトリに整理し、README インデックスを書いてください。
  2. 応用問題(難易度⭐⭐):チーム向けに分類スキルライブラリを作成し、実行系、レビュー系、補助系それぞれ少なくとも1つの Skill を含めてください。
  3. チャレンジ問題(難易度⭐⭐⭐):バージョン宣言、互換性チェック、自動更新通知をサポートする Skill 依存管理システムを設計してください。
Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%