本文へスキップ

本ページはプロモーションが含まれています

AI

Claude Codeスラッシュコマンド一覧|自作の作り方と実例

CATEGORY
DRAWN BY
TOM
DATE
REV.
READ
約27分
SHEETS
10枚
スラッシュコマンド(一覧と自作の作り方)

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

Claude Codeで / を打つと、候補が何十個も並びます。公式の一覧表は121行あり、全部を覚える必要はありません。

会話の切り替え・文脈の整理・権限の設定あたりから覚えれば、日々の作業は回ります。残りは困ったときに探す索引です。

自作したいなら、.claude/skills/<名前>/SKILL.md を置けば /名前 で呼べます。以前の .claude/commands/ に置いたファイルも、そのまま動きます。

この記事では、組み込みコマンドを用途別に別名つきで並べます。自作の作り方は、手元の Claude Code v2.1.310 で動かした結果つきです。私のリポジトリにある自作コマンド14本・スキル18本の中身も出します。

この記事でわかること

  • 組み込みコマンドの用途別一覧と、/clear と /reset のような別名
  • .claude/commands と Skills の関係(統合の経緯と、今の置き場所)
  • 引数 $ARGUMENTS・$0・$1 の使い方と、実際に動かした結果
  • 自作14本・スキル18本の中身と、ハマった2か所

PARTS LIST /目次

Claude Codeのスラッシュコマンドとは?3つの種類

スラッシュコマンドとは、メッセージの先頭に / を付けて Claude Code 自体を操作する入口です。モデルの切り替え、会話のリセット、権限の設定、定型作業の呼び出しまで、同じ書き方でそろっています。

由来で分けると3種類あります。CLI に内蔵された組み込み、Claude に渡すプロンプトとして動くバンドルスキル、自分で置く自作です。入力のルールは3種類とも共通なので、先にそちらを押さえます。

組み込み・バンドルスキル・自作の違い

組み込みコマンドは、動きが CLI の中にコードで書かれた処理です。/clear や /model がこれにあたります。

バンドルスキルは、最初から入っているスキルです。自分で書くスキルと同じく、実体は Claude に渡すプロンプトです。公式の一覧表では /code-review・/simplify・/loop・/batch などに印が付いています。

自作は、自分で置いた SKILL.md(または旧来の .claude/commands/ のファイル)です。MCP サーバーが公開するプロンプトも、同じ / のメニューにコマンドとして並びます。

種類実体例
組み込みCLI に内蔵された処理/clear・/model・/resume
バンドルスキル最初から入っているスキル(プロンプト)/code-review・/simplify・/loop
自作自分で置いた SKILL.md か commands のファイル/hello(この記事で作る例)
MCP プロンプトMCP サーバーが公開するプロンプトサーバーごとに異なる

入力のルール|先頭だけ有効・引数・連鎖

コマンドとして認識されるのは、メッセージの先頭にあるときだけです。コマンド名の後ろに書いた文字は、そのまま引数になります。

  • / に続けて文字を打つと候補が絞り込まれる。/adddir でも /add-dir に当たる(区切りの - _ : は無視される)
  • 打ち間違えると、候補は並ぶのに Enter は入力した文字のまま送られ、Unknown command になる
  • Claude の応答中に送ったコマンドは待ち行列に入り、そのターンの後に動く。/status・/tasks・/usage は割り込まずに即実行される
  • 端末では /skill-a /skill-b 依頼文 のように、1つのメッセージで最大6個のスキルを連鎖できる。後ろの文は各スキルに引数として渡る
  • プランや OS、環境によって、出ないコマンドがある(/desktop は macOS と x64 Windows で Claude のサブスクにログインしているときだけ)。/heapdump のように、メニューには出さず名前を最後まで打てば動くものもある

組み込みコマンド一覧|用途別に別名つきで整理

公式の一覧表(Commands)は121行あり、その3行は「削除済み」と明記されたコマンドです。この節では、日常の作業で出番がありそうなものを4つの用途に分けました。

別名は表の「別名」列に入れています。引数の <> は必須、[] は省略可です。全件が必要なときは、公式の表か、手元の /help を見てください。

作業の流れで見ると、この順番で使う

コマンドを用途ではなく流れで並べると、使う順番が見えてきます。計画から入り、文脈が重くなったら整理し、最後に差分を確かめる流れです。

