Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

デフォルトのコンポーネントフォルダー（例: commands/）がplugin.jsonの対応キー設定により無視されている場合に警告を表示するようになりました。/doctor・claude plugin list・/pluginで確認できます

原文（英語） ​

Plugins now warn when a default component folder (e.g. commands/) is silently ignored because plugin.json sets the matching key. Shown in /doctor, claude plugin list, and /plugin.

概要 ​

プラグインのデフォルトコンポーネントフォルダー（commands/、skills/、hooks/など）が存在しているにもかかわらず、plugin.jsonの設定によって無視されている場合に警告が表示されるようになりました。これにより、意図せずコンポーネントが無視されているケースを素早く発見できます。

基本的な使い方 ​

警告は以下の場所で確認できます：

bash
# /doctorで確認
/doctor

# プラグインリストで確認
claude plugin list

# /pluginコマンドで確認
/plugin

実践例 ​

警告が発生するケース ​

json
// plugin.json
{
  "name": "my-plugin",
  "skills": "custom-skills/",  // カスタムパスを指定
  // → デフォルトの "skills/" フォルダーが存在する場合に警告
}

このケースでは、skills/フォルダーにスキルファイルを置いていても読み込まれず、custom-skills/が使用されます。意図的な設定であれば問題ありませんが、設定ミスの可能性を警告します。

警告の確認と対処 ​

bash
/doctor
# 出力例:
# ⚠️  Plugin 'my-plugin': default folder 'skills/' is ignored because 
#    'skills' key is set to 'custom-skills/' in plugin.json.
#    If intentional, move your skill files to 'custom-skills/'.
#    If not, remove the 'skills' key from plugin.json to use the default.

対処方法：

  1. 意図的な場合: スキルファイルをcustom-skills/に移動する
  2. 設定ミスの場合: plugin.jsonのskillsキーを削除してデフォルトのskills/を使用する

注意点 ​

  • 警告はエラーではなく、プラグインの動作を止めません
  • /doctor、claude plugin list、/pluginの3か所で確認できます
  • デフォルトコンポーネントフォルダーの名前（commands/、skills/、hooks/など）が対象です
  • プラグイン開発中に設定の不整合に早期気づくのに役立ちます

関連情報 ​