インディーハッカー道
Claude Codeのコマンドとスキルの違いをプロが整理|どちらで作るか迷わない4つの基準
AI活用

Claude Codeのコマンドとスキルの違いをプロが整理|どちらで作るか迷わない4つの基準

·18分で読める
平城寿
平城 寿(ひらじょう ひさし)
@SOHO創業者 / インディーハッカー

この記事のポイント

  • ✓Claude Code のコマンドとスキルの違いを
  • ✓公式ドキュメントと私の運用で解説します
  • ✓コマンドとして呼べる形にする手順を載せています

コマンドとスキル、結局どっちで作ればいいのだろう。 そう迷ったことはありませんか。

私は会社を22年やっていて、毎日 Claude Code を使っています。 自分の手順は、コマンドにしたものと、スキルのままにしたものがあります。 その分け方には、1つの基準があります。

この記事では、動画で話した内容に加えて、Claude Code の公式ドキュメントで確かめたことを、表と手順にして載せています。 コマンドとスキルが、公式の仕様でどう関係しているかは、置き場所・名前の決まり方・同じ名前のときの優先順位まで、表にしました。 私が毎日使っているコマンドとスキルの実例は、3つ載せています。 最後に、迷わず決められる基準と、スキルをコマンドとして使える形にする手順があります。 Claude Code への頼み方の例も、載せています。 読んだ公式ページの一覧は、最後にあります。

動画でも解説しています。

こんな疑問から始まった

動画の最初に、3つの疑問を挙げました。

  • コマンドとスキル、結局、どっちで作ればいいのか
  • コマンドって、裏でスキルを呼んでいるだけなのか
  • 毎回文章で頼むのが面倒なときの、ショートカットなのか

この3つに、最後に答えます。 先に、言葉の意味をそろえておきます。

スキルは、決まった手順を書いておく、1つの手順書です。 新人さんに渡す、業務マニュアルのようなものだと思ってください。 コマンドは、スラッシュと名前を打って呼び出す機能です。

公式ドキュメントで確かめた、コマンドとスキルの関係

公式の Extend Claude with skills のページには、次のように書かれています。 カスタムコマンドは、スキルに統合されました。 以前の .claude/commands/ に置いたファイルも、そのまま動きます。

つまり、コマンドは、スキルとは別の物ではありません。 スキルを、スラッシュと名前で呼ぶ、呼び方です。

どれも呼んでいる先は同じスキル。自分が呼ぶコマンド、Claude が呼ぶ、プログラムが拾うフックの3つが、スキルに向かう図

ここで、スラッシュで打てる物が、公式でどう分類されているかを整理します。 公式の Commands のページは、一覧の表で、2種類を区別しています。

種類例中身
組み込みのコマンド/clear、/compact、/helpClaude Code の本体に、動きが固定で組み込まれている
付属のスキル(bundled skills)/code-review、/debug、/doctor、/batch、/loop、/claude-apiClaude への手順書。自分で作るスキルと同じ仕組み
自分で作るスキル~/.claude/skills/名前/SKILL.md自分で書いた手順書
自分で作るコマンドのファイル~/.claude/commands/名前.md、.claude/commands/名前.md以前の形式。今も動く。スキルと同じ設定項目が書ける(name と paths を除く)

公式の Commands のページでは、付属のスキルは、一覧の中で Skill と印が付いています。 スラッシュで呼ぶ見た目は同じでも、/clear のような固定の動きと、/code-review のような手順書は、中身が違います。 手順書のほうが、自分で作れる側です。

置き場所

スキルの置き場所は、公式に表で書かれています。

場所パス使える範囲
個人~/.claude/skills/名前/SKILL.mdこの Mac のすべてのプロジェクト
プロジェクト.claude/skills/名前/SKILL.mdそのリポジトリの会話。コミットすればチームでも共有できる
入れ子サブフォルダ/.claude/skills/名前/SKILL.mdそのサブフォルダの中で作業するとき
以前のコマンド.claude/commands/名前.md今も動く。ただし公式は、新しく作るならスキルを勧めている(補助のファイルを同じフォルダに入れられるため)

呼び出す名前は、どこから決まるか

呼び出す名前は、置き場所から決まります。 公式の表のうち、よく使う3つを載せます。