flowchart TD
    A["/init<br>CLAUDE.mdの雛形を作る"] --> B["/plan<br>実装前に計画だけ出す"]
    B --> C["実装を任せる"]
    C --> D{"文脈が重くなった?"}
    D -->|"同じ作業を続ける"| E["/compact<br>要約して空ける"]
    D -->|"別の作業へ移る"| F["/clear<br>空の会話で始める"]
    E --> G["/diff<br>変更を確認"]
    F --> G
    G --> H["/code-review<br>バグを探す"]

文脈の重さは /context で見られます。/compact と /clear の使い分けは、同じ話題を続けるか、別の作業に移るかで決まります。会話を戻したり分岐したりする話は、Claude Codeセッション再開ガイドにまとめています。

会話そのものを操作するコマンド

会話の開始・要約・再開・分岐・巻き戻しを扱うグループです。長く使うほど出番が増えます。名前の違う別名がいちばん多いのも、このグループです。

コマンド別名できること
/clear [名前]/reset /new空の会話で新しく始める。名前を付けると /resume の一覧で見分けられる
/compact [指示]なし会話を要約して文脈を空ける。要約の観点を指示で渡せる
/context [all]なし文脈の使用状況をグリッドで表示する。重いツールやメモリの肥大の改善案も出る
/resume [セッション]/continue過去の会話をIDか名前で再開する。引数なしで一覧が開く
/branch [名前]なし今の時点で会話を分岐する。元の会話は /resume で戻れる
/fork [プロンプト]なし会話を複製して別のバックグラウンドセッションにし、こちらは続ける
/subtask <作業>なし会話を引き継ぐサブエージェントに作業を渡す。結果は終わると戻ってくる
/rewind/checkpoint /undoコードと会話を以前の時点に戻す。選んだメッセージから要約もできる
/rename [名前]なしセッション名を付ける。引数なしなら会話から自動で付く
/recapなし今のセッションを1行で要約する
/btw [質問]なし会話に残さない脇の質問をする
/export [ファイル名]なし会話をテキストで書き出す
/copy [N]なし直近の返答(N番目に新しいもの)をクリップボードへコピーする
/exit/quitCLI を終了する
/cd <パス>なし会話を保ったまま作業ディレクトリを移す
/add-dir <パス>なしファイルを読み書きできるディレクトリを足す

/clear した会話は消えません。/resume で戻せるので、「リセットしたら全部消えた」という心配は要りません。

設定・権限・モデルを整えるコマンド

作業の前提を決めるグループです。初回のセットアップと、「なぜか承認を何度も求められる」といった違和感の調整で使います。

コマンド別名できること
/initなしCLAUDE.md の雛形を作る
/memoryなしCLAUDE.md を編集する。自動メモリの有効・無効と中身の確認もできる
/model [モデル]なしモデルを切り替え、新しいセッションの既定にも保存する
/effort [レベル]なし推論の深さ(low から xhigh、max、auto)を設定する
/fast [on か off]なし高速モードを切り替える
/permissions/allowed-tools許可・確認・拒否のルールを、範囲ごとに表示・追加・削除する
/config [key=value]/settings設定画面を開く。/config verbose=true のように直接値も入れられる
/mcpなしMCP サーバーの接続と認証を管理する
/hooksなし設定済みの hooks を表示する
/agentsなしサブエージェントの作成・管理を Claude に頼むよう案内する
/skillsなし使えるスキルの一覧。t でトークン数順に並べ替えられる
/pluginなしプラグインを管理する
/reload-skillsなしスキルとコマンドのディレクトリを再走査し、再起動なしで反映する
/statuslineなし画面下のステータスラインを設定する
/themeなし配色テーマを変える
/keybindingsなしキーボードショートカットのファイルを開く
/terminal-setupなしVS Code や Cursor などで Shift+Enter の改行を使えるようにする
/sandboxなしサンドボックスモードを切り替える(対応する環境のみ)
/login /logoutなしAnthropic アカウントにサインイン・サインアウトする

/permissions に足すルールの具体例は、Claude Codeおすすめ設定5選に載せています。/mcp の先はMCP設定ガイド、/hooks の先はhooksの使い方です。

計画・並列・自動実行に使うコマンド

「先に計画を出させる」「同時に何本も走らせる」「放っておいて任せる」を担当するグループです。バンドルスキル(表では「スキル」と記載)も混ざっています。

