Skill Gallery
← ブログ一覧に戻る
Tips

チームでAgent Skillsを共有する方法【ワークフロー標準化のコツ】

Skill Gallery Team•2026年1月24日•5 分で読める
English version →

Agent Skillsの大きな利点は、チームで共有できることです。

「PRの書き方がバラバラ」「コードレビューの観点が人によって違う」といった問題を、スキルで標準化できます。

この記事では、チームでスキルを共有・管理する方法を解説します。

共有方法の選択肢

方法1：プロジェクトリポジトリに含める

最もシンプルな方法です。プロジェクトの.claude/skills/にスキルを配置し、コードと一緒にバージョン管理します。

your-project/
├── src/
├── .claude/
│   └── skills/
│       ├── code-review/
│       │   └── SKILL.md
│       └── pr-template/
│           └── SKILL.md
└── package.json

メリット：

  • セットアップ不要。cloneすれば使える
  • プロジェクトの変更と同期
  • コードレビューでスキルもレビューできる

デメリット：

  • プロジェクト固有のスキルのみ
  • 複数プロジェクトで共有するには別の方法が必要

方法2：スキル専用リポジトリを作る

チーム共通のスキルを別リポジトリで管理します。

team-skills/
├── code-review/
│   └── SKILL.md
├── pr-template/
│   └── SKILL.md
├── security-check/
│   └── SKILL.md
└── README.md

各メンバーがクローンして~/.claude/skills/に配置：

git clone git@github.com:your-org/team-skills.git ~/.claude/skills/team

メリット：

  • 全プロジェクトで共通のスキルを使える
  • スキルの更新が一元管理できる

デメリット：

  • 各メンバーがセットアップ必要
  • 更新の反映はgit pullが必要

方法3：Git submoduleで管理

プロジェクトにスキルリポジトリをsubmoduleとして追加します。

git submodule add git@github.com:your-org/team-skills.git .claude/skills/team

メリット：

  • プロジェクトとスキルのバージョンを紐付けできる
  • cloneと同時にスキルも取得（--recursiveオプション）

デメリット：

  • submoduleの運用に慣れが必要

チーム運用のベストプラクティス

スキルのREADMEを充実させる

# code-review

PRのコードをレビューするスキル。

## 使い方

/code-review


または自然言語で「PRをレビューして」と依頼。

## レビュー観点

- セキュリティ
- パフォーマンス
- 保守性
- テストカバレッジ

## 更新履歴

- 2026-01-24: 初版作成
- 2026-01-20: TypeScript固有のチェック追加

変更はPRで

スキルの変更もコードと同様にPRで行い、チームでレビューします。

git checkout -b update-code-review-skill
# SKILL.mdを編集
git commit -m "feat: code-reviewスキルにa11yチェックを追加"
git push origin update-code-review-skill
# PRを作成

バージョンを明記

SKILL.mdにバージョン情報を含めると、トラブルシューティングに役立ちます。

---
name: code-review
description: PRのコードをレビューする
version: 1.2.0
---

オンボーディングドキュメントを作る

新メンバー向けに、スキルのセットアップ手順をドキュメント化しておきます。

# 開発環境セットアップ

## 1. チームスキルのインストール

```bash
git clone git@github.com:your-org/team-skills.git ~/.claude/skills/team

2. スキルの確認

Claude Codeで /skills を実行し、以下のスキルが表示されることを確認：

  • team/code-review
  • team/pr-template
  • team/security-check

## よくある課題と対策

### 課題：人によってスキルのバージョンが違う

**対策**：
- 定期的に`git pull`するルールを作る
- Slackなどでスキル更新を通知
- CIでスキルバージョンをチェック（advanced）

### 課題：スキルが増えすぎて管理できない

**対策**：
- 使われていないスキルを定期的に棚卸し
- カテゴリ別にディレクトリを分ける
- 必須スキルとオプショナルスキルを分類

team-skills/ ├── core/ # 全員必須 │ ├── code-review/ │ └── pr-template/ ├── frontend/ # フロントエンドチーム用 │ └── component-review/ └── backend/ # バックエンドチーム用 └── api-review/


### 課題：スキルの品質がバラバラ

**対策**：
- スキル作成ガイドラインを作る
- PRでレビュー必須にする
- テンプレートを用意する

## Claude Coworkの活用

2026年1月にリリースされたClaude Coworkを使えば、チームでのスキル管理がさらに簡単になります。

- チーム単位でスキルを管理
- 権限設定でスキルの編集者を制限
- 使用状況の分析

詳細は今後の記事で紹介予定です。

## まとめ

チームでAgent Skillsを共有することで、ワークフローを標準化できます。

1. **小規模チーム**：プロジェクトリポジトリに含める
2. **複数プロジェクト**：スキル専用リポジトリを作る
3. **厳密な管理**：Git submoduleを使う

まずは1つのスキルから始めて、チームの反応を見ながら拡大していくのがおすすめです。

[スキル一覧](/skills)で、チーム向けに使えそうなスキルを探してみてください。

## 関連記事

- [自分でスキルを作る方法](/blog/how-to-create-custom-skill) - オリジナルスキルの作り方
- [スキルのセキュリティベストプラクティス](/blog/skill-security-best-practices) - チームで安全に使う
- [CLAUDE.mdからの移行ガイド](/blog/migrating-from-claude-md) - 既存設定をスキル化
- [開発効率を上げる7つのTips](/blog/agent-skills-productivity-tips) - チームでの活用法
agent-skillsteamworkflowcollaborationtips

関連記事

Tips

Gemini CLIのgreeterスキル：カスタム挨拶スキルの作り方を学ぶ

3 分で読める

Tips

Agent Skillsで開発効率を上げる7つのTips

5 分で読める

Tips

Agent Skillsが動かない？よくある問題と解決方法

5 分で読める