Claude Code 非エンジニア実践編・第4回・約13分

毎週の作業を1枚のスキルカードにする：Agent Skills入門（議事録と請求書の整理）

本記事の目次

執筆時のバージョン：Claude Code 2.1.x／2026年11月（内容は公式ドキュメントを2026年11月に確認して整理しています）。 Claude Code は更新が非常に早く、画面の表示、コマンド名、初期設定は変わることがあります。画面が本記事と異なる場合は、公式ドキュメントを優先してください。

この記事でできるようになること

前回は「毎回知っておくべきルール」を CLAUDE.md に書き込みました。ただ、もう一種類の作業があるはずです。毎週（または会議が終わるたびに）、同じ手順で繰り返し行う仕事です。

例えば、次のような作業です。

会議が終わったら、逐語録を「決定事項、ToDo、担当者、期限」に整理して議事録にする
月末に、今月の請求書の写真やPDFを月や種類ごとに整理し、一覧表を作る

こうした「いくつもの手順からなる決まった作業」を毎回一から長い指示文で伝えるのは大変ですし、説明が抜けてしまうこともあります。解決策は、スキルカード（公式名称は Skill、ファイル名は SKILL.md）にすることです。一度書いておけば、あとはスラッシュコマンドを入力するか、一言話しかけるだけで、書いた手順どおりに進めてくれます。

公式ドキュメントでも、作るタイミングは次のように明記されています。同じ指示、チェックリスト、複数ステップの手順を何度もチャットに貼り付けているとき、または CLAUDE.md の一部が「事実」ではなく「手順」になってきたときは、スキルカードにしましょう。

この記事を読むと、次のことができるようになります。

CLAUDE.md とスキルカードの役割の違いを理解する
スキルカードの置き場所と、その形式を知る
最初の「議事録」スキルカードを一から作り、2通りの方法で呼び出す
2つ目の「請求書整理」スキルカードを作り、disable-model-invocation を使ってあなたが呼び出したときだけ動くようにする
スキルカードが反応しないときの確認方法

必要なもの：

第1篇の手順で Claude Code をインストールし、ログイン済みであること
練習用の Claude練習 フォルダをそのまま使います。あわせて、第3回を読んでおくと進めやすくなります。
所要時間：約40分

まずは違いを理解しましょう：スキルカード vs. CLAUDE.md

	CLAUDE.md	スキルカード（SKILL.md）
役割	毎回知っておくべき事実やルール（自分が何者か、ファイル名の形式、触ってはいけない場所など）	複数ステップの手順（まずAをし、次にBをし、最後にCを出力する）
読み込まれるタイミング	起動するたびに読み込む	必要なときだけ読み込む。普段は説明の1行分だけの場所を使う
呼び出し方	呼び出す必要はなく、自動で読み込まれる	`/スキル名` を入力するか、内容が合えば Claude が自分で使うかどうかを判断する

公式ドキュメントによると、スキルの本体は使うときにだけ読み込まれます。そのため、どれだけ長い手順でも、普段はほとんど場所を取りません。つまり、ルールは CLAUDE.md に、手順はスキルカードに置く、というのが基本です。

スキルカードの置き場所

スキルカードは「1つのフォルダの中に『SKILL.md』という名前のファイルがひとつ入ったもの」です。公式ドキュメントには多くの配置場所が載っていますが、エンジニアでない方は、この2点を覚えておけば十分です。

得たい効果	場所
このパソコンのすべてのフォルダで使える	`~/.claude/skills/スキル名/SKILL.md`（Windows の `~` は `C:\Users\あなたの名前` です）
特定のプロジェクト・フォルダだけで使える	そのフォルダの中の `.claude/skills/スキル名/SKILL.md`

フォルダ名がそのままスラッシュコマンドの名前になります。 例えば .claude/skills/meeting-minutes/SKILL.md は /meeting-minutes になります。

次の3点にご注意ください（いずれも公式ドキュメントに基づきます）。

同名の場合の優先順位は、企業 > 個人 > プロジェクトです。2か所に同じ名前のカードを置かないでください。
公式ドキュメントによると、Claude Code はこれらのスキルフォルダを監視しているため、作業中にスキルカードを追加・変更しても、再起動せずに反映されます。（例外として、起動位置の「1つ下の階層のサブフォルダ」にある .claude/skills/ の場合は、そのサブフォルダのファイルを読み込んだタイミングで初めて読み込まれます。）
本記事では分かりやすくするため、英語のフォルダ名に meeting-minutes と invoice-archive を使います。名前は英小文字とハイフンを使い、記号は避けることをおすすめします（公式には名前に使える文字の制限があり、名前が拒否された場合は起動時に通知が表示されます）。

