Claudeのスキルとは？SKILL.mdの書き方と書類手順のスキル化

Claudeのスキル（Skills、Agent Skills）とは、作業の手順・ルール・参考資料・ひな形を1つのフォルダにまとめ、Claudeが必要なときに呼び出して使う仕組みです。フォルダの中心は「SKILL.md」というテキストファイルで、名前・説明・手順を書きます。Claudeは説明文を見て「今の依頼に使える」と判断すると、そのスキルの中身を読み込んで作業します。

スキルは、ブラウザやアプリのClaude、Claude Code、開発者向けのAPIで使えると公式に案内されています（2026年10月1日確認）。建設会社なら「施工計画書の下書き」「安全書類の提出前チェック」のように、担当者の頭の中にある手順を会社の資産として残せるのが大きな利点です。

この記事では、スキルの仕組みとSKILL.mdの書き方を公式情報で整理します。そのうえで、2つの書類業務をスキル化したSKILL.mdの記入例と、CLAUDE.md・プロジェクト・スキルの使い分け表を紹介します。

Claudeのスキルとは｜手順を「呼び出せる部品」にする仕組み

Anthropic社の公式ドキュメントでは、スキルは「指示、メタデータ（名前や説明）、必要に応じてスクリプトやテンプレートをまとめたもので、関連するときにClaudeが自動で使う」と説明されています。プロンプトを毎回貼り付ける代わりに、手順をフォルダとして保存しておくイメージです。

必要なときだけ読み込まれる「段階的な読み込み」

スキルの特徴は、中身を一度に全部読み込まない点です。公式ドキュメントでは、次の3段階で読み込まれると説明されています。

※トークンはAIが文章を処理する単位です。2026年10月1日時点の公式ドキュメントの記載で、目安として示されているものです。

そのため、様式の記載例や用語集のような長い資料をスキルに入れても、使わない作業では負担になりません。社内の書類ごとにスキルを用意しても、普段の会話を邪魔しにくい作りです。

SKILL.mdの構成｜名前・説明・手順の書き方

スキルは1つのフォルダです。必須なのはSKILL.mdだけで、ひな形や記載例は別ファイルとして同じフォルダに入れられます。

• sekou-keikaku-draft/（スキルのフォルダ）
• 　SKILL.md（必須：名前・説明・手順）
• 　kisai-koumoku.md（任意：記載項目の一覧）
• 　kisai-rei.md（任意：自社の過去の記載例）

SKILL.mdの冒頭には、「—」で囲んだ設定欄（フロントマター）を書きます。主な項目は次のとおりです。

※Claude Codeでは name を省略するとフォルダ名が使われます。項目と上限は2026年10月1日時点の公式ドキュメントで確認したもので、変わる可能性があります。

説明文（description）が一番大事

Claudeは、説明文を読んでスキルを使うかどうかを決めます。「施工計画書のスキル」のような短い説明では、いつ使えばよいか伝わりません。公式ドキュメントは、主な使いどころを説明の最初に書き、利用者が実際に使いそうな言葉を入れるよう勧めています。名前は英字の決まりがあるため、日本語の言い回しは説明文に入れます。

本文はSKILL.mdで500行未満が目安とされています。詳しい資料は別ファイルに分け、本文から「記載例は kisai-rei.md を見る」と参照します。

スキルはどこで使える？Claudeアプリ・Claude Code・API

スキルは使う場所によって、登録方法と共有のしかたが違います（2026年10月1日、公式ヘルプとドキュメントで確認）。

公式のAgent Skills概要では、登録したスキルは使う場所の間で自動では同期されないとされています。一方で、Claude Codeのドキュメントには、claude.aiで有効にしたスキルを一部の環境で同期する仕組みも記載されています。どこで使うかを先に決め、その場所に登録するのが確実です。

あわせて、Anthropic社は2025年12月18日に、スキルを「Agent Skills」というオープンな仕様として公開したと発表しています。Word・Excel・PowerPoint・PDFを扱う既製のスキルも用意されています。

CLAUDE.md・プロジェクト・スキルの使い分け

Claudeに自社のルールを覚えさせる方法は、スキルのほかにもあります。それぞれ得意なことが違うため、組み合わせて使います。

CLAUDE.mdの書き方はCLAUDE.mdとは？書き方と建設会社の記入例で解説しています。目安は「全作業の前提＝CLAUDE.md」「案件ごとの資料＝プロジェクト」「繰り返す手順＝スキル」です。

書類作成の手順をスキル化する例｜SKILL.md記入例2つ

