Claude Code ガイド

Appearance

スラッシュコマンドの「Unknown skill」エラーの修正 ​

原文（日本語に翻訳） ​

スラッシュコマンドが「Unknown skill」と表示される問題を修正

原文（英語） ​

Fixed slash commands showing "Unknown skill"

概要 ​

Claude Code v2.1.76で、スラッシュコマンド（/ で始まるコマンド）を実行した際に「Unknown skill」というエラーメッセージが表示される問題が修正されました。カスタムスキルやバンドルスキルを正しく設定しているにもかかわらず認識されないケースがあり、ワークフローの中断を引き起こしていました。この修正により、スキルの検出と呼び出しが安定して動作するようになりました。

基本的な使い方 ​

修正後は、スラッシュコマンドが正常にスキルを認識して実行されます：

bash
# バンドルスキルの実行
/debug セッションのエラーを調査して

# カスタムスキルの実行
/deploy staging

# スキル一覧の確認
/help

実践例 ​

カスタムスキルの利用 ​

プロジェクトに定義されたカスタムスキルを呼び出す場合：

bash
# .claude/skills/review/SKILL.md に定義されたスキル
/review src/auth/login.ts

# 修正前: "Unknown skill" エラーが表示されることがあった
# 修正後: スキルが正常に認識され実行される

バンドルスキルの利用 ​

Claude Codeに組み込まれたバンドルスキルの利用：

bash
# コードの一括変更
/batch src/内のReactコンポーネントをTypeScript化して

# コードの簡素化
/simplify メモリ効率に注目して

# デバッグ
/debug パーミッションエラーの原因を調査して

スキルの存在確認 ​

スキルが正しく認識されているかを確認する方法：

bash
# Claude に利用可能なスキルを尋ねる
> 利用可能なスキルを教えて

# / を入力するとオートコンプリートでスキル一覧が表示される
/

注意点 ​

  • スキルの配置場所: スキルは ~/.claude/skills/（個人用）または .claude/skills/（プロジェクト用）に配置する必要があります
  • 既存のコマンドとの互換性: .claude/commands/ に配置されたファイルも引き続きスキルとして動作します
  • 名前の衝突: 同名のスキルが複数の場所にある場合、エンタープライズ > 個人 > プロジェクトの優先順位で解決されます
  • SKILL.md の必須性: 各スキルディレクトリには SKILL.md ファイルが必要です
  • セッション再起動: 修正前にこの問題が発生していた場合、Claude Codeを最新版にアップデートしてセッションを再起動してください

関連情報 ​