スキルカードの見た目

1枚のスキルカードは、次の2つの部分で構成されています。

---
description: 這張卡做什麼、什麼時候該用
---

（這裡用白話寫步驟，它會照著做）

上の2本の --- の間を「説明欄」（frontmatter）と呼びます。特に大切なのは description です。Claude はここを読んで、「今この作業にこのカードを使うべきかどうか」を判断します。公式では、最も重要な用途を先頭に書くことをすすめています。また、普段の会話で実際に使う言葉（「議事録」「逐語録」など）も入れておくと効果的です。

2本の --- の下が本文で、ここに手順を書きます。公式も注意しています。説明欄の --- はファイルの1行目になければなりません。そうでないと、ファイル全体が本文として扱われてしまいます。

手順1：フォルダを作る（議事録スキルカード）

まず、練習用フォルダに架空の逐語録を用意します。メモ帳を開き、C:\Users\あなたの名前\Claude練習\逐語録\20261105_採購檢討.txt を新規作成して、次の内容を貼り付けてください。

小安：今天要討論新供應商報價。
大明：A 廠比 B 廠便宜 8%，但交期要 21 天。
小安：我們庫存只剩兩週，我覺得 B 廠比較穩。
大明：那就決定先跟 B 廠下一小批試單，下週三前我去談。
小美：我來整理兩家的比較表，週五前給大家。
小安：好，下次會議 11 月 19 日再看試單結果。

（人名・会社名はすべて架空のものです。）

次に、PowerShell でスキルカード用のフォルダを作ります（この練習フォルダ専用です）。

cd "$env:USERPROFILE\Claude練習"
mkdir .claude\skills\meeting-minutes

（若出現「已存在」的提示就代表之前建過，直接下一步）

すべてのフォルダで使いたい場合は、$env:USERPROFILE\.claude\skills\meeting-minutes に作成してください。

手順2：SKILL.md を書く

メモ帳で新規ファイルを作成し、meeting-minutes フォルダの中に保存します。ファイル名は SKILL.md にしてください（保存の種類は「すべてのファイル」、文字コードは UTF-8 を選びます。そうしないと SKILL.md.txt になったり文字化けしたりします）。次の内容を貼り付けてください。

---
description: 把會議逐字稿整理成會議紀錄（決議、待辦、負責人、期限）。當使用者提到會議紀錄、逐字稿、整理會議時使用。
---

# 會議紀錄整理流程

使用者會指定一份逐字稿檔案（txt 或 docx）。請依序做：

1. 讀取該檔案。如果使用者沒說是哪一份，列出「逐字稿」資料夾的檔案，問使用者選哪一份。
2. 整理成下面的格式，用繁體中文（台灣用語）：
   - 會議名稱、日期（逐字稿檔名開頭若有 YYYYMMDD 就用它；找不到就標「待確認」）
   - 出席者
   - 決議事項（條列，每條一句話）
   - 待辦事項（表格：事項｜負責人｜期限）
   - 下次會議時間（沒提到就寫「未提及」）
3. **不要猜**：逐字稿沒有明講的負責人或期限，一律填「待確認」，不要自己補。
4. 把結果存成新檔案，放在「會議紀錄」資料夾（沒有就建立），檔名格式：
   YYYYMMDD_會議_主題_v1.md。若同名檔案已存在，版本號加 1，**不要覆蓋舊檔**。
5. 最後用 3 行說明：存到哪裡、有幾項決議、有幾項待確認。

このカードが使いやすい理由は、いくつかの工夫にあります。

「推測しない」：最も問題が起きやすいのは、存在しない期限を勝手に補ってしまうことです。そのため、明確に「確認待ち」と記入するように指示しています。
「古いファイルを上書きしない」：第2回で紹介した安全習慣を引き継いでいます。
最後の3行の報告：ファイルを開かなくても、結果が正しいかどうかすぐに分かるようにしています。

手順3：呼び出す（2つの方法）

Claude練習 フォルダで起動します。

cd "$env:USERPROFILE\Claude練習"
claude

方法1：スラッシュコマンドを直接入力する（最も確実）

/meeting-minutes 逐字稿\20261105_採購檢討.txt