コマンド別名できること
/plan [説明]なしプロンプトからそのまま plan mode に入る。/plan 認証バグを直す のように作業も渡せる
/goal [条件]なし条件を満たすまで、Claude がターンをまたいで作業を続ける
/loop [間隔] [プロンプト]/proactiveスキル。セッションを開いたまま、プロンプトを繰り返し実行する。間隔を省くと Claude が自分でペースを決める
/schedule [説明]/routinesクラウドの定期実行タスクを作る・更新する・一覧する・走らせる
/background [プロンプト]/bg今のセッションをバックグラウンドに切り離し、端末を空ける
/batch <指示>なしスキル。大きな変更を5〜30の独立した単位に分け、worktree ごとにサブエージェントを走らせる
/tasks/bashesこのセッションのバックグラウンド作業(終わったサブエージェントも含む)を見る
/autofix-pr [プロンプト]なしクラウドのセッションが今のブランチの PR を見張り、CI の失敗やレビューコメントに修正を push する
/remote-control/rcこのセッションを別の端末から操作できるようにする
/teleport/tpクラウドのセッションをこの端末に引き取る
/desktop/app今のセッションを Claude Code のデスクトップアプリで続ける
/deep-research <質問>なしワークフロー。Web 検索を並べて出典を突き合わせ、引用つきの報告書にまとめる

/plan は plan mode へ入る近道です。plan mode 自体の使い方はPlanモードの解説、並列に走らせる土台のサブエージェントはサブエージェントの使い方にあります。

レビュー・診断・使用量を見るコマンド

作業の結果を確かめるときと、おかしいときに使うグループです。同じ中身に複数の名前があるものが目立ちます。

コマンド別名できること
/diffなし作業ツリーの変更(Claude が入れた編集も含む)を見る
/code-review [レベル] [pr番号]/reviewスキル。差分か PR の正しさに関わるバグを探す。--fix で修正まで、--comment で PR へのコメント投稿まで行う
/security-reviewなしブランチの変更から、インジェクションや認証まわりの脆弱性を探す
/simplify [対象]なしスキル。変更したコードの再利用・単純化・効率を見直して直す。バグ探しはしない
/verifyなしスキル。アプリをビルド・起動して、変更が意図どおり動くかを観察する
/doctor/checkupインストール・設定・CLAUDE.md の問題を診断し、確認のうえで直す
/debug [説明]なしスキル。デバッグログを有効にし、そのログを読んで原因を探る
/usage/cost /statsセッションのコスト、プランの使用量上限、利用の統計を表示する
/statusなしバージョン・モデル・アカウント・接続状況を表示する
/insightsなし直近のセッションを分析した HTML レポートを作る
/skill-doctorなしスキルごとの文脈コストと使用頻度を表示し、無効にする候補を探す
/release-notesなし変更履歴をバージョン別に見る
/bug [報告]/shareバグ報告や会話の共有を送る。送る範囲は同意画面で選ぶ
/feedback [報告]なし製品へのフィードバックを送る
/helpなしヘルプと使えるコマンドの一覧を出す

/usage には別名が2つあります。/cost と /stats は、どちらも /usage を開くだけです。古い記事で /cost を見かけても、/usage で同じ画面に着きます。

使えなくなったコマンドと、残りのバンドルスキル

一覧表には、すでに削除されたコマンドが「Removed」と書かれたまま残っています。/vim は v2.1.92 で消え、今は /config の Editor mode で切り替えます。/pr-comments は v2.1.91 で消えました。

古い記事のコマンドは、今はないことがある
/vim と /pr-comments は v2.1.9x 系で削除され、/ultraplan も表上は削除済みです(代わりは plan mode)。古い記事を見て打つと Unknown command で止まります。迷ったら /help か公式の一覧表で、今の版に残っているかを確かめるのが早いです。

公式の表でスキルの印が付いているのは20個です。うち7個(/batch・/code-review・/debug・/doctor・/loop・/simplify・/verify)は上の表に入れたので、残りの13個を並べます。

