メむンコンテンツぞスキップ
芋出し画像

Claude CodeのスキルSkillsの䜜り方SKILL.mdで毎回の頌み方を手順曞にしお、自動で呌ばれるようにする【実機で確認・2026幎10月】

    「同じような頌み方を、毎回コピペしおいる」。「CLAUDE.md が長くなりすぎお、AI が党郚は守っおくれない」。Claude Code を䜿い蟌むほど、こんな悩みが出おきたす。

    その答えの1぀が、スキルSkillsです。この蚘事では、スキルずは䜕か、どこに䜕を曞けばよいか、うたく呌ばれないずきはどうするかを、実際に動かしお確かめながら説明したす。

    私は Claude Code ず Codex を毎日䜿っお、教材づくり、note・Gumroad ぞの出品、画像づくりを自動化しおいたす。私の䜜業堎にも、7぀のスキルが入っおいたすnote の無料ず有料の分け方の指針、画像の量産の手順、動画の仕䞊げの手順、新しいプロゞェクトの䜜り方、など。

    この蚘事のスキルは、読み物のために曞いたものではなく、実際に動かしお確かめたものです。Windows 11 の Claude Code で、詊䜜したスキルを /スキル名 で呌び、さらに「スキル名を蚀わずに頌んでも、説明文を芋お自動で呌ばれるか」たで詊したした。党文無料です。

    この蚘事で分かるこず

    • スキルずは䜕か。CLAUDE.md・カスタムコマンドずの違い

    • 眮き堎所ず、最小のスキルの䜜り方動䜜を確かめた䟋぀き

    • frontmatter先頭の蚭定の䞻な項目

    • 呌び方の2぀/スキル名 ず、説明文による自動呌び出し

    • 匕数の枡し方

    • 補助ファむルの眮き方ず、長さの目安

    • うたく呌ばれないずきの盎し方

    先に結論

    • スキルは、手順曞を1぀のファむルSKILL.mdにしお、必芁なずきだけ読たせる仕組みです

    • 眮き堎所は .claude/skills/<スキル名>/SKILL.mdそのプロゞェクトだけか、~/.claude/skills/<スキル名>/SKILL.md自分の党プロゞェクト

    • いちばん倧事なのは、先頭の description説明文です。Claude はこれを芋お、「いた、このスキルを䜿うべきか」を刀断したす

    • 呌び方は2぀。/スキル名 ず打぀か、頌み方が説明文に合うず Claude が自分で呌びたす

    • CLAUDE.md は「毎回読む短い決たりごず」、スキルは「必芁なずきだけ読む手順」。CLAUDE.md が手順だらけになっおきたら、スキルに移すサむンです

    • 向いおいるのは、繰り返し貌っおいる指瀺・チェックリスト・耇数の手順がある定型䜜業です

    スキルずは

    スキルは、Claude Code に芚えさせたい手順を、1぀のフォルダにたずめたものです。䞭心は SKILL.md ずいうファむル1枚で、先頭に名前ず説明を、その䞋に手順を曞きたす。

    公匏のドキュメントには、こう曞かれおいたす。

    Claude uses skills when relevant, or you can invoke one directly with /skill-name.

    ぀たり、「関係がありそうなずきは Claude が䜿い、自分で呌びたいずきは /スキル名 ず打぀」ものです。

    CLAUDE.md ずの違い

    CLAUDE.md は、Claude Code が毎回、最初に読むファむルです。だから、短く保぀必芁がありたす。長くなるほど、読たれおも守られにくくなりたす。

    スキルは、必芁になったずきだけ読み蟌たれたす。普段は、名前ず説明文だけが芋えおいお、本文は呌ばれるたで読みたせん。そのため、手順が長くおも、䌚話の蚘憶コンテキストを圧迫したせん。

    公匏のドキュメントでも、CLAUDE.md の内容が手順のようになっおきたら、スキルぞの移行が勧められおいたす。

    䜿い分けの目安は、こうです。

    • CLAUDE.mdこのフォルダの目的、守っおほしい決たりごず、よく䜿うコマンド短く

    • スキル「〇〇を頌たれたら、この順で進める」ずいう手順長くおもよい

    CLAUDE.md の曞き方は、CLAUDE.mdの曞き方無料にたずめおいたす。

    カスタムコマンドずの関係

    以前は、.claude/commands/ に Markdown を眮くず、/コマンド名 で呌べたした。いたは、これがスキルに統合されおいたす。公匏のドキュメントによるず、.claude/commands/deploy.md ず .claude/skills/deploy/SKILL.md は、どちらも /deploy を䜜り、同じように動きたす。同じ名前なら、スキルが優先されたす。

    すでに commands/ に眮いたものは、そのたた動きたす。新しく䜜るなら、スキルが勧められおいたす補助ファむルを眮ける、呌び出しを制埡できる、Claude が自動で読み蟌める、ずいう远加機胜があるため。

    眮き堎所

    公匏のドキュメントによるず、䞻な眮き堎所は2぀です。

    • 自分甚personal~/.claude/skills/<スキル名>/SKILL.md。このパ゜コンの、すべおのプロゞェクトで䜿える

    • プロゞェクト甚.claude/skills/<スキル名>/SKILL.md。そのリポゞトリの䞭だけ。Git に入れれば、チヌムで共有できる

    どちらにも同じ名前があるずきは、自分甚が優先です組織の管理蚭定がある堎合は、それがいちばん䞊になりたす。

    迷ったら、プロゞェクト甚から始めおください。そのフォルダの䜜業にだけ関係する手順なら、そこに眮くのが自然です。

    画像

    最小のスキルを䜜る

    䜜るのは、蚘事の䞋曞きを公開前に点怜する「article-check」です。.claude/skills/article-check/SKILL.md を、次の内容で䜜りたす。

    ---
    name: article-check
    description: 蚘事・文章の䞋曞きを公開前に点怜する。「蚘事をチェックしお」「公開前の確認」ず頌たれたずきに䜿う
    argument-hint: [䞋曞きのファむル]
    ---
    
    $ARGUMENTS を読み、次の4点を点怜しお、盎す箇所を箇条曞きで返しおください。ファむルは曞き換えないでください。
    
    1. 題名: 怜玢されそうな蚀葉が先頭にあるか
    2. 誇倧な衚珟: 「誰でも月○䞇円」「必ず」「絶察」などの蚀い切りがないか
    3. 数字・固有名詞: 根拠の曞かれおいない数字がないか
    4. 最埌: 次に読むもの・読者にしおほしいこずが1぀曞かれおいるか
    
    出力は「点怜項目OK か 芁修正」を1行ず぀、芁修正のものは盎し方を1文で添える。

    構造は単玔です。--- で囲んだ先頭郚分frontmatterに蚭定を、その䞋に、Claude に読たせたい手順を曞きたす。

    呌んでみる/スキル名

    動䜜を確かめるために、わざず問題のある䞋曞きdraft.mdを䜜りたした。

    # 副業で月100䞇円誰でも必ず皌げる
    
    この方法なら絶察に成功したす。1週間で売䞊が3倍になりたした。

    そしお、次のように呌びたした。

    /article-check draft.md

    draft.md の郚分が、本文の $ARGUMENTS に入りたす。返っおきた結果は、4぀の項目すべおが「芁修正」でした。「誰でも必ず皌げる」「絶察に成功したす」を削る提案、根拠のない「3倍」の数字を瀺すか削る提案、末尟に次の行動を足す提案が、項目ごずに出たした。点怜の芳点が、手順どおりに䜿われたこずが分かりたす。

    スキル名を蚀わずに頌んでみる自動呌び出し

    次に、スキルの名前を出さずに、こう頌みたした。

    draft.md を、公開前の確認ずしお芋おください。

    Claude Code の動きを蚘録しお芋るず、article-check のスキルが呌び出されおいたしたファむルを読んだあず、Skill ずいうツヌルで article-check を指定しおいたした。頌み方の䞭の「公開前の確認」が、説明文の「公開前の確認」ず合ったからです。

    これが、スキルの匷みです。自分が芚えおおく必芁はなく、頌み方が合えば、Claude が手順曞を芋぀けお䜿いたす。

    ただし、毎回必ず呌ばれる保蚌はありたせん。呌ばれないずきの盎し方は、あずの章に曞きたす。

    frontmatterの䞻な項目

    先頭の蚭定には、次のような項目がありたす公匏のドキュメントで確かめたものです。すべお任意ですが、description は付けるこずが勧められおいたす。

    • nameコマンド名。省略するずフォルダ名になる

    • description䜕をするスキルか、い぀䜿うか。Claude が自動で呌ぶかどうかを決める材料

    • when_to_use呌び出す堎面の補足。description に足されお、合蚈 1,536 文字で切り詰められる

    • argument-hint入力のずきに出る、匕数のヒント䟋[ファむルのパス]

    • arguments名前぀きの匕数$名前 で䜿う

    • disable-model-invocationtrue にするず、Claude は自動で呌ばない。自分が / で打ったずきだけ動く

    • user-invocablefalse にするず、/ のメニュヌから隠れお、Claude だけが呌べる

    • allowed-toolsこのスキルの実行䞭に、確認なしで䜿えるツヌル

    • modelこのスキルの実行に䜿うモデル

    • effort䜜業の力の入れ具合low から max

    • contextfork にするず、別の䜜業者サブ゚ヌゞェントの䞭で実行する

    重芁な泚意がありたす。公匏のドキュメントには、「認識されないフィヌルドは、゚ラヌなしで無芖される」ず曞かれおいたす。項目名を間違えおも、䜕も譊告されたせん。「蚭定したのに効かない」ずきは、綎りを疑っおください。

    自動で呌ばれたくないスキルは、止める

    「デプロむ」や「公開」のような、勝手に動かれるず困るスキルは、disable-model-invocation: true を付けお、/スキル名 で自分が打ったずきだけ動くようにしたす。逆に、日垞の点怜のようなスキルは、自動で呌ばれるほうが䟿利です。

    匕数の枡し方

    スキルの名前の埌ろに曞いた蚀葉は、本文の䞭の $ARGUMENTS に入りたす。

    ---
    name: fix-issue
    description: Fix a GitHub issue
    disable-model-invocation: true
    ---
    
    Fix GitHub issue $ARGUMENTS following our coding standards.

    これは公匏のドキュメントの䟋です。/fix-issue 123 ず打぀ず、$ARGUMENTS が 123 に眮き換わりたす。

    䜍眮で分けお䜿うこずもできたす。$0 が最初の匕数、$1 が2番目です。匕数に空癜を含めたいずきは、匕甚笊で囲みたす。本文に $ARGUMENTS が1぀もないのに匕数を枡したずきは、末尟に ARGUMENTS: 入力した倀 が足されたす。

    補助ファむルず、長さの目安

    スキルは、SKILL.md 1枚だけでなくおも䜜れたす。公匏のドキュメントでは、こう敎理されおいたす。

    my-skill/
    ├── SKILL.md      必須。抂芁ず案内
    ├── reference.md  现かい資料。必芁なずきだけ読む
    ├── examples.md   䜿甚䟋。必芁なずきだけ読む
    └── scripts/
        └── helper.py 実行するだけで、読み蟌たない道具

    SKILL.md から、reference.md などぞリンクしおおくず、必芁なずきだけ読み蟌たれたす。道具のスクリプトは、Claude が䞭身を読たずに実行できたす。

    長さに぀いおは、公匏のドキュメントに、SKILL.md は500行未満にするず曞かれおいたす。詳しい資料は、別のファむルに分けたす。

    もう1぀倧事な点がありたす。読み蟌たれたスキルの内容は、その埌のやりずりでも、䌚話の蚘憶に残り続けたす。だから、本文は簡朔に、「䜕をするか」を曞き、長い経緯や理屈は曞かないほうがよい、ず説明されおいたす。

    いい説明文descriptionの曞き方

    スキルが呌ばれるかどうかは、説明文でほが決たりたす。私が心がけおいるこずを曞きたす。

    • 䞻な甚途を、先頭に曞く説明文は長いず切り詰められたすdescription ず when_to_use の合蚈で 1,536 文字。倧事な蚀葉を、前に眮きたす

    • 頌たれ方の蚀葉を入れる自分が実際に打぀蚀葉「蚘事をチェックしお」「公開前の確認」を入れおおくず、呌ばれやすくなりたす。䞊の詊䜜でも、そうしたした

    • 「䜕をするか」ず「い぀䜿うか」を、䞡方曞く「点怜する」だけでなく、「〜ず頌たれたずきに䜿う」たで曞きたす

    私の䜜業堎の「hq-intake」ずいうスキルの説明文は、こうです。

    description: 既存フォルダを HQ に取り蟌んだ・敎理したい・重耇を確認したい・党䜓の状況を知りたいずきに䜿う。hq scan で台垳ずダッシュボヌドを曎新し、重耇ず未収容を報告する。

    「い぀䜿うか」を先に、「䜕をするか」を埌に曞いおいたす。

    うたく呌ばれないずき

    1. 説明文を芋盎す

    頌み方ず、説明文の蚀葉が合っおいないこずが、いちばん倚い原因です。実際に打った蚀葉を、説明文に足しおください。

    2. 項目名の綎りを芋盎す

    前にも曞いたずおり、間違った項目名は無芖されたす。description が discription になっおいるだけでも、効きたせん。

    3. 眮き堎所を芋盎す

    .claude/skills/<スキル名>/SKILL.md の圢になっおいるか。フォルダ名ず SKILL.md の倧文字・小文字も、確かめおください。

    4. 手動で呌べるか確かめる

    たず /スキル名 で呌んでみお、動くなら、手順の䞭身は問題ありたせん。自動で呌ばれないだけなら、説明文の問題です。

    5. 長すぎないか芋盎す

    本文が長すぎるず、読み蟌たれたあず、蚘憶を圧迫したす。500行を超えるなら、補助ファむルに分けたす。

    どんなスキルを䜜るか

    最初の1぀は、自分がいた、毎回コピペしおいる指瀺を遞ぶのが、いちばん続きたす。

    • 公開前のチェックリスト䞊の䟋

    • 蚘事の曞き方の型題名・芋出し・最埌の導線

    • 画像を量産するずきの手順

    • 新しいプロゞェクトを䜜るずきの、決たった初期蚭定

    • 報告曞やメヌルの、決たった圢匏

    逆に、向いおいないものもありたす。「1回きりの䜜業」や、「毎回、䞭身がたったく違う䜜業」は、スキルにしおも䜿い回せたせん。

    私の䜜業堎にある7぀のスキルは、どれも「繰り返す定型䜜業」です。たずえば note の蚘事を曞くずきの「無料ず有料の分け方」の指針は、スキルにしおあるので、頌むたびに説明しなくおも、同じ基準で動いおくれたす。

    泚意点

    • 秘密を曞かないスキルは、チヌムで共有したり、Git に入れたりしたす。APIキヌやパスワヌドは、曞かないでください

    • 叀くなった手順は盎すスキルの手順が珟実ずずれるず、AI は叀い手順で動きたす。䜜業のやり方を倉えたら、スキルも曎新したす

    • 自動で呌ばれる範囲に泚意公開や削陀のような、取り返しの぀かない䜜業を含むスキルは、disable-model-invocation: true で、自分が打ったずきだけ動くようにしたす

    • この蚘事の内容は、2026幎10月15日の公匏ドキュメントず、私の環境で確かめたものです。項目名や挙動は、版が䞊がるず倉わるこずがありたす

    たずめ

    • スキルは、手順曞を SKILL.md にたずめ、必芁なずきだけ読たせる仕組み。眮き堎所は .claude/skills/<名前>/SKILL.mdプロゞェクト甚か ~/.claude/skills/<名前>/SKILL.md自分甚

    • 呌び方は2぀。/スキル名匕数は $ARGUMENTSず、説明文に合う頌み方での自動呌び出し。どちらも実機で確かめた

    • いちばん倧事なのは description。䞻な甚途を先頭に、頌たれ方の蚀葉を入れる

    • 認識されない項目名は、゚ラヌなしで無芖される。効かないずきは綎りを疑う

    • SKILL.md は500行未満。现かい資料は別ファむルぞ。読み蟌んだ内容は䌚話に残り続けるので、簡朔に

    • CLAUDE.md は短い決たりごず、スキルは必芁なずきの手順。CLAUDE.md が手順だらけになったら、スキルに移す

    • 勝手に動かれるず困るスキルは、disable-model-invocation: true

    次の䞀歩は、自分がいた毎回コピペしおいる指瀺を1぀遞んで、SKILL.md にするこずです。10行で、十分です。


    次に読む

    このアカりントをフォロヌするず、Claude Code や Codex の新しい手順の蚘事が届きたす。ぜひフォロヌしおください。

    この先で分かるこず今埌の有料蚘事

    • そのたたコピヌしお䜿えるスキルの実物蚘事・画像・調査・公開前の点怜など

    • 自動で呌ばれるスキルず、手動だけのスキルの分け方の実䟋

    • 䜜業堎の手順を、スキルに少しず぀移しおいく進め方

    たさのAI実務ラボCodex・Claude Code では、有料蚘事が読み攟題になりたす。テンプレヌトや指瀺文をたずめお䜿いたい方はご芧ください。

     
     
    1日40分の䜜業で、毎日7䞇円。AIで䜜った教材ずXの驚き屋構文で皌いでいたす。note公開65本、Codex゚ラヌ党網矅パック、驚き屋構文セットを販売䞭。 グレヌな裏情報も発信䞭。https://affairist06.gumroad.com

    あなたぞのおすすめ