スラッシュの後ろに書いた文字は、「このカードへの追加情報」として一緒に渡されます（公式ドキュメントによると、呼び出し時の引数は後ろに追加されます）。

方法2：話しかける

幫我把採購檢討的逐字稿整理成會議紀錄

description に「議事録、逐語録」と書いてあるので、Claude がこのカードを自動で読み込むかどうかを判断します。自動判断は時々外れることがあり、使われなくても不思議ではありません。その場合は、方法1をそのまま使ってください。

期待される結果：議事録\20261105_会議_採購檢討_v1.md が作成されます。内容は次のような形になるはずです（出力される文章は環境によって異なりますが、大切なのは構成と「確認待ち」の表記です）。

決議事項
- 先向 B 廠下一小批試單
待辦事項
| 事項 | 負責人 | 期限 |
| 與 B 廠洽談試單 | 大明 | 下週三前（具體日期待確認） |
| 整理兩家比較表 | 小美 | 週五前（具體日期待確認） |
下次會議：11 月 19 日

ここで注意すべき点があります。文字起こしには「来週水曜」「金曜」とだけあり、日付は書かれていません。良い結果では、これらを確認待ちとして示し、日付に自分で換算することはしません。 もし具体的な日付がそのまま書かれていた場合は、SKILL.md に戻って「推測しない」というルールをより具体的に書き直し、もう一度試してください。

ステップ4：一覧に含まれているか確認する

スキルカードが反応しないときは、まずそのカードが読み込まれているかを確認します。Claude Code で次のように入力してください：

/skills

公式ドキュメントにこのコマンドがあり、現在使えるスキルの一覧が表示されます。あなたの meeting-minutes も含まれているはずです。直接たずねることもできます：

你現在有哪些技能可以用？

（画面はバージョンによって異なります。筆者はバージョンごとの比較は行っていません。）

ステップ5：2枚目のカード――請求書のアーカイブ（呼び出したときだけ動作）

議事録は「整理して新しいファイルとして保存する」だけなので、リスクは低めです。一方、請求書のアーカイブはファイルを移動する作業です。このような作業は、実行するかどうかを Claude の判断に任せるべきではありません。

公式ドキュメントでは、この用途のために disable-model-invocation: true というフィールドが用意されています。Claude はこのカードを自動で読み込まず、あなたが /名前 と入力したときだけ動作します。 公式の説明では、デプロイやコミットなど、「副作用があり、実行のタイミングを自分で管理したい」ワークフローに適しているとされています。

フォルダを作成し、ファイルを書き込みます：

mkdir "$env:USERPROFILE\Claude練習\.claude\skills\invoice-archive"

SKILL.md の内容：

---
description: 把「待歸檔發票」資料夾裡的發票檔案，依月份歸檔並產生清單。
disable-model-invocation: true
---

# 發票歸檔流程

使用者會告訴你要處理哪個月份（例如 2026-10）。請依序做：

1. 列出「待歸檔發票」資料夾的所有檔案，**先不要動任何檔案**。
2. 依檔名或內容判斷日期與類別（交通、餐飲、辦公用品、其他）。判斷不出來的歸「待確認」，不要猜。
3. 產生一張對照表給使用者看：舊檔名｜日期｜類別｜新位置。
4. **等使用者回答「好」才動手。** 使用者沒說好，就不要搬任何檔案。
5. 同意後：
   - 先把「舊檔名清單」存成 CSV（備份，之後可救回）。
   - **複製**（不是搬移）檔案到「發票歸檔\YYYY-MM\類別\」，檔名格式：YYYYMMDD_類別_金額.副檔名。
   - 不刪除、不覆蓋任何檔案。
6. 最後產生 `發票歸檔\YYYY-MM\清單.csv`（日期、類別、金額、檔名），並說明有幾筆、幾筆待確認。

このカードには、前の2篇で学んだ3つの安全習慣がすべて組み込まれています：まず対応表を示す、同意を得てから実行する、移動ではなくコピーし、バックアップを残す。

呼び出し方：

/invoice-archive 2026-10

最初は偽の請求書ファイル5つ（請求書らしい名前の txt ファイルや画像などを適当に）でテストしてください。いきなり本物の請求書を使わないでください。

注意：disable-model-invocation が制御するのは「このカードが自動で読み込まれるかどうか」だけです。本当のブレーキは、第1篇で学んだ権限モード（実行前に Claude が確認を求めてくる）と、カード内の「私が良いと言うまで待つ」というルールです。両方を組み合わせて使ってください。

スキルカードが反応しないときの確認方法