ここでは、建設会社でよくある2つの業務をスキルにした記入例を紹介します。※いずれも説明用の例です。記載項目や確認項目は、発注者・元請の指定と自社の様式に合わせて書き換えてください。

例1：施工計画書の下書き

施工計画書は、発注者の仕様書や地方整備局の要領で記載項目が決まっている書類です（書き方は施工計画書とは？で解説しています）。スキルには「項目の順番」「材料の集め方」「書いてはいけないこと」を入れます。

---
name: sekou-keikaku-draft
description: 施工計画書の下書きを、特記仕様書・工程表・過去の施工計画書から作る。「施工計画書を作って」「施工計画書のたたき台」「計画書の下書き」と頼まれたときに使う。
---

# 施工計画書の下書き

## 最初に確認すること（不足があれば作業を止めて質問する）
1. 工事名・工期・発注者名
2. 発注者が指定する記載項目と様式（特記仕様書または要領）
3. 使ってよい過去の施工計画書（同種工事）

## 手順
1. 記載項目の順番は、発注者の指定を最優先にする
   指定がなければ kisai-koumoku.md の社内標準の順番を使う
2. 項目ごとに、材料（特記仕様書・工程表・過去の計画書）から該当部分を抜き出す
3. 自社の書き方は kisai-rei.md の記載例に合わせる
4. 下書きを Word（.docx）で 90_AI下書き/ に保存する

## 書いてはいけないこと
- 材料にない数量・工法・使用機械・人員を推測で書かない。【要確認】と書く
- 安全対策の十分さ、法令への適合を判断する表現を書かない
- 過去の計画書の工事名・数量を残したままにしない

## 最後に報告すること
- 項目ごとの材料の出どころ（ファイル名とページ）
- 【要確認】の一覧
- 発注者の指定項目のうち、材料が見つからなかった項目

例2：安全書類の提出前チェック

安全書類（グリーンファイル）は、元請ごとに様式や提出物が違います（全体像はグリーンファイルとは？）。チェックは「直す」のではなく「指摘を一覧にする」スキルにしておくと安全です。

---
name: anzen-shorui-check
description: 元請へ提出する安全書類（作業員名簿、再下請負通知書、施工体制台帳の添付書類など）の記入漏れ・不整合・期限切れを、提出前に点検して一覧にする。「安全書類をチェックして」「グリーンファイルの提出前確認」と頼まれたときに使う。
---

# 安全書類の提出前チェック

## ルール
- ファイルは読むだけ。修正しない。指摘を一覧にするだけ
- 元請ごとの提出物と様式は motouke-betsu.md を見る
- 健康診断の結果など、配慮が必要な個人情報は一覧に写さない

## 点検項目
1. 空欄：必須欄が空いていないか
2. 不整合：同じ人・同じ会社の情報が書類ごとに違っていないか
   （氏名の表記、生年月日、事業所名、許可番号）
3. 期限：資格証・保険・許可の有効期限が、提出日から30日以内か切れていないか
4. 日付：作成日・提出日・入場予定日の前後関係がおかしくないか
5. 版：様式の版が、元請の指定と合っているか

## 出力
- Excel（.xlsx）で「書類名｜該当箇所｜指摘の種類｜内容｜根拠」の表にする
- 判断できないものは「人が確認」と書く。合否は判定しない

2つの例とも、「推測しない」「判断しない」「出どころを報告する」を必ず入れています。AIの出力を人が確かめやすくするためです。作業員名簿の扱いは作業員名簿の書き方も参考にしてください。

スキル化の進め方｜5ステップ

いきなりスキルを書くより、まずチャットで手順を試し、うまくいった形を保存するほうが失敗しません。

1. 対象の業務を1つ選ぶ毎月くり返し、手順がほぼ決まっている書類を選びます。施工計画書の下書き、提出前チェック、週報などが候補です。
2. ベテランの手順を書き出す担当者に「どの資料を見て、どの順に、何に気をつけて作るか」を聞き取り、箇条書きにします。
3. チャットで2〜3回試す書き出した手順をプロンプトとして使い、出力のずれを直します。直した点がスキルの「ルール」になります。
4. SKILL.mdにまとめて登録する説明文に使いどころを書き、本文に手順とルールを入れます。長い記載例は別ファイルにします。
5. 使った人の指摘で育てる出力の誤りや追加したいルールを集め、管理者が月1回SKILL.mdを直します。

スキルは指示とプログラムを含められるため、公式は「自分で作ったものか、Anthropic社から入手したものなど、信頼できる出どころのスキルだけを使う」よう注意しています。インターネットで配布されているスキルは、中身を読んでから使いましょう。社内の利用ルールはClaude Codeのセキュリティで解説しています。

