コンテンツにスキップ

Claude 完全ガイド

🎯 Claude Skills

タスク特化型の専門知識をClaudeに装備する仕組み ― コンセプトと導入の全体像

📚 Claude Skillsとは何か

Claudeに専門スキルを教え込む新機能

Skills = 指示書、スクリプト、リソースをまとめたフォルダ
必要な時だけClaudeが自動的に読み込み、専門家として振る舞う

🎯 Skillsの核となるコンセプト

📦

専門知識のパッケージ化

Excelの操作方法、ブランドガイドライン、社内ワークフローなどを1つのフォルダに集約

🤖

自動的な読み込み

Claudeがタスクに応じて関連するSkillを自動判定。必要な情報だけを必要な時に読み込む

🔄

再利用可能

一度作成したSkillは、Claude apps、Claude Code、APIで共通利用可能

実行可能コード対応

自然言語だけでなく、Pythonやシェルスクリプトなどの実行可能コードも含められる

🆚 従来のアプローチ vs Skills

❌ 従来: プロンプトエンジニアリング

  • 毎回同じ指示を繰り返す
  • コンテキストウィンドウを圧迫
  • チーム間で指示が統一されない
  • バージョン管理が困難
  • 大量の情報を詰め込めない

「また同じこと説明するのか...」

✅ Skills: 構造化された専門知識

  • 一度作れば自動的に使われる
  • 必要な部分だけ読み込み
  • 組織全体で統一された動作
  • Gitなどで管理可能
  • 大容量の情報を格納可能(SKILL.mdは5,000語以内推奨、アップロードは8MB上限)

「一度教えれば、ずっと使える」

💡 Skillsは「新入社員へのオンボーディング資料」のようなもの
手順書を渡せば、あとは自律的に仕事をこなしてくれる

⚙️ Skillsの仕組みと4つの特徴

🔄 Progressive Disclosure(段階的開示)の3レベル

L1フロントマター

name と description のみ常時ロード。Claudeが発動判断に使う

L2SKILL.md本文

タスクに関連すると判断された場合のみ、本文の指示を読み込む

L3リンクファイル

scripts/ references/ assets/ 等の追加ファイルを必要時にのみ参照

💡 なぜ3レベルなのか

最初は概要(L1)だけを見せ、必要になった時点で詳細(L2→L3)を段階的に読み込む仕組み。
これにより、大量のSkillがあっても処理速度を保ち、コストも抑えられる。

✨ Skillsの4つの強力な特徴

🧩

Composable

複数のSkillを組み合わせ可能

ブランドガイドライン + 財務レポート + プレゼン作成 = 投資家向け資料を自動生成

🔄

Portable

どこでも同じ形式で動作

Claude apps、Claude Code、APIで共通のSkillを使用。一度作れば全環境で利用可能

Efficient

必要な部分だけ読み込み

巨大なSkillでも関連部分だけをロード。速度とコストを最適化

💪

Powerful

実行可能コードを含められる

ソートやデータ処理など、プログラムで実行した方が効率的なタスクに対応

📁 Skillの構造

📄 SKILL.md ファイル

---
name: pdf-form-filler
description: Fill PDF forms programmatically.
Use when user asks to "fill PDF" or "populate form fields".
---

# Instructions
Use pypdf library to...

# Examples
...

YAMLフロントマター(名前・説明)+ 本文(詳細な指示)

📦 追加リソース

  • 🐍 Pythonスクリプト - データ処理用
  • 📊 サンプルデータ - テンプレート
  • 📸 画像・アセット - ブランド素材
  • 📝 設定ファイル - 環境設定
  • 📚 ドキュメント - 参照資料

必要に応じてフォルダ内に配置可能

🎯 設計の基本原則

⚠️ 最重要原則: 決定論的処理はスクリプト化

AIは賢いですが、同じ入力でも毎回微妙に異なる結果を返す可能性があります。
100%同じ結果が必要な処理(文字数カウント、構文チェック、ファイル変換など)は、
SKILL.mdのテキスト指示ではなく scripts/ にスクリプトとして実装してください。

❌ テキスト指示(揺らぎあり)

## 文字数チェック
記事の文字数を数えて、
2000-3000文字の範囲か確認

→ 毎回計算方法が微妙に異なる可能性

✅ スクリプト化(決定論的)

## 文字数チェック
`python scripts/check_article.py`
を実行

→ 毎回100%同じ結果を保証

処理タイプスクリプト化理由
文字数・行数カウント✅ 必須毎回同じ結果が必要
構文・フォーマットチェック✅ 必須漏れなく全項目を検出
ファイル変換✅ 推奨出力形式の一貫性
文章推敲・レビュー❌ 不要AI判断が適切
設計・構成の評価❌ 不要文脈理解が必要
📖 詳細な設計パターンや実践的なスクリプト実装については別記事で解説予定。