コマンドできること
/update-config [依頼]設定の変更(コマンドの許可、環境変数、hooks の追加)を頼むと、該当する settings.json を Claude が編集する
/fewer-permission-prompts記録から読み取り専用の Bash や MCP の呼び出しを拾い、許可リストを .claude/settings.json に足す
/claude-api [サブコマンド]Claude API と Managed Agents の資料を、プロジェクトの言語に合わせて読み込む。anthropic を import したコードでは自動でも有効になる
/runアプリを起動して動かし、変更が効いているかをテストの外で確かめる
/run-skill-generator/run と /verify にアプリの起動方法を教えるスキルを、プロジェクトごとに書く
/claude-in-chrome [作業]Chrome 拡張を通して、ページのテストやフォーム入力、コンソールの確認をブラウザで行う
/dataviz [依頼]グラフやダッシュボードの設計指針。データに合う形を選び、色の割り当てと配色の検証までする
/design [概要]画面の試作・画面遷移・ランディングページを、1枚のキャンバスに並べる(アーティファクトが使える環境のみ)
/design-sync [ヒント]リポジトリの React デザインシステムを変換し、Claude Design に上げる
/slides [概要]指示からスライドを作る(アーティファクトが使える環境のみ)
/artifact-capabilities公開するアーティファクトが使える機能(コネクタの呼び出しなど)の資料を読み込む
/artifact-diagrammingアーティファクト内の図の描き方の指針を読み込む
/workflow-authoring動的ワークフローのスクリプトを書くための資料を読み込む

毎日使うものではないので、必要になった日に /help で探せば足ります。

自作コマンドの作り方|commandsとSkillsの関係

自作コマンドは、今は Skills の1機能として作ります。呼び出しは /名前 のまま、置き場所は .claude/skills/<名前>/SKILL.md です。

この節では、統合の経緯と置き場所の表、動く最小の例、引数の置き換え、frontmatter、シェル出力の差し込み、同名のときの優先順位を順に書きます。例はすべて、手元の Claude Code v2.1.310 で実行した結果です。

commandsがSkillsに統合された経緯と、今の置き場所

カスタムコマンドは、スキルに統合されました。既存の .claude/commands/ のファイルは、そのまま動きます。Claude が自分で呼び出せるようにもなりました(Skills のドキュメントに統合の説明があります)。

新しく作るなら、スキルが勧められています。理由は、スキルならスクリプトやテンプレートといった補助ファイルを同じフォルダに置けるからです。.claude/commands/deploy.md を .claude/skills/deploy/SKILL.md に移しても、フォルダ名がコマンド名になるので、/deploy の呼び方は変わりません。

場所パス読み込まれる範囲
個人~/.claude/skills/<名前>/SKILL.mdこのマシンのすべてのプロジェクト
プロジェクト.claude/skills/<名前>/SKILL.mdそのリポジトリのセッション(コミットすればチームにも届く)
入れ子<サブフォルダ>/.claude/skills/<名前>/SKILL.mdそのサブフォルダの中で始めたセッション
旧来のコマンド.claude/commands/<名前>.md今も動く(同名のスキルがあればスキルが優先)
プラグイン<プラグイン>/skills/<名前>/SKILL.md有効にした場所。/プラグイン名:スキル名 で呼ぶ

スキル全般(Claude.ai での使い方や API 経由の組み込み)は、Claude Skillsの解説記事に書いています。この記事では、スラッシュコマンドとして呼ぶ側に絞ります。

最小の自作コマンドを作って呼ぶ

最初の1本は、名前と一言を受け取って挨拶を返す /greet にします。作業は3つです。

step
1
フォルダを作る

プロジェクト直下に .claude/skills/greet/ を作ります。フォルダ名がそのままコマンド名になります。

step
2
SKILL.md を書く

greet フォルダの中に SKILL.md を置きます。上の --- で囲んだ部分が frontmatter、下が Claude に渡る本文です。

---
description: 引数で受け取った名前に、あいさつの一文を返す
disable-model-invocation: true
argument-hint: "[名前] [ひとこと]"
---

$0 さんに、次のひとことを添えたあいさつを1文で返してください。

ひとこと: $1

受け取った引数の全体: $ARGUMENTS

step
3
/greet で呼ぶ

端末から -p で動かすと、次の結果になりました。$0 が トム、$1 が おつかれさま です に置き換わってから Claude に渡っています。

claude -p --model haiku --add-dir ./demo -- "/greet トム 'おつかれさま です'"
トムさん、おつかれさまです。

--add-dir の後ろに -- を置く
--add-dir は複数のパスを受け取る引数なので、そのままではプロンプトまで食べてしまい、Input must be provided と怒られます。-- で区切ると解決します。

セッションを開いたまま SKILL.md を足した場合は、/reload-skills を打てば再起動なしで拾われます。普段の対話では、/ に続けて greet と打てば候補に出ます。

引数の渡し方|$ARGUMENTS・$0・$1

