殿堂入り記事

Claude Code Skills (Agent Skills) 入門【社内勉強会スライド】

2026.03.10

社内のチームメンバー(クラウド事業本部コンサルティング部)向けに 「 Claude Code Skills (Agent Skills) 勉強会 」を開催しました。
DevelopersIO向けに調整したスライドを掲載します。
スライドの内容:テキスト情報を以降に記載します。参考になれば幸いです。
 勉強会の目的勉強会の背景やゴール、アジェンダを連携します。
 背景Skills がアツいです🔥
Claude Code (AIエージェント)の動きを 自分好みにカスタマイズ できる拡張機能
手軽に作れて、手軽に共有できます
 この勉強会のゴール参加者全員が Skills をセットアップ して、基本的な使い方を理解する
普段の業務での活用方法を参加者全員で探索 する
参加者の知見やアウトプットを引き出す
 期待する成果この時間: Skills のセットアップ完了 + 基本的な使い方の理解
今後(短期): 日常業務で Skills を使った効率化を試す人が増える
今後(長期): チーム内での活用事例・ベストプラクティス・スタンダードが蓄積されていく
 スキルの概要スキルの概要とフォルダ構成を理解します。
 スキルの定義以下、公式の定義です。
エージェントに新しい機能と専門知識を与えるための、シンプルでオープンなフォーマット。
Agent Skills は、エージェントが発見して使用できる指示、スクリプト、リソースのフォルダです。 これにより、エージェントはタスクをより正確かつ効率的に実行できます。
– Overview - Agent Skills (日本語訳)
 スキルのポイントポイントは フォルダ であることです。
指示（ SKILL.md ）だけでなく、スクリプトやリファレンスもまとめて置ける
エージェントが使うべきスキルを 自動で発見 し、指示に沿って進めつつ、 フォルダ内のスクリプトやリファレンスを適宜活用してくれる
 スキルの変遷もともと Anthropic が Claude Code 向けに開発した仕組みです。
Anthropic がオープン標準としてリリース
現在は Claude Code 以外のエージェント製品にも採用が広がっている
エコシステム全体からの貢献を受け付けている
つまり、Claude Code 専用の仕組みではなく エージェント共通のスキルフォーマット になりつつあります。
 スキルのフォルダ構成スキルのフォルダ構成は以下のようなものです。
my-skill/
├── SKILL.md          # 必須: 指示 + メタデータ
├── scripts/          # 任意: スクリプト
├── references/       # 任意: リファレンス
└── assets/           # 任意: テンプレートやリソース
SKILL.md のみ必須です。 (= SKILL.md だけでもOK )
 スキルのデモ ※社外向けにアレンジ済みドキュメントテンプレート集スキル※ を例に、自動発火を見てみます。
!※チーム向けのドキュメントテンプレート集スキルです。

「手順書を書いて」等の依頼で自動発火するよう設定されています。
 入力: 雑なメモrough-notes.md
# S3バケット作る

- マネコンからやる
- バケット名はプロジェクト名-env-用途 みたいにする
- リージョンは東京
- パブリックアクセスは全ブロック
- バージョニングは有効にしとく
...
 Claude Code に依頼Claude Code への入力
> rough-notes.md を手順書にして
 何が起きるかSKILL.md の description 基準でスキル発火
SKILL.md 本文を読み込み
リファレンスにあるテンプレートファイルを読み込み
テンプレートに沿った手順書を生成
 参考: スキルのフォルダ構成.claude/skills/doc-templates/
├── SKILL.md
└── templates/
    ├── how-to/
    │   ├── README.md
    │   └── template.md
    ├── concept/
    ├── troubleshooting/
    └── ...
 スキルの仕様デモで見た挙動を、改めて仕組みの面から見ていきます。
 SKILL.md の中身SKILL.md
---
name: my-skill
description: このスキルの説明。Claudeがいつ使うべきかも書く。
---

# ここに自然言語で指示を書く
先頭のフロントマターに name (スキル名) と description (いつ使うか) を書きます。 本文には Markdown で自由に指示を書きます。
 スキルの動作スキルは 段階的な情報開示 (Progressive Disclosure) で動きます。
まず全スキルの name / description だけを確認（軽量）
関連ありと判断したスキルの SKILL.md 本文をロード
必要に応じて references/ 等の追加ファイルを読み込み
全スキルを最初から読み込むのではなく 必要なときに必要なものだけ 読みます。 コンテキストウィンドウを圧迫しないのがポイントです。
 補足: スキルの置き場所ユーザースコープとプロジェクトスコープがあります。


スコープ
パス


ユーザー
~/.claude/skills/<skill-name>/SKILL.md