置き場所呼び出す名前
.claude/skills/deploy-staging/SKILL.md/deploy-staging(フロントマターに name: deploy と書けば /deploy)
.claude/commands/deploy.md/deploy(ファイル名から拡張子を除いたもの)
.claude/commands/frontend/component.md/frontend:component(サブフォルダの区切りがコロンになる)

同じ名前があるとき、どちらが動くか

私の /resume のように、同じ名前が複数あるときは、公式の表のとおりに決まります。

同じ名前が動くほう
~/.claude/skills/ と プロジェクトの .claude/skills/ の両方個人のスキル
スキルと、.claude/commands/ のファイルスキル
自作のスキルと、付属のスキル自作のスキル(付属のスキルの別名までは置き換わらない)
自作のスキルと、組み込みのコマンド自作のスキル。ローカルの端末の会話では、組み込みのコマンドを置き換える(別名までは置き換わらない)

公式の例では、プロジェクトに usage というスキルを作ると /usage が置き換わり、別名の /cost は、組み込みのままで動きます。

違いは、見た目ではなく、誰が呼ぶか

見た目の違いだと思うと、迷います。 違いは、誰が呼ぶかです。

  • スラッシュで呼ぶのは、私
  • 言葉に合わせて呼ぶのは、Claude

公式のスキルの説明も、この2つの呼び方を前提にしています。 既定では、自分も Claude も、どのスキルでも呼べます。 自分は /名前 と打って直接呼べて、Claude は会話の内容に合うと、自動で読み込めます。

この呼べる人を、2つの設定で変えられます。 公式の表を、そのまま載せます。

フロントマター自分が呼べるかClaude が呼べるか文脈に入るもの
何も書かない(既定)呼べる呼べる説明文が文脈に入る。呼ばれたときに全文が読み込まれる
disable-model-invocation: true呼べる自分では呼ばない説明文は文脈に入らない。呼ばれたときに全文が読み込まれる
user-invocable: false呼べない呼べる説明文が文脈に入る。呼ばれたときに全文が読み込まれる

ここで、公式の注意が1つあります。 .claude/commands/ の古い形式のファイルも、既定では、Claude が自分で呼べます。 Claude に自動で呼ばせたくない手順は、コマンドのファイルにも disable-model-invocation: true を書きます。

公式では、/commit や /deploy のように、副作用のある手順に使うよう書かれています。 Claude が、コードができたように見えるからと、勝手に本番へ出してしまっては困るからです。

名前をどこに書くかで、動き方が変わる

スキルの名前をメッセージのどこに書くかで、動き方が変わります。 これも、公式の表にあります。

書く場所例起きること
メッセージの先頭/deploy stagingClaude Code が、そのスキルを直接動かす
文の途中。前後に句読点を付けず、独立した語として書くgo ahead and /deploy to staging直接は動かない。名前が、使ってよいという許可になる。使うかどうかは、Claude が言葉から判断する

スラッシュで呼ぶと、Claude の判断を挟まず、確実に動きます。 言葉で頼むと、Claude が判断するので、動かないこともあります。 この違いが、後でコマンドにするかどうかを決める軸になります。

なお、スキルについて書くだけで、動かしたくないときは、スラッシュを付けずに書きます。

私の実例1:「再発防止」と書くだけで、スラッシュなしで動く

ここからは、私が実際に使い分けている例です。 最初は、スラッシュを打たない例です。

私は、ミスが起きたときに、「再発防止」と書きます。 原因を調べて、同じことが起きない仕組みを作らせるときです。 スラッシュは打ちません。 言葉を書くだけで、再発防止のスキルが動きます。

仕組みは、フックです。 フックは、決まった出来事が起きたときに、自動で動くプログラムです。 私の環境では、メッセージに「再発防止」という言葉が含まれていると、フックが拾って、再発防止のスキルを必ず通すように、Claude へ指示を出します。

実際のフックの冒頭には、こう書いてあります。 「覚えている前提にしない(覚えていれば忘れない、は仕掛けではない)」。

「再発防止と書いたら、スキルを使ってね」と、お願いしておく方法もあります。 ただ、お願いは、覚えている前提です。 覚えている前提にすると、必ず忘れます。 なので私は、お願いに頼らず、プログラムに拾わせています。

公式にも、同じ考え方が書かれています。 Claude Code のスキルのトラブル対応のページに、Claude Code が、スキルの途中で、必ず守らせたい規則を飛ばすときは、その規則をフックに移すよう書かれています。 フックは、決めた出来事が起きるたびに、Claude がスキルに従っているかどうかに関わらず、動くからです。

