Claude Skills チュートリアル: 10分で初めてのSKILL.mdを作る (2026)

Claude Skillsチュートリアル：10分で初めてのSKILL.mdを作る（2026年）

Skillsは、おそらくまだ使っていない最も重要なClaude Codeの機能です。Claude skillとは、SKILL.mdファイルを含むフォルダのことで、プロンプトがその説明に一致した瞬間にClaudeが自動で読み込みます。プロンプトのコピペも、肥大化したCLAUDE.mdも、どのテンプレートを使うか覚える必要もありません。このリポジトリの.claude/skills/agent/フォルダには4つのskillを同梱しており、Skills 2.0と2026年初頭に登場するAnthropic Marketplaceにより、このフォーマットはついに本領を発揮します。ここでは、落とし穴を乗り越えた先に機能するパターンを紹介します。

重要なポイント

• Claude skillとは、YAMLフロントマター付きのSKILL.mdファイルを含むフォルダのことで、関連する場面でClaudeが自動で読み込みます。
• Skillsは~/.claude/skills/（個人用）または.claude/skills/（プロジェクト用）に配置し、Claudeは起動時に両方をスキャンします。
• 繰り返し可能なワークフローにはSkillsを、リアルタイムの外部データにはMCPを、複数ステップの計画にはsubagentsを、決定的なイベントにはhooksを使用します。
• 初めてのskillを作る最速の方法は、Claudeに自身のskill-creator skillを呼び出すよう依頼することです。SKILL.mdを代わりに書いてくれます。

Claude Skillsとは？

Claude skillとは、SKILL.mdファイル（YAMLフロントマターとしてname、description、任意のallowed-toolsを含む）を格納したフォルダのことで、プロンプトがdescriptionに一致すると、Claude Codeが自動的にコンテキストへ読み込みます。skillを使うことで、/commitや/explain-codeのような再利用可能なワークフローを、システムプロンプトを肥大化させることなくパッケージ化できます。

Anthropicの公式ドキュメントによれば、すべてのskillフォルダには3つの要素があります。必須のSKILL.md、任意のバンドルスクリプト（PythonのヘルパーからJSONの設定ファイルまで何でも）、そして本文とともに読み込まれる任意のリファレンスドキュメントです。それだけです。ビルド手順もインストールもマニフェストも不要です。

巧妙な点はプログレッシブディスクロージャーです。起動時、Claudeはすべてのskillのdescriptionフィールドのみを走査します。本文、指示、例、ツール呼び出しのパターンは、実際にプロンプトが一致するまでディスク上に置かれたままです。そのため、50個のskillをインストールしていても、いずれかが発火するまでトークンコストはゼロです。

skillは、Claudeがあなたのプロンプトの中に材料を見つけたときにめくる、料理本のレシピのようなものです。skillとは、Claudeが必要に応じて読み取るフォルダであり、あなたが貼り付けるのを覚えておくべきプロンプトではありません。それが売り文句のすべてです。

最小限のSKILL.mdは次のようになります。

---
name: Summarize file
description: Use when the user asks for a 3-sentence summary of a file or function.
---

Read the file at $ARGUMENTS. Summarize purpose, key dependencies, and the
single most surprising thing about it. Three sentences max.

10行。正真正銘のskill。すぐに発火できます。

クイックスタート：10分で最初のスキルを作ろう

10分で最初のClaudeスキルを作るには：(1) ~/.claude/skills/explain-code/ を作成し、(2) name、description、ワークフロー本文を含む SKILL.md ファイルを追加し、(3) Claude Code を再起動して新しいディレクトリをスキャンさせ、(4) descriptionに一致するプロンプトでトリガーします。

以下がその全体の流れです。

ステップ 1: ディレクトリを作成する

mkdir -p ~/.claude/skills/explain-code

パーソナルスキル（自分専用）は ~/.claude/skills/ 配下に配置します。プロジェクトスキル（git 経由でチームと共有）はリポジトリのルートにある .claude/skills/ 配下に配置します。日常的に使うワークフローにはパーソナルを、リポジトリのすべてのコントリビューターに継承させたい場合はプロジェクトを選んでください。

ステップ2：SKILL.md を作成する

このファイルを ~/.claude/skills/explain-code/SKILL.md に配置します：

---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
---

You are explaining code to a developer who is new to this codebase.

