試作版
仕事のAIスキル帳

SKILL.md の書き方と最小の形

一行の引き継ぎメモを作りながら、名前・説明・本文の役割を覚えます。

対象 短い指示を初めてファイルにする方

所要時間の目安 5分

コピーする本文

二本の --- で囲む部分が設定欄です。name は呼び出す名前、description は使う場面。下の本文には、材料から何を抜き出し、どんな順に返すかを書きます。

.claude/skills/handover-note/SKILL.md

---
name: handover-note
description: 作業途中のメモを次の担当者へ渡すときに使う。
---

終えたことと次の一手を一つずつ抜き出し、「完了」「次」の二行で返す。

入れ方

  1. Claude Code では、仕事用フォルダーの中に、本文の上に示した名前でフォルダーとファイルを作ります。Codex では、個人用なら ~/.agents/skills/、仕事用フォルダーだけで使うなら、Codex をそのフォルダーで開いて使う前提で、その中の .agents/skills/ に、スキル名のフォルダーと SKILL.md を作ります。
  2. 「本文をコピー」を押し、空の SKILL.md に貼り付けて保存します。先頭の --- から末尾までが一つのファイルです。以前の案内で ~/.codex/skills/ に置いた方は ~/.agents/skills/ へ移してください。
  3. 保存すると、Claude Code は今の会話のまま読み込みます。Codex も変更を自動で見つけます。見つからないときは、Claude Code なら /reload-skills を入力し、Codex なら再起動します。
  4. Claude Code では /スキル名 に続けて下の入力例を渡します。Codex ではスキル名を指定して、下の入力例を渡します。出力例と見比べ、数字・未定の項目・見出しが残るか確かめます。

出力例

架空の青葉製本での作例です。登場する人名は仮名です。

入力例

森が表紙の赤字を反映した。次は佐野が校正する。

返ってくる内容の例

完了:森が表紙の赤字を反映 次:佐野が校正

関連ページ

出典

出典を確認した日(一番古いもの)