ホーム

最初のClaudeスキルを作成

これまで/stock-report AAPLと手動で入力してレポートを生成していました。Claudeが会話の文脈から自動的に株式レポートを作成すべきタイミングを判断できたらどうでしょうか？それがスキルの力です。手動でギアを切り替える車から、必要なときに自動的に切り替わるオートマチック車にアップグレードするようなものです。

主要な概念

• スキル - .claude/skills/に保存され、Claudeが文脈に基づいて自動的に呼び出す機能
• モデル呼び出し - コマンドを入力せずに、Claudeが説明を読んでスキルの使用タイミングを判断する仕組み
• スラッシュコマンドとしても使える - どのスキルも/skill-nameと入力して自分で実行できます（例：/stock-report AAPL）。スキルとスラッシュコマンドが同じ名前の場合は、スキルが使われます
• SKILL.md - YAMLフロントマター（メタデータ）とClaudeへの指示を含むメインファイル

必要なもの

• カスタムスラッシュコマンドを作成チュートリアルを完了していること
• そのチュートリアルのstock-reportスラッシュコマンド
• VS Codeがインストールされていること
• 10〜15分

ステップ1：プロジェクトフォルダに移動

Windows（PowerShell）：

• スタートメニューからPowerShellを開く
• 次を入力：

  cd ~\Documents\test_claude
  

  フォルダが存在しない場合は、最初に作成します：

  mkdir ~\Documents\test_claude
  cd ~\Documents\test_claude
  

Mac：

• ターミナル（Terminal）を開く（アプリケーション（Applications）> ユーティリティ（Utilities））
• 次を入力：

  cd ~/Documents/test_claude
  

  フォルダが存在しない場合は、最初に作成します：

  mkdir -p ~/Documents/test_claude
  cd ~/Documents/test_claude
  

ステップ2：Claude Codeを起動

次を入力：

claude

ステップ3：確認なしでファイルを編集できるようにする

Claude Codeのプロンプトのすぐ下にあるステータスラインを確認します：

• auto mode onまたはaccept edits onと表示されていれば、準備完了です
• manual mode onと表示されている場合は、accept edits onと表示されるまでShift+Tabを押します

これにより、Claudeは毎回許可を求めることなくファイルを作成および変更できます。

ステップ4：Claudeにスラッシュコマンドの変換を依頼

次のプロンプトを入力してください：

stock-reportスラッシュコマンドをスキルに変換してください。
企業や株式について尋ねたときに自動的に起動するようにしてください。

Claudeが既存のスラッシュコマンドを分析し、.claude/skills/stock-report/にスキルとして変換します。

処理内容： Claudeは、スキルを自動的に使用するタイミングを示すYAMLフロントマターを含むSKILL.mdを持つ新しいフォルダ構造を作成します。

ステップ5：スキルの構造を確認

VS Codeを開いてプロジェクトを表示：

• File > Open Folder（ファイル > フォルダーを開く）をクリック
• Documents/test_claudeを選択
• ファイルエクスプローラで.claude/skills/stock-report/に移動
• SKILL.mdをクリックして開く

構造に注目：

---
name: stock-report
description: 企業に関するレポートを生成します... 株式、企業、ティッカーシンボルについて尋ねられたときに使用します。
---

[残りの指示]

descriptionフィールドが鍵です—このスキルを自動的にアクティブ化するタイミングをClaudeに正確に伝えます。

ステップ6：スキルをテスト（コマンド入力なし）

まず、Claude Codeが新しいスキルを読み込んだことを確認します。次のように入力します：

/reload-skills

Claude Codeが利用可能なスキルの数を表示します。次に、/stock-report AAPLと入力する代わりに、自然な質問をしてみましょう：

Appleで最近何が起こっていますか？

重要なポイント： コマンドを入力していません。Claudeが質問を読み、企業について尋ねていることを認識し、スキルの説明を確認して、自動的にstock-reportスキルを使用すると判断します。

Claudeの作業を見てください—以前と同じ包括的なレポートを生成するはずです。

ステップ7：2つのアプローチを比較

スラッシュコマンド（手動）：

/stock-report AAPL

• Claudeに何をすべきか明示的に指示
• 毎回同じ
• 繰り返し可能な予測可能なタスクに適している

スキル（自動）：

Teslaの最近の動向について教えてください

または

Microsoftへの投資を考えています

または

NVIDIAは何をしていますか？

• Claudeがスキルを使用するかどうかを決定
• より自然な会話
• Claudeが管理する複雑なワークフローに適している

ステップ8：エッジケースをテスト

株式レポートスキルをトリガーすべきでない質問を試してみましょう：

Pythonをインストールする方法は？

Claudeはスキルを呼び出さずに通常通り回答します。

次に、トリガーすべき質問を試してみましょう：

GoogleとMetaを比較してください

Claudeはスキルを2回使用するはずです—Googleに1回、Metaに1回。

ステップ9：スキルの説明を変更（オプション）

スキルをより選択的にしましょう。Claudeに次のように依頼してください：

stock-reportスキルを更新して、企業名と一緒に「分析」または「レポート」を
明示的に言及したときだけ起動するようにしてください。

ClaudeがSKILL.mdのdescriptionフィールドを更新します。/reload-skillsと入力してClaude Codeに変更を読み込ませてから、違いをテスト：

Appleは何をしていますか？

（今はスキルをトリガーしないかもしれません）

Appleを分析してください

（スキルをトリガーするはずです）

次のステップ

スキルを理解したので、ワークフロー用にさらに作成しましょう：

• リサーチスキル - ウェブリサーチが必要な質問をしたときに自動的にアクティブ化
• コードレビュースキル - バグ、問題、コードの問題について言及したときにアクティブ化
• 会議メモスキル - 会議の記録を貼り付けたり、要約について言及したときにアクティブ化

パターン：手動でトリガーするショートカットだけでなく、Claudeが自動的に助けるべきタイミングを定義します。

トラブルシューティング

• スキルが起動しない： SKILL.mdのdescriptionフィールドを確認してください。質問に関連するトリガーワードを含める必要があります
• スキルが頻繁に起動しすぎる： 使用タイミングについて、より具体的な説明に変更してください
• スキルフォルダが見つからない： スキルは.claude/skills/にあります（隠しフォルダです。VS Codeのエクスプローラーには表示されます。Windowsのエクスプローラーでは表示 > 表示 > 隠しファイルを選択し、MacのFinderではCmd+Shift+.を押します）
• SKILL.mdへの変更が反映されない： スキルは通常、変更時に自動的に再読み込みされます。このセッション中に.claude/skills/フォルダを作成した場合は、/reload-skillsと入力してください（またはClaude Codeを再起動します）。それでも動作しない場合は、YAMLフォーマットを確認してください

ワークフロー概要

• スラッシュコマンドは手動で入力するショートカットです（ブックマークのような存在）
• スキルはClaudeが自動的に発見して使用する機能です（あなたの好みを理解しているアシスタントのような存在）
• スキルの説明はClaudeへの指示として機能します：「ユーザーがXと言ったときに私を使ってください」
• 両方を併用できます - 素早く繰り返すタスクにはスラッシュコマンドを、複雑なワークフローにはスキルを使用します
• スキルはよりスケーラブル - コマンド名を覚える必要がなく、Claudeが文脈に基づいて判断します

Steven Geが2025年12月13日に作成。