🚀 製品別の導入経路

Claude apps、API、Claude Code - すべてでSkillsが使える
💻
Claude Apps
対象: Pro、Max、Team、Enterprise

機能

  • ドキュメント作成用Skill標準装備
  • カスタムSkillの作成可能
  • 自動的に関連Skillを呼び出し
  • 思考プロセスでSkillの使用を表示

作成方法

「skill-creator」Skillを使えば対話形式で作成。ファイル構造の生成からSKILL.mdのフォーマットまで自動化。

⚙️ 設定で有効化が必要(Team/EnterpriseはAdmin権限要)
🔌
Claude API
対象: 開発者・エンタープライズ

機能

  • Messages APIリクエストにSkill追加
  • /v1/skills エンドポイントで管理
  • カスタムSkillのバージョン管理
  • プログラマティックな制御

標準Skill

  • 📊 Excel(数式対応)
  • 📄 Word文書
  • 📽️ PowerPointプレゼン
  • 📝 入力可能PDF
🧪 Code Execution Tool(Beta)が必要
🛠️
Claude Code
対象: 開発チーム

機能

  • anthropics/skills 公開リポジトリからダウンロード
  • ~/.claude/skills に手動配置
  • 自動的に関連時にロード
  • バージョン管理でチーム共有

手動インストール

~/.claude/skills に配置

Claude Agent SDKでも同じAgent Skills機能をサポート。カスタムエージェント開発に対応。

🎯 実際の使用例

以下はAnthropicが公式に紹介している導入事例の概要。具体的な実装パターンは実践編で扱う。

💼 Box統合

BoxのコンテンツをPowerPoint、Excel、Wordに変換。組織標準に従ったドキュメントを自動生成し、作業時間を大幅削減。

🏢 Rakuten

管理会計と財務ワークフローの合理化。複数部門にまたがる手作業を自動化し、業務効率を向上。

💡 始め方とセキュリティ注意点

🚀 各製品での始め方

💻 Claude Apps

→ ユーザーガイド & ヘルプセンター
設定画面からSkillsを有効化。skill-creatorを使って対話形式で作成可能。

🔌 API開発者

→ ドキュメント & Anthropic Academy
Messages APIとCode Execution Toolを組み合わせて使用。Claude Consoleでバージョン管理。

🛠️ Claude Code

→ ドキュメント
anthropics/skills公開リポジトリからダウンロード。または手動で ~/.claude/skills に配置。

📚 サンプルSkill

→ GitHubリポジトリ
anthropics/skills に多数のサンプルあり。カスタマイズして使用可能。

⚠️ 重要なセキュリティ注意点

🔐 Skillsはコード実行権限を持つ

Skillsは強力な機能だが、それは同時にClaudeにコード実行権限を与えることを意味する。

信頼できるソースからのみSkillをインストールすること

🚫 技術的な制約(公式ガイド準拠)

  • フロントマターに XMLタグ(< >)は禁止(system promptインジェクション防止)
  • スキル名に 「claude」「anthropic」は使用不可(予約語)
  • ファイル名は SKILL.md(大文字小文字完全一致) のみ有効
  • スキルフォルダ内に README.mdを置かない(SKILL.mdまたはreferences/に格納)

🔍 信頼性の低いSkillのチェック項目

  • 📄 すべてのファイルを読んで内容を理解する
  • 🔗 コードの依存関係を確認
  • 📦 バンドルされたリソース(画像・スクリプト)を検証
  • 🌐 外部ネットワーク接続の指示がないか確認
  • ⚠️ 不審な動作やデータ外部送信の可能性をチェック
推奨: 組織で使用する場合は、セキュリティレビュープロセスを確立する

🔮 今後の展開

✨ 提供済み・進行中の機能

  • 簡素化されたSkill作成ワークフロー
  • ✅ エンタープライズ全体へのデプロイ機能(2025年12月18日 提供開始)
  • 組織横断でのSkill配布の容易化
  • チーム間での共有の効率化

🎯 目指す方向性

誰でも(技術者でなくても)簡単にSkillを作成し、組織全体で活用できる環境を構築。

AIが組織の知識を学習し、全員の生産性を向上させる未来へ。

🎉 Skillsの本質 AIに専門知識を装備し、組織特有のワークフローを学習させる。
一度作れば、チーム全体が一貫した高品質の成果物を生成可能に。

「新入社員へのオンボーディング」→「AIへのオンボーディング」

関連記事


参考リンク: - Claude Skills公式ドキュメント - Skills Help Center