フックの作り方と、「再発防止」を拾うスクリプトの見本は、前の記事に全文を載せています。

https://note.com/hirajo/n/n87acd96946a3

私の実例2:毎日打つ /resume と、/handoff、/deploy

次は、スラッシュで呼ぶ例です。 私は、毎日、/resume を打っています。 前の続きを、再開するコマンドです。

ほかに、/handoff と /deploy も、よく使います。

  • /handoff は、次の作業への引き継ぎを保存します
  • /deploy は、用意した手順どおりに、本番へ出します

deploy は、プログラミングをやっていない方には、馴染みが薄い言葉だと思います。 自分が開発している環境を、実際に運用している本番の環境に反映する作業のことです。

/handoff と /resume は、2つで1組

/handoff は、続きに要ることだけを、短いメモにして保存します。 保存先は、プロジェクトの .claude の下の handoff フォルダで、handoff_日時.md という名前になります。

メモの先頭には、フロントマターで、使っている端末の識別子(terminal_id)、プロジェクト名、日時、ブランチ、作業の1行説明を書きます。 /resume は、このメモを探して読み込みます。 探し方は、2段階です。

1.まず、いま使っている端末と同じ端末の識別子のメモを探す 2.見つからないときは、同じプロジェクトのメモを探す

私は、複数のターミナルで、並行して Claude Code を動かしています。 それでも、タスクの名前を指定せずに、このターミナルの続きが再開できます。

標準の機能との違い

この handoff と resume の組み合わせは、私のオリジナルです。 標準にも、似た機能があります。 違いを、表にしました。

方法何を持ち越すか
claude --continue現在のフォルダで、直近の会話をそのまま再開する(公式の Common workflows)
claude --resume、標準の /resume会話の一覧から選んで、会話を再開する
/compact会話を要約して、同じ会話を続ける。何を残すかは、Claude が決める
私の /handoff と /resume続きに要ることだけを、ファイルに残す。新しい会話が軽く始まる。ファイルなので、私も読めて、中身を見て直せる

標準の再開は、会話を丸ごと持ち越します。 私の handoff は、続きに要ることだけをファイルに残します。 なので、新しい会話が軽く始まり、そのファイルは、私も読めます。

公式の /resume を、自作で上書きしている

もう1点あります。 公式にも /resume はあります。 私は、その公式の /resume を、自作で上書きしています。

上の「同じ名前があるとき」の表のとおり、公式は、自作が標準のコマンドを置き換える仕様です。 私は、2026年11月8日に /resume と打って、自作のほうが動いた画面の記録を確かめています。

公式の一覧は、claude --resume で、今も使えます。 公式の Commands のページでも、claude --resume は、会話の一覧から選ぶ方法として書かれています。

/deploy には、苦い経験がある

/deploy には、苦い経験があります。 手順が用意してあるのに、Claude Code が、その場で自己流のコマンドを組み立ててしまったことがありました。 それ以来、出す手順は、決まったコマンドで呼ぶようにしています。

私の実例3:コマンドが増えて、名前を覚えきれない

コマンドは、便利です。 ただ、増えると困ります。

動画では、私のコマンドは76個あると話しました。 11月17日に、~/.claude/commands の .md のファイルを数え直すと、79個でした。 スキルのフォルダは、47個です。

メニューが76種類ある店で、全部の名前を暗記して注文するようなものです。 コマンドは、作るのは簡単です。 困るのは、増えた後の運用です。

なので私は、名前を思い出せないときは、ふだんの言葉で頼みます。 「この作業をやっておいて」と、書くだけです。 スキルの説明文に合えば、Claude がそのスキルを読んで、動かしてくれます。

もう1つ、地味な理由があります。 スラッシュは、半角です。 日本語入力のままだと、切り替えが面倒です。

説明文が合わなければ、動かない

スキルを言葉で呼ぶ方法には、確認しておくことが1つあります。 公式の Troubleshooting によると、スキルは、作るだけでは使われないことがあります。 Claude は、説明文(description)を見て、使うかどうかを決めるからです。

動かないときの確認の順番は、公式に6つ書かれています。

1.description に、自分が普段言う言葉が入っているか見る 2.「What skills are available?」と聞いて、一覧にそのスキルがあるか見る 3.description に合う頼み方に、言い換えてみる 4./スキル名 と打って、直接呼んでみる 5./スキル名 でも認識されないときは、名前が受け付けられたか確かめる 6.paths を書いているときは、作業中のファイルが、その範囲の中にあるか見る