1. Read the file or snippet at $ARGUMENTS.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies or side effects.
5. End with one question the reader should ask before changing this code.

これでスキルの全体が完成です。フロントマターが契約であり、ボディがプレイブックです。

ステップ3：Claude Codeを再起動する

ライブ検出はSkills 2.0の機能です。古いバージョンのClaude Codeでは、新しいディレクトリを認識するために再起動が必要です。使用しているバージョンがわからない場合は、一度再起動してみても損はありません。

ステップ4: トリガーする

プロジェクトを開いて、次のように入力してください:

walk me through what auth/middleware.ts does

Claudeはプロンプトをdescriptionフィールドと照合し、explain-codeを見つけると、SKILL.mdの本文をひっそりとコンテキストに読み込みます。ツールログには「Using skill: explain-code」と表示されます。これで完了です。

プロのヒント: 自分でファイルを書くのが面倒ですか?Claude Codeを開いて、Use the skill-creator skill to scaffold an explain-code skill for me.と話しかけてください。Anthropicが同梱しているskill-creatorはメタスキルで、あなたに質問を重ね、適切なallowed-toolsを選び、SKILL.mdを正しいフォルダに書き出してくれます。最初のスキルを作るための最速の方法です。間違いありません。

これが10分の約束です。5分の入力、1回の再起動、1つのテストプロンプト。

SKILL.md の内部：フロントマターリファレンス

SKILL.md のフロントマターは、--- の区切り文字で囲まれた YAML です。必須のフィールドは 2 つあります。name（64 文字以内、スラッシュコマンド名として使用）と description（Claude があなたのプロンプトと照合して判断するためのトリガーテキスト）です。任意のフィールドでは、ツールアクセス、モデル呼び出し、ファイルの glob、実行コンテキストを制御できます。

以下が Anthropic のスキルドキュメント に基づいた完全なリファレンスです。

context: fork の行は特に取り上げる価値があります。これは Skills 2.0 のプリミティブで、分離されたコンテキストウィンドウ内でスキルを実行するものです。長時間実行されるリサーチスキルや、メインスレッドを汚したくない大量の中間トークンを生成するあらゆる処理に役立ちます。この考え方に初めて触れる方は、コンテキストエンジニアリングのガイドでトレードオフを解説しています。 SKILL.md の frontmatter を最大限に書き込み、全フィールドを埋めた例:

---
name: Deploy preview
description: Use when the user wants to deploy a preview build of the current branch to staging.
allowed-tools: ["Bash(git status:*)", "Bash(npm run build:*)", "Bash(vercel:*)"]
disable-model-invocation: true
user-invocable: true
argument-hint: <branch-name or 'current'>
model: claude-opus-4-7
context: fork
globs: ["package.json", "vercel.json"]
references: ["./deploy-runbook.md"]
bundled-files: ["./scripts/preflight.sh"]
tags: ["deploy", "vercel", "preview"]
---

プロのヒント: description で最も犯しやすい最大のミス、それは人間向けに書いてしまうことです。Claude 向けに、具体的なトリガーフレーズを書いてください。マーケティング用の文言は書かないでください。悪い例: 「強力な Git 自動化スキル。」 良い例: 「ユーザーが変更をコミットしたいとき、コミットメッセージを書きたいとき、または PR を作成したいときに使用します。」

2つの実践スキルを、最初から最後まで

実際のユースケースの80%は、2つのスキルパターンでカバーできます。(1) 決定論的なアクション向けの、ユーザー起動型 /commit スキル(disable-model-invocation: true と allowed-tools: Bash(git *) を指定)(2) デフォルトのfrontmatterを持ち、プロンプトがdescriptionに一致したときにClaudeが自動起動する /explain-code スキル、の2つです。

ほとんどのチュートリアルはコードの断片しか紹介していません。ここでは、今すぐ ~/.claude/skills/ にコピーして使える2つの完成されたファイルをご紹介します。

/commit スキル（ユーザー起動型）

---
name: Commit
description: Use when the user wants to stage and commit code changes with an AI-written conventional-commit message.
disable-model-invocation: true
user-invocable: true
allowed-tools:
  - "Bash(git status:*)"
  - "Bash(git diff:*)"
  - "Bash(git add:*)"
  - "Bash(git commit:*)"
---