AIで楽にする方法｜手順書からSKILL.mdを作るプロンプト

SKILL.mdの下書きは、AIに作らせると早く仕上がります。社内の手順メモ（個人名や単価を除いたもの）を渡します。

あなたは建設会社の業務改善担当の補助です。
次の手順メモをもとに、Claudeのスキル（SKILL.md）の下書きを作ってください。

【業務名】：【週報の作成】
【使う人】：【工務課の事務担当】
【手順メモ】：
【1. 各現場の日報（Excel）を10_日報フォルダから集める
 2. 工事ごとに人工と主な作業を集計する
 3. 社内様式の週報に転記する
 4. 特記事項（事故・ヒヤリハット・発注者からの指示）を拾う】

条件：
・冒頭に --- で囲んだ name と description を書く
・name は英小文字・数字・ハイフンだけで64文字以内。claude や anthropic を含めない
・description には「何をするか」と「どんな頼まれ方のときに使うか」を両方書く
・本文は「最初に確認すること」「手順」「書いてはいけないこと」「最後に報告すること」の4見出し
・メモにないルールは足さない。足したほうがよいものは最後に「追加候補」として挙げる

---
name: shuho-create
description: 現場の日報（Excel）から、工事ごとの人工と主な作業を集計し、社内様式の週報の下書きを作る。「週報を作って」「今週の日報をまとめて」と頼まれたときに使う。
---

# 週報の作成

## 最初に確認すること
1. 対象の週（開始日と終了日）
2. 対象の工事（全工事か、一部か）

## 手順
1. 10_日報/ から対象週の日報を集める
2. 工事ごとに人工と主な作業を集計する
（中略）

## 追加候補（あなたの確認待ち）
- 日報が1日分欠けているときの扱い【要確認】
- 人工の端数の扱い【要確認】

※出力は説明用のイメージです。追加候補は担当者が判断して採用してください。

作ったスキルを試験するプロンプト

スキルは「呼び出されるか」と「手順どおりに動くか」の両方を試します。Claude Codeでは次のように頼めます。

.claude/skills/anzen-shorui-check/SKILL.md を読んでください。
ファイルは変更せず、次の2点を報告してください。

1. 呼び出しの確認
   次の5つの頼み方のうち、このスキルが使われるべきものと、
   使われにくそうなものを判定し、説明文の改善案を出す
   ・安全書類をチェックして
   ・グリーンファイルの提出前に見て
   ・作業員名簿の期限切れを探して
   ・再下請負通知書を作って
   ・施工体制台帳の添付書類が揃っているか見て

2. 手順の確認
   テスト用フォルダ【テスト_安全書類】のファイルでスキルを実行し、
   指摘の一覧を 90_AI下書き/ に保存する。元のファイルは変更しない

1. 呼び出しの確認
・使われるべき：安全書類をチェック／グリーンファイルの提出前／名簿の期限切れ
・使われにくそう：施工体制台帳の添付書類（説明文に「添付書類が揃っているか」がない）
・対象外：再下請負通知書を作って（作成はこのスキルの役割ではない）
改善案：説明文に「添付書類の不足確認」を追加

2. 手順の確認
・点検したファイル：【要確認】件
・指摘：空欄 3件、期限 1件（30日以内）、不整合 2件
・保存先：90_AI下書き/テスト_チェック結果.xlsx

※出力は説明用のイメージです。件数は実際のファイルで変わります。

スキルを登録する前のチェックリスト

• スキルにする業務を1つに絞り、チャットで2〜3回試した
• 使う場所（Claudeアプリ／Claude Code／API）を決めた
• name が英小文字・数字・ハイフンで、claude・anthropicを含まない
• description に「何をするか」と「いつ使うか」を両方書いた
• 「推測しない」「判断しない」「出どころを報告する」を本文に入れた
• 提出・送信など影響の大きい作業は、自動で使われない設定にした
• スキルの中にパスワード・個人情報・単価を入れていない
• 管理者と、見直しの時期（月1回など）を決めた

Claudeのスキルのよくある質問

あわせて読みたい記事

• CLAUDE.mdとは？書き方と建設会社の記入例
• Claude Codeとは？できること・法人利用と建設会社の書類自動化の例
• 施工計画書とは？書き方・記載項目とテンプレート｜AIで下書きを作る手順
• グリーンファイル（安全書類）とは？書類一覧と書き方｜全建統一様式をAIで効率化
• 建設業のプロンプト集｜書類・報告・安全の業務別にコピーして使える50例