プロジェクト
.claude/skills/<skill-name>/SKILL.md

 補足: スラッシュコマンドとの関係もともと Claude Code には /command : スラッシュコマンドがありました。 .claude/commands/<name>.md に Markdown で指示を書く仕組みです。
スラッシュコマンドの 実態はスキル です (そうなりました) 。


出典: https://code.claude.com/docs/ja/skills (2026-03-10 時点)
 スキル活用のTipsスキルを作る・育てるときに役立つポイントを紹介します。
 SKILL.md は 500 行以下に保つSKILL.md はスキルの エントリーポイント です。 概要やナビゲーションとしましょう。 詳細は references/ 等に分割します。
my-skill/
├── SKILL.md          # 概要 + ナビゲーション
├── references/       # 詳細リファレンス
├── examples.md       # 使用例
└── scripts/
    └── helper.sh
 context: fork でサブエージェント実行frontmatter に context: fork を付けると、スキルがサブエージェントとして隔離実行されます。
メインの会話コンテキストを汚しません。
context:fork 活用例
SKILL.md（context:fork の例）
---
name: deep-research
description: Research a topic thoroughly
context: fork
agent: Explore
---

Research $ARGUMENTS thoroughly:
1. Find relevant files using Glob and Grep
2. Read and analyze the code
3. Summarize findings with specific file references
出典: code.claude - スキルをサブエージェントで実行する
Tips: サブエージェントとは？
特定のタスクを処理する特化した AI アシスタント。 独自のコンテキストウィンドウ で実行され、メインの会話履歴にはアクセスしない。 完了後、結果だけがメイン会話に返される。
— Sub-agents - Claude Code 公式ドキュメント
 スキルが発火しないときdescription を見直しましょう。Claude が「いつ使うべきか」を判断できる記述になっていますか？
それでもうまく行かない場合、最終手段は 手動実行 です。
/skill-name でスラッシュコマンドとして直接実行
例: /fix-issue 123
 セキュリティに注意スキルの入手元は信頼できるソースに限定しましょう。
自作 のスキル
社内 で管理・レビューされたスキル
信頼できる公開スキル（例: anthropics/skills）
第三者のスキルを使う場合は スキルの中身をすべて確認 してください（SKILL.md、スクリプト、リファレンス等）。 判断できない場合は使わない。
https://zenn.dev/nuits_jp/articles/2026-01-19-risks-of-skills-marketplace
 スキルを作るスキル公式の skill-creator を導入すると、スキルの作成・改善を対話的に進められます。
> /skill-creator
⏺ スキルクリエイターへようこそ！
  1. 新しいスキルを作成したい
  2. 既存のスキルを改善したい
  3. スキルのテスト・評価を実行したい
  4. スキルの説明文（トリガー）を最適化したい
 他の仕組みとの使い分けSkills は CLAUDE.md や MCP、サブエージェントとの使い分けは以下動画が参考になります。
Claude Agent Skills Explained - YouTube
Skills vs CLAUDE.md



Skills
CLAUDE.md


役割
専門的なタスクの 「実行方法」 を教える
プロジェクト固有の情報 をClaudeに伝える

スコープ
どのプロジェクトでも使えるポータブルな専門知識
特定リポジトリに紐づく（技術スタック、規約等）

Skills vs MCP Servers



Skills
MCP Servers


役割
データを 「どう扱うべきか」 を教える
外部データソースへの 「接続」 を提供

例
クエリ最適化パターンを教える
GitHubやDBへのアクセスを可能にする

Skills vs Subagents



Skills
Subagents


性質
ポータブルな専門知識
独自コンテキストを持つ 特化型AIアシスタント

特徴
どのエージェントでも使用可能
固定の役割（FE開発者、UIレビュアー等）

 ハンズオン ※社外向けにアレンジ済み実際にスキルを使って提案書を作成してみます。
 事前準備Claude Code がインストール済みであることを前提とします。
ハンズオンでは proposal-creation-toolkit プラグインを使います。 事前にチーム向けに共有しているマーケットプレイスの登録と プラグインのインストールをお願いします。
スライド生成(marp-cli) の準備は任意です。
マーケットプレイス登録 + プラグイン導入
Claude Code で /plugin を実行
"Marketplace → Add marketplace" を選択
（事前に共有したマーケットプレイスURL）を入力
プラグイン一覧から "提案書作成ツールキット" を選択してインストール
(任意) marp-cli の準備
Marp スライド生成まで体験する場合は marp-cli も実行できるようにしてください。
# pnpm dlx: パッケージを一時的にダウンロードして実行（npx 相当）
pnpm dlx @marp-team/marp-cli --version
 ハンズオン概要proposal-creation-toolkit プラグインで 議事録から提案書を自動生成 します。
