Claude Code の SKILL.md、議事録スキル全文公開

Claude Code の Skills は、これまで毎回チャットに貼っていた指示を SKILL.md というファイルに固定する仕組みだ。置き場所は ~/.claude/skills/<名前>/SKILL.md なら全プロジェクト、.claude/skills/<名前>/SKILL.md ならリポジトリ単位で git 共有できる。SKILL.md は先頭の YAML フロントマターと本文でできており、Claude が最初に読むのは description だけで、本文はスキルが使われるときに初めて読み込まれる。このため本文が長くてもふだんのコンテキストをほとんど消費しないのが CLAUDE.md との大きな違いであり、/gijiroku のようにスラッシュコマンドで明示的に呼ぶこともできる。

筆者は議事録・日報・請求書・敬語メールなど日本の業務向けのスキルを12本作り、その過程で書き方のコツを5つにまとめた。description には「何をするか」と「どう頼まれたら使うか」を両方書き、日本語で頼むなら日本語の依頼フレーズを入れると発動が安定したという。さらに、分からないときにどうするかを決めておくこと、出力フォーマットはテンプレートで示すこと、間違えてはいけない計算は Python スクリプトに任せること、最後に品質チェックリストを置くことを挙げている。スクリプトのパスは ${CLAUDE_SKILL_DIR} で参照でき、allowed-tools に同じコマンドを書いておけば実行時に許可を求められない。

議事録スキル gijiroku の全文では、拡大文字の .vtt / .srt / .txt を渡されたときにタイムスタンプと番号行を除去して話者ラベルを保持すること、会議名・日時・場所・参加者・欠席者・記録者が分からなければ推測で埋めず「（要確認）」と書いて質問で作業を止めないことなどが指示されている。実行例では「金曜まで」「来週中」が 10/2（金）、10/9（金）と具体的な日付に換算され、結論が出なかった論点は保留・次回持ち越しに分けられた。定型業務を任せる効果は、こうした不明時の振る舞いと出力テンプレート、品質チェックリストをどこまで自部署の運用に合わせて書き込めるかにかかってくるとみられる。