公式のトラブルシューティングの順序を、わかりやすく言い換えると次のとおりです：

まず /skills で、カードが一覧に表示されているか確認します。 表示されない場合は、フォルダの場所が間違っているか（正しくは .claude/skills/名前/SKILL.md。.claude の前にドットがあることに注意）、ファイル名が SKILL.md になっていない可能性があります（よくあるのは SKILL.md.txt になってしまうケースです）。
直接 /名前 と入力してみてください。 呼び出せるのに、普段の会話では自動で発動しない場合は、通常 description に、普段あなたが使う言葉が含まれていないことが原因です。description を書き直して、もう一度試してください。
説明欄の --- は1行目になければならず、その間の YAML の形式も正しく書く必要があります。形式が壊れていても、公式によるとスキルの本文は読み込まれるため、/名前 は引き続き使えます。ただし、Claude は description をもとに「いつ使うべきか」を判断できなくなります。
/名前 を入力しても反応がない場合は？ 名前に特殊文字が含まれていて、拒否されている可能性があります。claude --debug で起動して確認できます。
カードを変更したのに結果が変わらない場合は？ 公式の説明では、スキルの内容はセッション中に読み込まれた時点のバージョンのままになります。確信が持てない場合は、いったん終了して再起動するのが確実です（/exit と入力し、その後 claude と入力）。
定期実行による自動化を考える場合は注意してください： 公式の説明では、あなたのパソコンの ~/.claude/skills/ にのみ存在するスキルカードは、クラウドで実行される定期タスクからは読み取れません。この点は次回（スケジュール実行）で改めて扱います。

4つの「やってはいけないこと」

パスワード、アカウント、顧客データを SKILL.md に書かないでください。 スキルカードはコピーされたり、同僚と共有されたりする可能性があります。
1枚のカードに多くの作業を詰め込みすぎないでください。 1枚のカードには作業を1つだけ入れ、名前を見ればすぐわかるようにしましょう。
副作用のあるカード（ファイルの移動、削除、メール送信など）を自動で発動させないでください。 disable-model-invocation: true を加え、「先に私に見せて、同意してから実行する」と書いておきましょう。
書いたらそのまま信用しないでください。 新しいカードは、偽のデータで一度実行して結果が期待どおりか確認してから、本物のデータを使いましょう。

既製のものをすぐに使いたい方へ

最初の1枚を自分で書くのがいちばん時間がかかります。「説明をどこまで具体的に書くか」「何を明示して禁止すべきか」を手探りする必要があるためです。そこで、議事録、ファイル整理、レポートなどのよくあるオフィス業務向けのスキルカードを一式まとめました。.claude/skills/ にそのまま入れられます。どのカードも構成が整えられており、「推測しない」「同意があってから実行する」という安全ルールが書き込まれています。使うときは、フォルダー名だけご自分のものに変えてください。

👉 デジタル商品を見る

（購入しなくても問題ありません。上の2枚があれば使い始められます。自分の作業の流れに合わせて書き換えてください。）

次回予告

第5篇：《パソコンの前で待たなくていい：Claude Code に毎日自動で一度実行させる》 スキルカードを使えば作業は「一言で実行できる」ようになります。次回は一歩進んで、決まった時刻に自動で動かす方法を解説します。あわせて、「権限のホワイトリスト、ログファイル、スケジュール実行に任せてはいけない作業」が、どう設定するかと同じくらい大切な理由もお伝えします。

参考資料（いずれも公式ドキュメント、2026年11月時点で確認）

スキルを使って Claude を拡張する（場所、SKILL.md の形式とフィールド、disable-model-invocation、引数、変更の即時検出、トラブルシューティング）：https://code.claude.com/docs/zh-TW/skills
Agent Skills オープン標準：https://agentskills.io

操作説明：スキルカードの場所、frontmatter のフィールド、/skills、disable-model-invocation、変更の即時検出、トラブルシューティングは、上記の公式ドキュメントに基づいてまとめたものです。本篇のサンプルスキルカードは、筆者のパソコンで項目ごとに実際に動作確認はしていません。本文中の「期待される結果」はイメージであり、実際の出力は異なる場合があります（検証待ち）。mkdir コマンドは Windows PowerShell の書き方です。Mac の場合は、Terminal で mkdir -p .claude/skills/meeting-minutes を使ってください。パス ~/.claude/skills/ は同じです。例に登場する人名、会社名、文字起こしはすべて架空のものです。

← 記事一覧に戻る