数が増えると、別の確認も要ります。 公式によると、Claude Code は、スキルの名前と説明文の一覧を、文脈に読み込んでいます。 スキルの名前は、いつも全部載りますが、スキルが多いと、説明文の一部が一覧から外れます。 その一覧の上限は、モデルの文脈の大きさの1%です。 説明文が外れると、Claude が頼みの内容と照らし合わせる手がかりがなくなります。 使う頻度の低いスキルから、順に外されます。

どれくらい使っているかは、/doctor で見積りが出ます。 上限を上げる設定(skillListingBudgetFraction)もあります。

名前を指定しないと、困ったこと

名前を指定しないことで、困ったこともありました。

私は、Kagemusha という自作の Mac アプリを作っています。 ウェブサイトを、Claude Code から操作できるようにするアプリです。 あるとき、Claude が、スキルを通さずに、自己流でそのアプリを動かしました。 そのため、製品の窓が、私の画面の一番前に出てきて、私の作業の邪魔になりました。

原因は、「必ずスキルを通す」と書いた場所が、どこにも無かったことです。 それ以来、本番に出すような手順は、一度スキルに書いて、「必ず使う」と明記します。 書いた場所が無いと、Claude は、自己流で動いてしまうからです。

使い分けの基準

3つの実例を、振り返ります。

  • 再発防止は、言葉だけで動きました
  • /resume は、スラッシュで呼びました
  • 名前を忘れたときは、ふだんの言葉で頼みました

どれも、中身は、決まった手順を書いた手順書です。

私の基準は、1つです。 毎回打つのが面倒で、間違えたくない物は、コマンドにします。 それ以外は、スキルのままで、言葉で頼みます。 どうしても守らせたい物は、さっきの再発防止のように、フックで拾います。

順番は、まずスキル、次にコマンド、最後にフックです。

作る順番はスキル、コマンド、フック。1まずスキルで作る、2毎回打つのが面倒で間違えたくない物だけコマンドにする、3どうしても守らせたい物はフックで拾う

この基準を、表にします。

こういう手順作り方呼び方
頼めば Claude が探してくれればよい。名前を覚えたくないスキルふだんの言葉で頼む
毎回打つのが面倒で、間違えたくないスキルを作って、コマンドとして呼ぶ/名前 と先頭に書く
勝手に動かれたら困る(本番へ出す、送信する)スキルに disable-model-invocation: true を書く/名前 と先頭に書く(Claude は自分では呼ばない)
どうしても守らせたい。覚えている前提にできないフック決めた言葉をプログラムが拾う

スキルは、頼めば Claude が探してくれるので、名前を覚えなくて済みます。 コマンドは、名前を覚える代わりに、確実に呼べます。 この違いが、使い分けの軸です。

スキルを、コマンドとして使える形にする手順

「コマンドにする」といっても、新しく別の物を作るわけではありません。 スキルを、/名前 で確実に呼べる形にそろえます。 公式の説明に沿って、手順にします。

1.スキルを作る

~/.claude/skills/名前/SKILL.md を作ります。 フォルダの名前が、そのまま /名前 になります。

2.説明文(description)を書く

何をするスキルか、いつ使うかを書きます。 言葉で頼んだときに、Claude が見つけるための手がかりになります。 主な用途を先頭に書きます。説明文は、一覧では1,536文字で切られます。

3.勝手に動かれたら困るなら、disable-model-invocation を足す

本番へ出す手順や、送信する手順には、フロントマターに disable-model-invocation: true を書きます。 こうすると、Claude は自分では呼ばず、/名前 と打ったときだけ動きます。

4.引数を受け取るなら、$ARGUMENTS を使う

/名前 の後ろに書いた文字は、本文の $ARGUMENTS の場所に入ります。 公式の例では、/fix-issue 123 と打つと、本文の $ARGUMENTS が 123 に置き換わります。 引数が必要なスキルには、argument-hint で、打つときの目印を出せます。

次の見本は、私の /handoff の考え方を、写せる形にしたものです。 そのままの全文ではなく、中心の部分だけを載せています。

--- name: handoff description: 次の作業への引き継ぎを、続きに要ることだけ短いメモにして保存する。「引き継ぎを残して」と頼まれたときに使う。 disable-model-invocation: true ---

## 手順