引数の置き換えには4つの書き方があります。$ARGUMENTS は全部、$0 $1 は位置、名前付きの $name は frontmatter の arguments に宣言して使います。

どれも本文に書くだけで、呼び出し時に置き換わります。本文に引数の置き場所を1つも書かなかったときは、末尾に ARGUMENTS: <値> として自動で足されます。

書き方中身
$ARGUMENTS渡した引数の全部
$ARGUMENTS[N] / $NN 番目の引数(0から数える)。$0・$1 と略せる
$namefrontmatter の arguments に宣言した名前付きの引数
${CLAUDE_SESSION_ID}今のセッションID
${CLAUDE_SKILL_DIR}その SKILL.md があるフォルダ

位置引数はシェルと同じクォートの規則で分かれます。空白を含む値は、引用符で囲めば1つの引数になります。実際に確かめた結果が次です。

名前=$0
ひとこと=$1
全体=$ARGUMENTS
名前=トム
ひとこと=おつかれさま です
全体=トム 'おつかれさま です' 3つ目

/show トム 'おつかれさま です' 3つ目 と打ったとき、'おつかれさま です' は $1 に1つの値として入りました。$ARGUMENTS は入力したままの文字列です。

位置ではなく名前で受けたいときは、frontmatter の arguments に名前を宣言します。次のスキルを /named 東京 大阪 で呼ぶと、$from が 東京、$to が 大阪 に置き換わりました。

---
description: 名前付き引数の置き換えを確かめる
disable-model-invocation: true
arguments: [from, to]
---

出発=$from
到着=$to
出発=東京
到着=大阪

リストはカンマで区切る
最初に arguments: [from to] と書いたら、置き換えは起きず、$from が文字のまま出ました。YAML では、カンマのない [from to] が「from to という1つの名前」になるためです。空白区切りで書くなら arguments: from to、リストなら [from, to] にします。

ドル記号の後ろに数字が続く文章($1.00 のような金額)を本文に書きたいときは、\$1.00 と逆スラッシュで逃がします。

frontmatter の主な項目

frontmatter は、SKILL.md の先頭を --- で囲んだ部分です。全項目が省略可ですが、description だけは書いておくと、Claude がいつ使うかを判断できるようになります。

項目何を決めるか
name/ メニューに出るコマンド名。省略するとフォルダ名
description何をするか、いつ使うか。省略すると本文の最初の空でない行が使われる
argument-hint補完時に出すヒント(例: [issue-number])
arguments$name で使う名前付き引数。空白区切りか YAML のリスト
disable-model-invocationtrue で、Claude が勝手に呼ぶのを止める(既定は false)
user-invocablefalse で / メニューから隠し、Claude だけが呼ぶ(既定は true)
allowed-toolsこのスキルのターンの間、確認なしで使えるツール
model / effortこのターンだけ使うモデルと推論の深さ
context: forkサブエージェントの別の文脈で動かす(agent で種類を選ぶ)
paths該当するファイルを触ったときに有効になる、glob パターン
hooks呼ばれたときに登録され、セッションの間動き続ける hooks

呼び出しの権限は、2つの項目の組み合わせで決まります。

frontmatter自分で呼べるClaude が呼べる
指定なし呼べる呼べる
disable-model-invocation: true呼べる呼べない(自分が打ったときだけ動く)
user-invocable: false呼べない呼べる

/deploy や /commit のように、実行のタイミングを自分で握りたい作業は disable-model-invocation: true が向きます。作業の背景知識だけを持たせたいなら user-invocable: false です。

シェルの出力を本文に差し込む方法

本文に ! とバッククォートで囲んだコマンドを書くと、Claude に渡る前にシェルで実行され、出力が差し込まれます。Claude は、コマンドそのものではなく結果を受け取ります。

$0 の置き換えは、このコマンドの中でも効きます。ファイルの行数を数える /lines を作って、実際に動かしました。

---
description: 指定したファイルの行数を数えて、長さを一言で評価する
argument-hint: "[ファイルのパス]"
disable-model-invocation: true
---

## 行数

!`wc -l $0`

## 指示

上の結果を見て、そのファイルが長いか短いかを1文で答えてください。余計な説明は付けません。

594行ある自作コマンドのファイルを渡すと、こう返ってきました。

長い(594行)です。