1. Run `git status` and `git diff` to see what's staged and unstaged.
2. Group changes into one logical commit. If there are multiple unrelated
   changes, ask the user which to include.
3. Draft a Conventional Commits message: `type(scope): subject` (≤72 chars),
   blank line, body explaining *why*, not *what*.
4. Show the message to the user. Ask "Commit this?" Wait for explicit yes.
5. On confirmation, run `git add` for the included files and `git commit -m`.
6. Print the resulting commit hash.

テストプロンプト: /commit

実行される内容: Claude が git の状態を調査し、メッセージの下書きを作成して確認を求め、承認されて初めて git commit を実行します。disable-model-invocation: true により、「変更を保存して」といった曖昧なプロンプトで自動的に起動することはなく、/commit と入力したときのみ実行されます。allowed-tools のホワイトリストによって git サブコマンドに限定されるため、rm -rf の実行やリモートへのプッシュは物理的に不可能です。これは私たち自身のパイプラインで実際に本番運用しているスキルの 1 つです。

コミット後の決定的なアクション（lint の実行、型の再生成、Slack Webhook への ping）には、代わりに Claude Code フック を使用してください。スキルは確率的ですが、フックは毎回確実に発火します。

/explain-code スキル（モデル呼び出し可能）

---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
argument-hint: <file path or pasted snippet>
model: claude-opus-4-7
---

1. Read the file or snippet at $ARGUMENTS. If $ARGUMENTS is empty, ask
   the user which file to explain.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies, side effects, or hidden assumptions.
5. End with one question the reader should ask before modifying this code.

テストプロンプト: walk me through what auth/middleware.ts does

何が起きるか: ユーザーは /explain-code と入力していないことに注目してください。Claude は「walk me through」を description フィールドと照合し、スキルを見つけて自動的に起動します。これがマジックです。description がルーティングを担っています。model: claude-opus-4-7 フィールドにより、デフォルトに設定しているモデルに関係なく、このスキルは Opus に固定されます。そのため、詳細なコードウォークスルーでは常に高性能なモデルが使われます。（異なるモデルでの Claude Code の実行については別途詳しく説明します。）

なぜ 2 つのパターンがあるのか？ スキル #1 はユーザー呼び出し可能で、特定のツールにロックされており、予測可能で安全、git やデプロイに最適です。スキル #2 は自動起動で、自由度が高く、スキルならではのマジックですが、description フィールドを信頼してください。ユーザー呼び出し可能なスキルは予測可能性を、モデル呼び出し可能なスキルはマジックをもたらします。 スキルごとに選び、リポジトリごとには選びません。

実際のスキルの例をもっと見たい方は、公式 anthropics/skills リポジトリや、コミュニティがメンテナンスしている awesome-claude-skills リストをチェックしてください。

Skills vs MCP vs Subagents vs Hooks：使い分けガイド

Skills は、Claude に自動トリガーさせたい、またはスラッシュコマンドとして呼び出したい再利用可能なワークフローに使います。MCP サーバー は、ライブな外部データ（データベース、API、作業ディレクトリ外のファイルシステム）が必要なときに使います。Subagents は、Claude が新しいコンテキストに委譲すべき多段階の計画に使います。Hooks は、必ず発火しなければならない決定的なイベント（pre-commit、post-tool-use など）に使います。確率的にではなく、常にです。

簡単な位置づけ：skills はワークフロー、Model Context Protocol はデータ、subagents は計画、hooks はイベントです。それぞれが Claude Code の異なるレイヤーに存在し、レイヤーを間違えればツールの使い方も間違えます。Anthropic 自身の Skills explained 投稿によれば、これこそが彼らに内在化してほしいとされている枠組みです。

これらは組み合わせられます。skill は allowed-tools を介して MCP ツールを呼び出せます。hook は skill の完了後に発火できます。subagent はアクセス権を与えられた skills を使用できます。最もクリーンなメンタルモデルは、まず正しいレイヤーを選び、それからそれらを積み重ねることです。Skills は、Claude に選択させたいワークフローがあるときに手を伸ばすコンテキストエンジニアリングのプリミティブです。Claude にスキップさせたくないものがあるときは、hooks で自動化します。 それぞれの最悪な誤用パターン：Skillsをライブデータに使う（MCPを使え）；MCPを一度きりのプロンプトテンプレートに使う（Skillsを使え）；サブエージェントを決定論的なファイル編集に使う（hooksを使え）；hooksを分岐ロジックに使う（Skillsを使え）。Skillsはワークフロー、MCPはデータ、サブエージェントはプラン、hooksはイベント。バズワードではなく、レイヤーで選べ。

