Anthropic Skills：SKILL.md と Claude Code 連携

Agent Skills 標準との関係

anthropics/skills の README 冒頭 Note は、本リポジトリが Anthropic 実装の skills を含み、Agent Skills 標準は agentskills.io を参照すると述べています。Skills は命令、スクリプト、リソースをまとめたフォルダで、Claude が専門タスク向けに動的読み込みする単位だと README は定義しています。会社のブランドガイドライン付き文書作成、組織固有のデータ分析手順、個人タスクの自動化が用途例として挙げられています。

About This Repository 節では、創作（アート、音楽、デザイン）から技術（Web アプリテスト、MCP サーバー生成）、エンタープライズワークフローまでの例が ./skills にあり、各スキルは SKILL.md を含む独立フォルダに収められていると説明されています。Disclaimer はデモ・教育目的のみで、Claude 本体の挙動と異なる場合があると警告しています。support 記事3本へのリンクも README 上部にあります。Equipping agents for the real world with Agent Skills エンジニアリング記事へのリンクも同じ節付近に載っています。

Skill Sets と spec/template

README の Skill Sets は ./skills（Creative & Design、Development & Technical、Enterprise & Communication、Document Skills）、./spec（Agent Skills 仕様）、./template（スキルテンプレート）の3入口です。Creating a Basic Skill 節では template-skill を起点に SKILL.md を作り、YAML frontmatter に name（小文字、ハイフン区切り）と description（何をいつ使うか）の2フィールドが必須と説明しています。

Markdown 本文には手順、Examples、Guidelines を書く形式例が README に載っています。多くのスキルは Apache 2.0 オープンソースですが、skills/docx、pdf、pptx、xlsx は Claude の文書機能を支える source-available 実装で、オープンソースではないが本番利用の参照として開発者と共有されていると README は説明しています。

Claude Code プラグイン導線

Claude Code 節では /plugin marketplace add anthropics/skills でマーケットプレイス登録し、Browse and install plugins → anthropic-agent-skills → document-skills または example-skills → Install now の手順があります。直接インストールは /plugin install document-skills@anthropic-agent-skills または /plugin install example-skills@anthropic-agent-skills です。

インストール後はスキル名を会話で指定するだけで利用でき、README 例では PDF スキルで path/to/some-file.pdf のフォームフィールドを抽出する指示が示されています。評価では marketplace 登録後、/plugin 一覧に anthropic-agent-skills が現れるか、テスト PDF で期待フィールドが返るかを確認します。

Claude.ai と Claude API

Claude.ai 節は、example skills が有料プランで既に利用可能で、リポジトリから任意スキルをアップロードする手順は Using skills in Claude 記事を参照すると README にあります。アップロード UI の具体手順は README 外です。Claude API 節は Anthropic 提供の pre-built skills と custom skills upload を Skills API Quickstart で説明するとリンクしています。

README は skills.sh/anthropics/skills バッジも示しています。API 利用時はスキル ID、バージョン、実行権限を docs.claude.com の skills-guide で確認する必要があり、リポジトリ README だけでは API キー設定や課金条件は説明されていません。エンジニアリング記事 Equipping agents for the real world with Agent Skills へのリンクも README 上部にあります。

document-skills の4フォルダ

skills/docx、skills/pdf、skills/pptx、skills/xlsx は Claude のファイル作成・編集機能を支える参照実装です。README は source-available で open source ではないと明記し、本番 AI アプリで使われる複雑なスキルのパターン学習用だと述べています。各フォルダの SKILL.md と同梱 scripts/ の入出力形式はフォルダごとに異なるため、採用前に対象 SKILL.md 全文を読む必要があります。

評価では document-skills プラグインインストール後、小さな PDF や DOCX を入力にフォームフィールド抽出や編集を試し、出力ファイルの構造とエラー時のログを記録します。Apache 2.0 スキルと source-available スキルで再配布条件が異なる点も各フォルダ LICENSE で確認します。pptx/xlsx スキルはスライド表計算の編集パターン参照用です。

Partner Skills と開発パターン

Partner Skills 節は、特定ソフトウェア向けスキルを Claude に教える用途を示し、Notion Skills for Claude へのリンクを例として挙げています。./skills 内の Development & Technical カテゴリには MCP サーバー生成や Web アプリテスト関連スキルも README が触れています。既存スキルを読んで自作スキルの設計パターンを学ぶ用途も About 節が述べています。./spec フォルダで Agent Skills 標準のフィールド定義も確認できます。

自作スキルでは template/ の SKILL.md をコピーし、name/description をユニークに設定、scripts/ に副作用のあるコマンドを置く場合はパスと引数を SKILL.md に明示します。Disclaimer は critical tasks 前に thorough test を求めています。frontmatter の description は when to use を含む完全な説明が README 要件です。

support 記事3本と ./spec

README 上部は What are skills?、Using skills in Claude、How to create custom skills の3 support 記事へリンクしています。Skill Sets の ./spec は Agent Skills 仕様本体で、agentskills.io と対応します。Claude Code、Claude.ai、API の3利用経路は README Try in Claude Code, Claude.ai, and the API 見出し下に並び、経路ごとにインストールコマンドが異なります。

Python 言語分類のリポジトリメタデータと README 取得時点の star/fork/issue 数は採用判断の補助情報であり、スキル品質や SLA の保証ではありません。Claude 本体の document capabilities ニュース記事も README が参照し、docx/pdf/pptx/xlsx スキルがその実装参照だと位置付けています。template/ を fork して社内ブランド用スキルを作る場合も frontmatter の name/description 要件は同じです。

評価手順：marketplace から PDF スキル

導入確認の具体手順は README Claude Code 節に沿います。Claude Code を起動し /plugin marketplace add anthropics/skills を実行、Browse and install plugins から anthropic-agent-skills を選び document-skills を Install now します。代替として /plugin install document-skills@anthropic-agent-skills を直接実行できます。

その後、Use the PDF skill to extract the form fields from と README 例にある形式で小さな PDF を指定し、フィールド一覧が返るか記録します。example-skills 側は Creative & Design 等のサンプルを試し、SKILL.md の name が会話内 mention と一致するか確認します。source-available フォルダを再配布する場合は LICENSE 条項を先に読みます。Claude API 経路では skills-guide の creating-a-skill 手順で custom skill を upload し、同じ SKILL.md を API と Claude Code で挙動差がないか比較するのも README Disclaimer が示す thorough test に沿います。

編集部の結論

Claude Code や Claude API でカスタムスキルの書き方を学び、PDF/DOCX 等の document-skills を参照したい開発者向けです。/plugin marketplace add anthropics/skills の後、/plugin install document-skills@anthropic-agent-skills を試し、対象 SKILL.md の name/description と scripts/ の副作用を小さな入力で確認してから本番データへ適用してください。

公式情報源

1. Official README
2. Project repository