複数行にするときは、```! で始まるコードフェンスで書けます。コマンドが失敗すると、スキルの呼び出しごと中断します。失敗しても進めたいコマンドは、末尾に || true を付けます。

ハマりポイント
! は行頭か空白の直後にしか効かない

最初に 差し込み=!`echo shell-output-ok` と書いたら、シェルは動かず、文字のまま Claude に渡りました。= の直後は対象外です。差し込み= !`echo shell-output-ok` のように空白を1つ入れると動き、shell-output-ok に置き換わりました。行頭に置くのが無難です。

引数が Claude に届くまでの流れは次の図のとおりです。置き換えは Claude に渡る前に済んでいます。

flowchart TD
    A["入力<br>/greet トム 'おつかれさま です'"] --> B["Claude Codeが置き換え<br>$0=トム / $1=おつかれさま です"]
    B --> C["行頭の ! 行はシェルで実行<br>出力を本文へ差し込む"]
    C --> D["完成した本文をClaudeに渡す"]
    D --> E["Claudeが実行して返答"]

同名のものがあるときの優先順位

同じ名前が複数の場所にあるとき、どれが動くかには決まりがあります。自作が組み込みを上書きできる点だけ、先に知っておくと混乱しません。

競合する組み合わせ動くもの
エンタープライズ・個人・プロジェクトのうち2か所エンタープライズが個人に勝ち、個人がプロジェクトに勝つ
自作とバンドルスキル自作(ただし別名は上書きしない)
自作と組み込みコマンド(端末のセッション)自作(ただし別名は上書きしない)
スキルと .claude/commands/ のファイルスキル
プラグインのスキルと他の場所のスキル両方読み込まれる。プラグイン側は /プラグイン名:スキル名 で呼ぶ

自分の ~/.claude/skills/deploy/ とプロジェクトの deploy があれば、/deploy は個人のほうが動きます。チームで共有したい名前は、個人側と重ならないようにするのが安全です。

自作を一時的に全部止めて調べたいときは、起動オプションを使います。claude --disable-slash-commands はすべてのスキルとコマンドを無効にします。claude --safe-mode は、CLAUDE.md・hooks・MCP・自作コマンドなどをまとめて無効にして起動します。

私の自作コマンド14本とスキル18本の中身

この節は、このリポジトリで実際に数えた値と中身です。.claude/commands/ には21ファイルがあり、18フォルダが .claude/skills/ にあります。

全部が同じ役割ではありません。呼ぶファイルと共通ルールを分け、フォルダには補助ファイルを置くものと置かないものがあります。数と置き場所の内訳から順に出します。

LOGこの記事を書くとき数えたら、コマンド14本・スキル18本だった

自作の数を書こうとして、フォルダを数え直しました。.claude/commands/ は21ファイルで、先頭が _ の7つは共通ルールの置き場です。呼び出して使うのは残りの14本。.claude/skills/ は18フォルダでした。

行数は、いちばん長いものが594行、リライト系は190〜353行です。

数と置き場所の内訳

置き場所ごとの数を表にまとめます。数は、書く前にファイルとフォルダを数えた値です。

場所数中身
.claude/commands/21ファイル呼ぶ14本+共通ルール7つ(先頭が _)
.claude/skills/18フォルダすべて SKILL.md あり。うち5つは補助ファイルも同じフォルダに置く
frontmatter(commands)0本14本とも書いていない
frontmatter(skills)18本18本とも name と description を書いている(argument-hint などは使っていない)

.claude/commands/ の14本は、どれも $ARGUMENTS を本文で使っています。スキルの18本の中身は、おおまかに次の分け方です。

  • ブログ記事の企画・執筆・補助(キーワード提案、書評、ポイ活アプリの紹介、絵本形式の解説、メタディスクリプション、図解): 8本
  • 収益化とリライトの優先度づけ、商品リンクの挿入: 4本
  • 文章の書き方の規範(緩急、技術文書の日本語): 2本
  • 記事・SNSの下書き投稿: 2本
  • 動画の自動編集: 1本
  • スクリプトの実行方法の早見表: 1本

14本の役割

14本は、新規記事を書く、リライトする、内部リンクを足す、商品リンクを入れる、の4種類に分かれます。リライトは、1つの観点だけを直す単独版が8本、全部を順に回す版が1本、指示書に従って直す版が1本です。

役割本数呼び出しの単位
新規記事の作成1本キーワードを渡すと、調査・構成・執筆・下書き保存まで進める
リライトの一括実行2本全観点を順に回す版と、指示書に従って直す版
リライトの観点別8本検索意図・構成・鮮度・独自性・読みやすさ・LLMO・事実確認・装飾を1つずつ
内部リンク2本提案して承認後に入れる版と、自動で追記する版
商品リンク1本位置・アンカー・誘導文を提案する

14本とも、引数の形式は本文に書いています。$ARGUMENTS に入った「記事ID・キーワード・サイトの指定」を、文章で決めた形式のとおりに Claude が読み分ける作りです。$0 $1 のような位置引数は、14本のどこにも使っていません。

引数の数が固定なら、$0 $1 のほうが読み違えがなく、確実です。順番が変わったり省略されたりする引数は、文章で受け取るほうが書きやすい、というのが私の使い分けです。

実例から見る設計の型|分ける・まとめる・共通化する

14本を並べると、設計の型が3つ見えます。どれも、1本を大きくせず、役割で分ける方向です。コマンドを自作するときの参考になるので、中身を実例として挙げます。

  • 提案版と自動版に分ける:内部リンクは、候補を見せて承認後に入れる版と、そのまま追記する版の2本にしている。確認したいときと、任せたいときで呼び分ける
  • 単独版と一括版を持つ:リライトは、観点を1つだけ直す8本と、全観点を順に回す1本がある。一括版は、メインの会話を進行役にして各段階をサブエージェントに任せる作り
  • 共通ルールを別ファイルに出す:先頭が _ のファイルに共通の手順を書き、リライト系の8本がその手順を読む。記事の書式の定義も同じ形で、新規作成やリライトから読ませている

共通ルールを _ のファイルにしたのは、同じ内容を複数のコマンドに書き写さないためです。ただし、先頭が _ のファイルも / のメニューには現れます。呼ぶものではないので、スキルにするなら references/ に置けば、メニューに出さずに済みます。

frontmatter なしで困ったこと

14本のコマンドには frontmatter が1つもありません。公式の仕様では、frontmatter がないと、description は本文の最初の空でない行になります。

ハマりポイント
14本とも、メニューの説明が「あなたは」で始まる

私の14本は、1行目が全部「あなたは〜です」という役割指定でした。frontmatter を書かないと、この行がそのまま description になります。メニューの説明がどれも「あなたは」から始まり、見分けにくくなります。

直し方は簡単で、frontmatter に description を1行書くだけです。スキルの18本は、name と description を書いているので、この問題が起きません。

コマンドは自分で打って呼ぶもの、スキルは description の言い回しで Claude に拾わせるもの。そう考えて、スキルの description には「〜して」「〜を出して」といった依頼の言い回しも書いています。

14本は今も commands のままで、そのまま動いています。移す目安は、補助ファイルを置きたくなったとき、1本が長くなりすぎて参照資料に分けたくなったときだと考えています。

スラッシュコマンド・Skills・hooks・CLAUDE.mdの使い分け

4つとも「Claude に何かをさせる設定」ですが、動き出すきっかけが違います。迷ったら、「誰が・いつ起動するか」で選ぶと決まります。

仕組み起動するのは向いている用途
スラッシュコマンド(自作)自分が /名前 で呼ぶ毎回同じ手順の依頼。引数で対象を変える
Skills(自動で呼ばれるもの)Claude が description を見て呼ぶ状況を見て使う手順や知識
hooksClaude Code が決まったイベントで自動実行編集後のフォーマット、通知など、必ず走らせたい処理
CLAUDE.md毎回、文脈の一部として読み込まれるプロジェクトの前提と常に守る規約

「必ず実行したい」処理は hooks、「毎回読ませたい」前提は CLAUDE.md、「呼んだときだけ動かしたい」手順はスラッシュコマンドです。hooks はhooksの使い方、CLAUDE.md はCLAUDE.mdとrulesの解説で書いています。

全体の使い方は、先にClaude Codeの使い方まとめを読むと、全体像がつかめます。この記事は、そこで触れた / のコマンドと自作を、一覧と実装の側から掘り下げたものです。

自作コマンドが出ない・動かないときの確認ポイント

自作が呼べないときの原因は、名前・場所・書き方のどれかに収まります。上から順に確かめると早いです。

  • セッション中に SKILL.md を足した: /reload-skills で再走査する
  • フォルダ名とコマンド名が合っているか: name を省略するとフォルダ名が使われる
  • /skills に出るか: 出なければ置き場所(.claude/skills/<名前>/SKILL.md)が違う
  • ! のシェル実行が文字のままになる: ! を行頭か空白の直後に置く
  • 引数が1つにまとまらない: 空白を含む値を引用符で囲む
  • 同名の個人スキルが先に動いている: 優先順位の表を確認する
  • すべて効かない: --disable-slash-commands や --safe-mode で起動していないか確認する
  • シェル実行をまるごと禁止している: 設定の disableSkillShellExecution が true になっていると、! は動かない

試すときは、まず description だけの最小のスキルで呼べるかを確かめ、そこから引数・シェル出力を1つずつ足すと、原因が切り分けやすくなります。

よくある質問

Q1. スラッシュコマンドの一覧はどこで見られますか?

A1. 起動中の Claude Code で / を打つと候補が出ます。/help でも見られます。全件は公式の Commands のページにあり、表は121行あります。プランや環境で出ないものがあるので、手元のメニューが正になります。

Q2. 自作のスラッシュコマンドはどこに置きますか?

A2. プロジェクトなら .claude/skills/ の下にコマンド名のフォルダを作り、その中に SKILL.md を置きます。全プロジェクトで使うなら ~/.claude/skills/ の下に同じ形で置きます。フォルダ名がコマンド名です。旧来の .claude/commands/ のファイルも今は動きますが、新しく作るならスキルが勧められています。

Q3. .claude/commands に置いたコマンドは使えなくなりますか?

A3. なくなりません。カスタムコマンドはスキルに統合されましたが、既存の .claude/commands/ のファイルは、そのまま動きます。同名のスキルがあるときだけ、スキルが優先されます。

Q4. 引数はどう受け取りますか?

A4. 本文に $ARGUMENTS と書けば、渡した引数の全部が入ります。位置で分けるなら $0・$1 です。空白を含む値は引用符で囲むと1つの引数になります。本文に置き場所がないときは、引数の値が末尾に ARGUMENTS: の行として足されます。

Q5. Claude が勝手に自作コマンドを実行しないようにするには?

A5. frontmatter に disable-model-invocation: true を書きます。Claude は自分では呼ばなくなり、/名前 で自分が打ったときだけ動きます。デプロイやコミットのように、実行の時機を自分で決めたい作業向けです。

Q6. /cost と /usage は何が違いますか?

A6. 同じです。/cost は /usage の別名で、/stats も別名です。セッションのコスト、プランの使用量上限、利用の統計をまとめて見られます。

Q7. 古い記事にある /vim が動きません。

A7. /vim は v2.1.92 で削除されました。今は /config を開き、Editor mode で Vim と通常の編集を切り替えます。コマンドは版で入れ替わるので、迷ったら /help か公式の一覧で現状を確かめてください。

Q8. スラッシュコマンドと Skills は何が違いますか?

A8. 作り方はほぼ同じです。/名前 で自分が呼ぶ使い方が「スラッシュコマンド」、Claude が description を見て自分で呼ぶ使い方が、Skills の本来の姿です。今は1つの仕組みで、disable-model-invocation と user-invocable で、どちらの呼び方を許すかを決めます。

Q9. 個人用とプロジェクト用のどちらに置くべきですか?

A9. 自分の癖に合わせた作業は ~/.claude/skills/、チームで共有したい手順は .claude/skills/ です。プロジェクト側はコミットすれば、同じリポジトリを使う人にも届きます。同名があると個人側が優先されるので、名前は重ならないようにします。

まとめ|まず1本、引数つきで作ってみる

組み込みは、会話の操作・設定・計画と並列・レビューの4グループで覚えると迷いません。名前が変わるものは別名の列で確かめられます。

自作は、スキルとして .claude/skills/<名前>/SKILL.md に置けば /名前 で呼べます。引数は $ARGUMENTS か $0、シェルの出力は行頭の !。この3つで、毎回同じ手順を打ち直す作業の大半は置き換えられます。

NEXT STEP
今日の作業で3回以上打った指示を、1本の /名前 にする。

.claude/skills/名前/SKILL.md に description と本文だけ書き、/名前 で呼べるか試します。引数やシェル出力は、動いてから足せば十分です。

途中経過は、また書きます。

NEXT READ本棚から1本

AIで開発を組み直すなら、まずこの5冊から

入門・実践・設計まで、Claude Codeの本をレベル別に5冊選んで比べました。

→ おすすめ5冊を見る

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

AI

TOC