スキルの置き場所：Personal、Project、Plugin、Enterprise

Claudeのスキルは4つのスコープにインストールされます：personal（~/.claude/skills/、自分専用）、project（リポジトリルート内の .claude/skills/、git経由でチーム共有）、plugin（Anthropic Marketplaceまたは任意のplugin URL経由で配布）、enterprise（IT部門がMDM/管理者ポリシーでプッシュ）です。Claudeは起動時にこれら4つすべてをスキャンします。

バンドルされたドキュメントスキルは見落とされがちですが、Claude Codeには最初から pdf、docx、pptx、xlsx のスキルが同梱されており、さらに /debug や /simplify などの小さなビルトインライブラリも備わっています。（姉妹ツールの Claude Design には、デザイン生成用のバンドルワークフロースキルが同梱されています。同じモデルで、異なる領域です。）

いつprojectではなくpluginで配布すべきでしょうか？同じワークフローが複数のリポジトリに役立つ場合、pluginが有利です。5つのクライアントコードベースで使う /release スキルは、各リポジトリの .claude/skills/ にコピー＆ペーストするのではなく、pluginに属します。Projectスキルは、コードベース固有の規約（チームのPRテンプレート、カスタムテストランナーなど）に適しています。Anthropic Marketplaceと、任意のURLからの /plugin install により、pluginはリポジトリ間での再利用に対する正しい答えとなります。pluginのドキュメントによれば、検出と更新は自動的に処理されます。

上級パターン：$ARGUMENTS、動的シェルインジェクション、context: fork

最も重要な上級スキルパターンは3つあります。$ARGUMENTS は、ユーザーが呼び出せるスキルにパラメータを渡す機能です（/translate $ARGUMENTS）。動的シェルインジェクション（allowed-tools: Bash(...) を併用）は、スキルがスクリプトを実行し、その出力をコンテキストにパイプで渡す機能です。そして context: fork（Skills 2.0）は、スキルを分離されたコンテキストウィンドウで実行する機能です。2026年5月時点で、context: fork に関する公式リファレンスは Anthropic のコンプリートガイド白書です。

パラメータ化されたスキル向けの $ARGUMENTS

---
name: Translate
description: Translate the most recent message into the target language.
user-invocable: true
argument-hint: <target-language, e.g. spanish, japanese, brazilian portuguese>
---

Translate the user's previous message into $ARGUMENTS. Preserve tone,
preserve markdown formatting, return only the translation.

テストプロンプト: /translate spanish。Claude は実行時に $ARGUMENTS を spanish に置き換えます。バリエーションを書かずにスキルを多目的にする最もクリーンな方法です。

allowed-tools 経由の動的シェルインジェクション

---
name: Review last commit
description: Use when the user wants a code review of the last git commit.
allowed-tools: ["Bash(git diff HEAD~1:*)", "Bash(git log -1:*)"]
---

Run `git diff HEAD~1` and `git log -1`. Review the diff for bugs, security
issues, and style violations. Output a 5-bullet review.

このスキルはシェルコマンドを実行し、diff をパイプでコンテキストに渡してレビューします。allowed-tools は特定のコマンド (Bash(git diff HEAD~1:*)) に固定し、裸の Bash は絶対に使わないでください。裸の Bash 権限は、このパターンのセキュリティ上の「自滅の罠」バージョンです。

context: fork（Skills 2.0）

---
name: Deep research
description: Use when the user wants a multi-source research summary on a topic.
context: fork
---

Research the topic in $ARGUMENTS using available web tools. Produce a
2-page summary with citations. Do not pollute the main thread.

フォークするとスキルに専用のコンテキストウィンドウが割り当てられるため、中間的な調査メモの5万トークンがメインセッションに流れ込むのを防げます。長時間のリサーチ、大規模なリファクタリングの計画、その他使い捨てトークンを大量に生むあらゆる作業に役立ちます。Skills 2.0専用で、古いバージョンのClaude Codeではこのフィールドは無視されます。

トラブルシューティング：Skillが発動しない理由

