Skillsはいつ適用される?descriptionで決まる発動タイミングを検証

目次

Skillsとは

Skillsとは、Claude Code に「特定の作業のやり方」をまとめて覚えさせる仕組みで、CLAUDE.md や rules.md との大きな違いはスクリプトを含めることができる点です。

適用タイミングは description で決まる

スキルの中身(SKILL.md

---
name: date-output
description: 現在日時を取得してコンソールに出力する指示のときに使う。出力の先頭に必ず「日付出力Skills適用中」を付けてから、現在日時を YYYY-MM-DD HH:mm:ss 形式で表示する。日付・日時の出力に関係しない指示では使わない。
---

現在日時の出力を依頼されたときに使うスキルです。

最重要は description です。
Claude はここに書かれた用途と、依頼内容が一致したときだけスキルを呼び、一致しなければ呼びません。

①足し算と②日付取得を依頼する

依頼文 descriptionに合致? 予想
二つの数値を足し算して、コンソールへ出力してください。 しない 呼ばれない
現在日時を取得し、コンソールへ出力してください。 する 呼ばれる

①足し算を依頼:スキルが呼ばれる想定

日付と無関係な足し算を頼みます。

二つの数値を足し算して、コンソールへ出力してください。

返ってきたのは 8 であり、日付出力Skills適用中 はどこにも出ていないため、スキルが呼ばれないことを確認できました。

図2:足し算の依頼に対し、node -e で const a=3, b=5; console.log(a + b); を実行し 8 を出力。先頭に「日付出力Skills適用中」は出ていない

②現在日時を依頼:スキルが呼ばれる想定

現在日時を取得し、コンソールへ出力してください。一回目の指示との違いは「足し算」か「現在日時」かだけです。
図3:入力欄に「現在日時を取得し、コンソールへ出力してください。」と入っている

print-date.ts が作られましたのでスキルが呼ばれたを確認できました。

図4:現在日時の依頼に対し print-date.ts を作成・実行し、出力先頭に「日付出力Skills適用中」、続けて 2026-06-20 20:40:51 が表示され、ソース全文も提示されている

まとめ

  • Skills は .claude/skills/<名前>/SKILL.md にまとめる「作業の手順+道具」のセット
  • 呼ばれるかどうかは description 次第。Claude が依頼内容と見比べて、必要なときだけ呼ぶ
  • 一回目の指示(足し算)でスキルは呼ばれず、二回目の指示(現在日時)ではスキルが呼ばれた
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

CAPTCHA


目次