🎯 Claude Skills

Equip Claude with task-specific expertise — Concept and integration overview

📚 Claude Skillsとは何か

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

📦

専門知識のパッケージ化

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

🤖

自動的な読み込み

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

🔄

再利用可能

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

⚡

実行可能コード対応

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

🆚 従来のアプローチ vs Skills

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

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

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

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

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

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

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

🔄 動作フロー: Progressive Disclosure

L1Frontmatter

name + description は常にロードされ、起動判定に使用

→

L2SKILL.md Body

Claudeが関連性ありと判断した時にSKILL.md本文を読み込み

→

L3Linked Files

scripts/, references/, assets/ は必要時のみロード

💡 Progressive Disclosure（段階的開示）— 3 Levels

Claudeは3段階でSkill情報をロードする。L1（フロントマター）は常時読み込まれ起動判定に使われ、L2（SKILL.md本文）は関連時のみ、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スクリプト - データ処理用
📊 サンプルデータ - テンプレート
📸 画像・アセット - ブランド素材
📝 設定ファイル - 環境設定
📚 ドキュメント - 参照資料

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

🎯 Core Design Principles

⚠️ Critical Principle: Script Deterministic Processing

AI is smart, but may return slightly different results for the same input each time.
Processing that requires 100% identical results (character counting, syntax checking, file conversion, etc.)
should be implemented as scripts in scripts/, not as text instructions in SKILL.md.

❌ Text Instructions (Variable)

 ## Character Count Check
 Count the article characters and
 verify 2000-3000 range 

→ Calculation method may vary slightly each time

✅ Scripted (Deterministic)

 ## Character Count Check
 Run `python scripts/check_article.py` 

→ Guarantees 100% same result every time

Processing Type	Should Script?	Reason
Character/line counting	✅ Required	Same result needed every time
Syntax/format checking	✅ Required	Detect all items without omission
File conversion	✅ Recommended	Output format consistency
Text editing/review	❌ Not needed	AI judgment appropriate
Design/structure evaluation	❌ Not needed	Context understanding required

📖 Detailed design patterns and practical script implementations will be covered in a separate article.

🚀 Integration Paths by Product

💻

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機能をサポート。カスタムエージェント開発に対応。

🎯 Real-World Examples

The following are summaries of adoption cases officially highlighted by Anthropic. Concrete implementation patterns will be covered in the practical guide.

💼 Box統合

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

🏢 Rakuten

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

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

🚀 各製品での始め方

💻 Claude Apps

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

🔌 API開発者

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

🛠️ Claude Code

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

📚 サンプルSkill

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

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

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

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

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

🚧 Technical Constraints (Official)

🚫 XML tags (< >) are forbidden in frontmatter (system prompt injection prevention)
🚫 "claude" and "anthropic" are reserved words — cannot be used in skill names
📄 Skill file must be exactly SKILL.md (case-sensitive)
🚫 No README.md inside the skill folder

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

📄 すべてのファイルを読んで内容を理解する
🔗 コードの依存関係を確認
📦 バンドルされたリソース（画像・スクリプト）を検証
🌐 外部ネットワーク接続の指示がないか確認
⚠️ 不審な動作やデータ外部送信の可能性をチェック

推奨: 組織で使用する場合は、セキュリティレビュープロセスを確立する

🔮 今後の展開

✨ 最近のアップデートと今後

簡素化されたSkill作成ワークフロー
エンタープライズ全体へのデプロイ機能（2025年12月18日出荷済み）
組織横断でのSkill配布を容易化
チーム間での共有をより効率的に

🎯 目指す方向性

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

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

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

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

Claude Skills vs Projects — Complete Comparison Guide — Detailed comparison of Skills and Projects
Claude Code Complete Guide
Claude Overview

Reference Links: - Claude Skills Official Documentation - Skills Help Center