Skillが発動しない原因は、通常、次の4つのうちのいずれかです。(1) description が汎用的すぎて、Claudeがプロンプトと照合できない、(2) ディレクトリのパスが間違っている（正しくは claude/skills/ ではなく .claude/skills/）、(3) Skillの追加後にClaude Codeが再起動されていない（Skills 2.0以前のみ）、(4) Skill名がバンドルされたSkillや、より優先度の高いSkillと競合している。Claude CodeのGitHubイシュートラッカーで最もよく検索されている失敗モードによると、これら4つで「なぜ動かないのか」という報告の約95%を占めています。

失敗パターン1：「スキルがまったく表示されない」

最も多い原因はパスの間違いです。.claude/skills/（ドットあり）と claude/skills/（ドットなし）の取り違えは、深夜1時に誰もがやるタイプミスです。ls -la ~/.claude/skills/ を実行して、ドット付きのディレクトリが存在することを確認してください。存在しているのに Claude が認識しない場合は、Claude Code を一度再起動してください。Skills 2.0 より前のバージョンは、起動時にしかスキャンを行いません。

失敗パターン2：「Claudeがスキルを自動で起動してくれない」

description フィールドが曖昧すぎるか、Claude 向けではなく人間向けに書かれている。ユーザーが実際にリクエストをどう表現するかを反映した、具体的なトリガーフレーズを使って書き直そう。このリポジトリ用に4つのスキルを構築した後、私が陥った落とし穴は、説明文を「SEO に役立つ便利なスキルです。」のようなまま放置していたことだ。無意味だ。次のように書き換える：「ユーザーが Markdown の投稿に JSON-LD スキーマ、meta タグ、または SEO フロントマターを追加したい場合に使用する。」トリガーの精度は約30%から約95%に向上した。トリガー精度は description フィールドで生死が決まる。履歴書のためではなく、Claude のために書こう。

障害モード3：「スラッシュコマンドパレットで description が切り捨てられた」

description が1024文字を超えているか、name が64文字を超えています。どちらも厳格な上限があります。対処法：スキルをより絞り込んだ2つのスキルに分割するか、長い詳細部分を SKILL.md の本文に移してください。フロントマターはルーティング用であり、ドキュメント用ではありません。

失敗パターン4：「ライブ変更検出が機能しない」

Skills 2.0 より前の Claude Code では、SKILL.md を編集するたびに完全な再起動が必要です。スキルを繰り返し改善しているのに変更が反映されない場合、おそらく古いビルドを使用しています。Skills 2.0（ライブ検出）を搭載した Claude Code のバージョンにアップグレードするか、保存のたびに再起動する習慣をつけましょう。手間はかかりますが、コストは低いものです。

Claudeを超えたスキル：オープンなエージェントスキル標準

そう、スキルはオープンな標準規格です。agentskills.io の Agent Skills 標準は、SKILL.md のフォーマットを特定のベンダーに依存しない形で定義しています。OpenAI の Codex CLI と ChatGPT Desktop は2025年12月にこの標準を採用しました。Claude Code 用に書いた SKILL.md は、フロントマターを少し調整するだけで Codex でも動作します。

2026年5月時点のツール横断サポート状況は以下の通りです。Claude Code は Agent Skills をフルサポートしています（リファレンス実装です）。OpenAI の Codex CLI もフルサポートです。ChatGPT Desktop は部分サポートで、name、description、本文は機能しますが、allowed-tools の互換性はまだ実現していません。Gemini CLI は2026年初頭にサポートを表明しましたが、本稿執筆時点ではまだ出荷されていません。Cursor は少し変わっていて、独自の Cursor rules フォーマットを使っており、SKILL.md をネイティブには読み取りません。ただしコミュニティ製のシム（shim）は存在します。

今年いっぱいスキルの寿命を保つために今書いておくべきこと：name と description はクリーンに、ツール非依存に保ちましょう。クロスツールで使う場合は、ベンダー固有のフロントマターを名前空間（claude: や codex:）の後ろに分離してください。ポータブルな部分、つまり name、description、本文、$ARGUMENTS はどこでも機能します。context: fork のような高度なフィールドは、他のベンダーが同等の機能を出荷するまで Claude 専用です。Anthropic は リークされた Claude Code のロードマップ にある通り、より深いマーケットプレイス統合も推進しており、ポータビリティは今後ますます容易になるでしょう。