議事録 (meeting-memo.md)
    ↓  /create-proposal       ← 全員
提案書マークダウン
    ↓  /marp-from-proposal    ← optional
Marp スライド (.md) + 画像
    ↓  marp-cli
プレゼンテーション (HTML)
 ハンズオン手順Step 1: リポジトリをクローンして開く
ハンズオン用リポジトリをクローンし、Claude Code で開きます。
git clone <ハンズオン用リポジトリURL>
cd handson-repo
claude
ファイル構成:
handson-repo/
├── meeting-memo.md      ← 議事録（サンプル）
└── themes/
    └── custom.css       ← Marp テーマ
ハンズオンでの推奨: モデルを Default (Sonnet) に設定すると応答が速くなります。
/model → 1. Default (recommended) を選択
Step 2: 提案書を生成する
Claude Code で以下を入力します。
/create-proposal @meeting-memo.md
Step 3: ヒアリングに回答する
Claude が 選択肢形式で質問します。番号で回答してください。
Step 4: 構成案を確認・承認する
Claude が目次案を提示します。内容を確認し「はい」と回答すると生成が始まります。
生成されるファイル:
proposal.md    ← 提案書マークダウン
(任意) Step 5: Marp スライドを生成する
/marp-from-proposal @proposal.md
生成されるファイル:
proposal_marp.md   ← Marp スライド
images/                            ← 図（自動生成）
※パブリックな公開資料としては、以下を参考ください
Claude CodeとNano Banana Proで議事録から提案書スライドを自動生成してみた | DevelopersIO
(任意) Step 6: プレビューする
marp-cli でスライドを HTML 出力して確認します。
pnpm dlx @marp-team/marp-cli proposal_marp.md --theme themes/custom.css

# PDF出力する場合
pnpm dlx @marp-team/marp-cli proposal_marp.md --theme themes/custom.css --pdf
 (時間が余った人向け) Skill Creator を試す時間が余った方は、公式の skill-creator を試してみましょう。 スキルの作成・改善を対話的に進められます。
/plugin → Discover タブで skill-creator を検索してインストール:


/plugin → Discover にて skill-creator を検索
インストール後:
/skill-creator
普段の業務で効率化したい作業があれば、スキル化できないか試してみてください。
 おわりに以下、今回話したことです。
スキルの概要 : 定義・フォルダ構成
スキルのデモ : カスタムスキルの自動発火体験
スキルの仕様 : SKILL.md・段階的情報開示
スキル活用のTips : 他の仕組み（CLAUDE.md / MCP / Subagents）との使い分け
ハンズオン : proposal-creation-toolkit で議事録→提案書→スライド生成
 参考リンクSkills - Claude Code Docs
Overview - Agent Skills
What are Skills? - Claude Support

スコープ	パス
ユーザー	`~/.claude/skills/<skill-name>/SKILL.md`
プロジェクト	`.claude/skills/<skill-name>/SKILL.md`

	Skills	CLAUDE.md
役割	専門的なタスクの「実行方法」を教える	プロジェクト固有の情報をClaudeに伝える
スコープ	どのプロジェクトでも使えるポータブルな専門知識	特定リポジトリに紐づく（技術スタック、規約等）

	Skills	MCP Servers
役割	データを「どう扱うべきか」を教える	外部データソースへの「接続」を提供
例	クエリ最適化パターンを教える	GitHubやDBへのアクセスを可能にする

	Skills	Subagents
性質	ポータブルな専門知識	独自コンテキストを持つ特化型AIアシスタント
特徴	どのエージェントでも使用可能	固定の役割（FE開発者、UIレビュアー等）

勉強会の目的

背景

この勉強会のゴール

期待する成果

スキルの概要

スキルの定義

スキルのポイント

スキルの変遷

スキルのフォルダ構成

スキルのデモ ※社外向けにアレンジ済み

入力: 雑なメモ

Claude Code に依頼

何が起きるか

参考: スキルのフォルダ構成

スキルの仕様

SKILL.md の中身

スキルの動作

補足: スキルの置き場所

補足: スラッシュコマンドとの関係

スキル活用のTips

SKILL.md は 500 行以下に保つ

context: fork でサブエージェント実行

スキルが発火しないとき

セキュリティに注意

スキルを作るスキル

他の仕組みとの使い分け

ハンズオン ※社外向けにアレンジ済み

事前準備

ハンズオン概要

ハンズオン手順

(時間が余った人向け) Skill Creator を試す

おわりに

参考リンク

Claudeならクラスメソッドにお任せください

関連記事

EVENTS

`context: fork` でサブエージェント実行