SKILL.md の書き方と最小の形
一行の引き継ぎメモを作りながら、名前・説明・本文の役割を覚えます。
対象 短い指示を初めてファイルにする方
所要時間の目安 5分
コピーする本文
二本の --- で囲む部分が設定欄です。name は呼び出す名前、description は使う場面。下の本文には、材料から何を抜き出し、どんな順に返すかを書きます。
.claude/skills/handover-note/SKILL.md
--- name: handover-note description: 作業途中のメモを次の担当者へ渡すときに使う。 --- 終えたことと次の一手を一つずつ抜き出し、「完了」「次」の二行で返す。
入れ方
- Claude Code では、仕事用フォルダーの中に、本文の上に示した名前でフォルダーとファイルを作ります。Codex では、個人用なら ~/.agents/skills/、仕事用フォルダーだけで使うなら、Codex をそのフォルダーで開いて使う前提で、その中の .agents/skills/ に、スキル名のフォルダーと SKILL.md を作ります。
- 「本文をコピー」を押し、空の SKILL.md に貼り付けて保存します。先頭の --- から末尾までが一つのファイルです。以前の案内で ~/.codex/skills/ に置いた方は ~/.agents/skills/ へ移してください。
- 保存すると、Claude Code は今の会話のまま読み込みます。Codex も変更を自動で見つけます。見つからないときは、Claude Code なら /reload-skills を入力し、Codex なら再起動します。
- Claude Code では /スキル名 に続けて下の入力例を渡します。Codex ではスキル名を指定して、下の入力例を渡します。出力例と見比べ、数字・未定の項目・見出しが残るか確かめます。
出力例
架空の青葉製本での作例です。登場する人名は仮名です。
入力例
森が表紙の赤字を反映した。次は佐野が校正する。
返ってくる内容の例
完了:森が表紙の赤字を反映
次:佐野が校正
関連ページ
出典
出典を確認した日(一番古いもの)
- 公式の説明書 https://code.claude.com/docs/en/skills 確認日
- 照合した配布資料 https://github.com/anthropics/claude-plugins-official/blob/73c8cf3ea7e296057b467990f2f5d61b4c922260/plugins/claude-code-setup/skills/claude-automation-recommender/references/skills-reference.md 確認日
- 公式の説明書 https://learn.chatgpt.com/docs/build-skills 確認日