1.いま使っている端末の識別子を、echo "$TERM_SESSION_ID" で取得する 2.プロジェクトの .claude/handoff/ に、handoff_日時.md という名前で保存する 3.先頭に、端末の識別子、プロジェクト名、日時、作業の1行説明を、フロントマターで書く 4.本文には、いま終わっていることと、次にやることだけを書く。長い経緯は書かない 5.保存したファイルのパスを、私に知らせる

5.試す

/handoff と打って、動けば完成です。 公式によると、~/.claude/skills/ の中のスキルは、会話の途中で追加や編集をしても、再起動なしで反映されます。 ただし、~/.claude/skills/ というフォルダ自体が、セッションの開始時に無かった場合は、/reload-skills を打つと読み込まれます。

すでにあるコマンドのファイルを、スキルにする

以前の .claude/commands/ のファイルを、スキルに変えたいときは、公式に手順があります。 たとえば、.claude/commands/deploy.md を、.claude/skills/deploy/SKILL.md に移します。 フォルダの名前が、そのままコマンドの名前になるので、/deploy と打つ動きは変わりません。 補助のスクリプトを、同じフォルダに入れられるようになります。

コマンドにする作業も、手では書かない

コマンドにするときも、私は手で書きません。 「コマンドにしておいて」と、Claude Code に頼むだけです。 スキルも、同じです。

頼む文の例は、この後にあります。

日本語の名前は、使えるか

日本語の名前も、使えるのかと、気になる方がいると思います。

公式の Extend Claude with skills のページにある、Characters a skill name can't hold の項目には、名前に使えない文字が書かれています。 ゼロ幅のスペースや制御文字、文字の向きを変える文字、連続した空白、角括弧(< >)などです。 日本語は、この一覧に含まれていません。

ただ、私は、動かしたことがありません。 切り替えが面倒だからです。 例外は、「再発防止」ぐらいです。 これは、スラッシュで呼ぶ名前ではなく、フックが拾う言葉です。

なので、日本語の名前が、実際に動くかどうかは、私は確かめていません。 試すときは、claude --debug で、名前が受け付けられたかを確認できます。

はじめの疑問への答え

はじめの3つの疑問に、答えます。

  • どちらで作るか。まず、スキルで作ります
  • 裏でスキルを呼んでいるだけか。はい、スキルの呼び方です
  • ショートカットか。毎回打つのが面倒な物には、そのとおりです

Claude に頼む文

そのまま、Claude Code に貼れます。 「〇〇」は、自分のものに直してください。

動画で話した頼み方です。

「この作業を、コマンドにしておいて」

次の4つは、この記事の手順に合わせて、私が書いた頼み方の例です。

1.いまの手順を、スキルにしておいてください。保存する場所は、私に確かめてから決めてください

2.いまの手順を、スキルにして、/〇〇 と打てば動く形にしておいてください。Claude が勝手に呼ばないように、disable-model-invocation: true も書いてください

3.いま ~/.claude/commands/ にある〇〇のファイルを、スキルのフォルダに移して、/〇〇 と打つ動きは変えないでください

4.これは、スキル、コマンド、フックのどれにするのがよいか、理由を添えて教えてください

まとめ

コマンドは、スキルの呼び方です。 迷ったら、スキルで作って、「コマンドにしておいて」と、一言で頼みます。 毎回打つのが面倒な物だけ、コマンドにしてください。

ご質問があれば、コメント欄に書いてください。 私が直接目を通して、必ず回答します。

読んだ公式ページ

2026年11月17日に確認しました。

Extend Claude with skills(Claude Code の公式ドキュメント。コマンドとスキルの統合、置き場所、名前の決まり方、同じ名前の優先順位、呼べる人の設定、引数、うまく動かないとき) https://code.claude.com/docs/en/skills

Commands(Claude Code の公式ドキュメント。組み込みのコマンドと付属のスキルの一覧) https://code.claude.com/docs/en/commands

Common workflows(Claude Code の公式ドキュメント。claude --continue と claude --resume) https://code.claude.com/docs/en/common-workflows

Automate workflows with hooks(Claude Code の公式ドキュメント。フックの作り方) https://code.claude.com/docs/en/hooks-guide

シェア
#Claude Code#スキル#コマンド#スラッシュコマンド#SKILL.md#フック
平城寿
平城 寿(ひらじょう ひさし)
インディーハッカー。2004年に@SOHOを創業し、20年間1人で運営。
フォロー

関連記事