スキルの実例を探す場所は3つあります。anthropics/skills（公式）、awesome-claude-skills（コミュニティ）、そして agentskills.io（標準の仕様ページ）です。スキルはもはや Claude の機能ではありません。Claude が最初に出荷した、オープンな標準規格なのです。

よくある質問

ClaudeスキルとMCPサーバーの違いは何ですか？

Claudeスキルとは、プロンプトがその説明と一致した際にClaudeが読み込む、ワークフローの手順を記述したSKILL.mdファイルです。MCPサーバーは、Claudeがライブデータ（データベース、API、作業ディレクトリ外のファイルシステム）を取得するために呼び出す独立したプロセスです。ワークフローにはスキルを、データにはMCPを使用します。これらは組み合わせることができ、スキルからMCPツールを呼び出すことも可能です。

Claude のスキルは無料ですか？

はい、スキルは Claude Code の組み込み機能であり、追加料金はかかりません。お支払いいただくのは、スキルの実行時に消費されるモデルのトークンのみです。Anthropic Marketplace からインストールするスキルは有料の場合がありますが（現時点ではまれです）、公式の anthropics/skills リポジトリやコミュニティの awesome リストは、すべて無料でコピーしてご利用いただけます。

Claudeのスキルはどこにインストールされますか？

個人用スキルは ~/.claude/skills/{skill-name}/ に、プロジェクト用スキルはリポジトリのルートにある .claude/skills/{skill-name}/ に配置されます。プラグインのスキルは /plugin install <url> でインストールされ、プラグインディレクトリに保存されます。エンタープライズスキルは、組織のIT部門によってマネージド設定を通じてプッシュされます。Claude Codeは起動時にこれら4つのスコープすべてをスキャンします。

Claude のスキルをゼロから作成するには？

~/.claude/skills/ 配下にフォルダを作成し、YAML フロントマター（name、description）の後にワークフローの手順を記述した SKILL.md ファイルを追加して、Claude Code を再起動します。最も手っ取り早い方法：Claude Code を開き、バンドルされている skill-creator スキルの起動を依頼すると、1 分もかからずに SKILL.md の雛形を生成してくれます。

Claudeのスキルがトリガーされないのはなぜ?

最もよくある4つの原因:(1) description が曖昧すぎて、Claudeがプロンプトと一致させられない。具体的なトリガーフレーズで書き直すこと。(2) スキルのパスが間違っている(claude/skills/ ではなく .claude/skills/)。(3) Skills 2.0以前のバージョンではClaude Codeの再起動が必要。(4) スキル名がバンドル済みスキルと競合している。ls -la ~/.claude/skills/ で確認する。

ChatGPTやCursorはClaudeのスキルを使えますか？

ChatGPT DesktopとCodex CLIは、Claudeと同じAgent Skills標準をサポートしており、同じSKILL.mdがフロントメーターの軽微な変更だけで両方で動作します。Cursorは独自のCursorルール形式を使用しており、SKILL.mdをネイティブには読み取りません。Gemini CLIは2026年初頭にサポートを発表しましたが、2026年5月時点ではまだ提供されていません。

skill-creator スキルとは？

skill-creator は、anthropics/skills リポジトリに同梱されているメタスキルで、Claude があなたに代わって新しい SKILL.md ファイルを作成するのを支援します。そのスキルに何をさせたいかを Claude に伝えると、skill-creator が説明についてあなたに質問し、適切な allowed-tools を選んだうえで、正しいフォルダーに SKILL.md を書き出します。最速で足場を築ける方法です。

disable-model-invocation は何をするのか？

スキルのフロントマターで disable-model-invocation: true を設定すると、プロンプトのマッチングに基づいて Claude がそのスキルを自動起動するのを防ぐことができます。そのスキルはユーザーからの呼び出し専用となり、スラッシュコマンドパレットに /skill-name として表示され、明示的に呼び出された場合のみ実行されます。/commit や /deploy のような、破壊的または決定的なアクションに使用してください。

いくつかスキルを作り、プロジェクトで公開して、何が定着するか見てみましょう。もしあなたのチームが複数のリポジトリにまたがって「スキルが起動しない」という一連の落とし穴に遭遇していて、.claude/skills/ の構成について第三者の視点を得たい場合は、お問い合わせください。喜んで一緒に確認いたします。