strictPluginOnlyCustomization.skills

変更前

スキルやレガシーコマンドの名前が constructor や toString などのビルトイン Object プロパティと同じだと、/plugin の Installed タブや /skills がクラッシュして使えなかった

変更後

「/plugin → Installed」や「/skills」で、スキルやレガシーコマンドが constructor や toString といったビルトイン Object プロパティと同名でも表示・選択できるようになる

ユーザーへの恩恵

そうした名前のスキルやコマンドがあっても安全に一覧・管理できるようになる

変更前

worktreeセッションでは、.claude/skills がGitの追跡対象外であると、メインリポジトリのプロジェクトスキルが読み込まれず、スキルが利用できない状態だった。

変更後

worktreeセッションでもメインリポジトリのプロジェクトスキル(.claude/skills 配下)が読み込まれるようになり、スキルが利用可能になった。

ユーザーへの恩恵

worktreeで作業する場合でも、.claude/skills をわざわざ追跡対象にコミットすることなく、メインリポジトリのプロジェクトスキルをそのまま利用できる。

変更前

claude.ai アカウントで有効化したスキルやプラグインは claude.ai 上と Cowork・クラウドセッションでは同期されたが、ターミナルセッションでは同期されなかった。

変更後

設定キー syncClaudeAiSkills と syncClaudeAiPlugins が追加され、claude.ai アカウントで有効化したスキルとプラグインが claude.ai でのサインイン済みターミナルセッションに自動的に同期されるようになった。オプトアウトしたければ設定で syncClaudeAiSkills: false または syncClaudeAiPlugins: false を指定する。

ユーザーへの恩恵

同じ claude.ai アカウントでサインインしたターミナルセッションでも、claude.ai で有効化したスキルやプラグインを再設定なしでそのまま利用できる。

変更前

--forward-subagent-text を有効にしても、context: fork スキルが起動したサブエージェントのメッセージや、サブエージェントや別のフォーク済みスキルから呼び出されたフォーク済みスキルのメッセージが stream-json / SDK 出力から欠落する。

変更後

--forward-subagent-text を有効にした stream-json / SDK 出力で、context: fork スキルが起動したサブエージェントのメッセージや、サブエージェント・別のフォーク済みスキルから呼び出されたフォーク済みスキルのメッセージがすべて配信される。

ユーザーへの恩恵

フォーク済みスキルとサブエージェントのやり取りを取りこぼさず監視でき、 SDK / stream-json 統合の信頼性が高まる。

変更前

claude.ai アカウントから同期された skills フォルダー (~/.claude/skills/synced/) 内のファイルを Edit または Write ツールで変更しても、結果メッセージには変更の成功しか表示されず、その変更がアカウントに同期されないことは示されない。

変更後

Edit および Write の結果メッセージに、変更がアカウントには保存されないことと、保存する方法が明示される。

ユーザーへの恩恵

同期されたスキルファイルを編集した際に、変更がアカウントには残らないことを直ちに把握し、必要なら claude.ai 側で編集するなどして永続化できる。

変更前

同期されたスキルは削除されずに~/.claude/skills/.trash/へ移動されるため、履歴として確認・復元できる。

変更後

組織がSkillsをオフにしても、claude.aiから同期されたスキルがsyncedディレクトリに残り続けて使える状態になっていた。

ユーザーへの恩恵

ユーザーは、組織がSkillsをオフにした後も、同期されたスキルが完全に消えずにゴミ箱から復元できるようになる。

変更前

After changing directories with /cd, /reload-skills reported a skill count that disagreed with the count shown in the slash menu. The two displays were based on inconsistent data, so the numbers could differ.

変更後

After this change, /reload-skills reports a skill count that matches the count shown in the slash menu even after /cd. Before, the two counts could disagree.

ユーザーへの恩恵

スキル数の再読み込み結果がスラッシュメニューの表示と一致するようになり、現在のディレクトリで利用可能なスキルを確実に把握できる。

変更前

self-hosted runnerセッションでは、ホスト設定ディレクトリが64 MiBを超えると、設定、スキル、プラグイン、MCPサーバーなどのホスト設定が警告なくすべて失われていた。--host-config-snapshot フラグは存在しなかった。

変更後

ホスト設定ディレクトリが64 MiBを超えても、self-hosted runnerセッションは設定、スキル、プラグイン、MCPサーバーを含むすべてのホスト設定を正しく読み込む。--host-config-snapshot disk|memory フラグでスナップショットの保存先を制御できるようになる。

ユーザーへの恩恵

ホスト設定ディレクトリが大きくなっても、runnerセッションで設定、スキル、プラグイン、MCPサーバーが喪失せず、意図した構成でセッションを実行できる。

変更前

claude.ai から同期されたスキルは、サインアウトした後もディスク上に無期限に残っていた。cleanupPeriodDays の期間内に更新されなかったコピーも削除されず、ディスクスペースを占有し続けていた。

変更後

サインアウトした後も claude.ai から同期されたスキルがディスク上に無期限に残る問題を修正。cleanupPeriodDays 以内に更新されていなかったコピーは、次回起動時に復元可能なゴミ箱へ移動するようになった。

ユーザーへの恩恵

サインアウト後も不要になった同期済みスキルが自動的にゴミ箱へ移動されるため、ユーザーは手動でディスク上の残骸を削除する必要がなくなる。

変更前

claude.ai から同期されたスキルの名前は独自の扱いで、クラウドセッション内では裸の名前として扱われ、他のソースの同名スキルとの衝突や名前解決の優先順位が文書で明示されていなかった

変更後

cloud セッションで claude.ai から同期されたスキルが anthropic-skills:<name> 形式の名前に統一され、競合がない場合は従来どおりの裸の名前でも呼び出せる

ユーザーへの恩恵

Claude Desktop と同じ名前空間規則になるため、同名スキルの衝突時にどちらが優先されるかを事前に把握しやすくなる

変更前

Opus 4.7、Opus 4.8、Fable 5 ではデフォルトの effort レベルが固定されているため、カスタムコマンド、スキル、サブエージェントのフロントマターに書かれた effort: の指定が無視されていた。

変更後

これらのモデルでは effort: フロントマターが尊重され、カスタムコマンド、スキル、サブエージェントがそれぞれ指定された effort レベルで実行される。

ユーザーへの恩恵

モデル側のデフォルト固定に左右されず、コマンドやスキル、サブエージェントごとに意図した推論の深さを設定した通りに使えるようになる。

変更前

エージェントチームのチームメイトや再開されたサブエージェントで、SubagentStart フックのコンテキストや事前ロードされたスキルが、後続ターンでプロンプトの先頭部分から外れてしまっていた。その結果、プロンプトキャッシュの再利用が機能せず、トークンコストや応答の効率が低下していた

変更後

SubagentStart フックのコンテキストと事前ロードされたスキルが、エージェントチームのチームメイトや再開されたサブエージェントの後続ターンでもプロンプトのプレフィックス(先頭部分)に保持されるようになった

ユーザーへの恩恵

エージェントチームのチームメイトや再開されたサブエージェントでもプロンプトキャッシュの再利用が有効になり、トークンコストを抑えつつ応答効率を改善できる

変更前

エンタープライズ管理設定で skills がプラグイン限定としてロックされているだけで、agents には制限がないにもかかわらず、/add-dir <subdirectory> を実行するとサブディレクトリの .claude/agents/ にあるサブエージェントが読み込まれず拒否されていました。

変更後

エンタープライズの管理設定で「skills をプラグイン限定にする」ポリシーが有効なとき、/add-dir <subdirectory> で追加したサブディレクトリ内の .claude/agents/ のサブエージェントまで読み込み拒否される不具合を修正しました。skills のロックは agents に影響しないはずなのに、/add-dir 経由のサブエージェント発見が一緒にブロックされていました。

ユーザーへの恩恵

skills のロックしかしていないチーム環境でも、/add-dir で追加したサブディレクトリのサブエージェントを通常どおり使えるようになる。

変更前

フォークされたスキル(context: fork)の開始プロンプトがストリーミングされず、--forward-subagent-text を付けてもテキストターンが stream-json の進捗イベントとして配信されていなかった。

変更後

フォークされたスキル(context: fork)の開始プロンプトがストリーミングで配信されるようになり、さらに --forward-subagent-text を付けた場合は、テキストターンが stream-json の進捗イベントとしても出力されるようになった。

ユーザーへの恩恵

フォークされたスキルの実行状況を stream-json の進捗イベントとしてリアルタイムに把握できるようになる。

変更前

どのスキルが実際に使われているか、あるいはコンテキストをどれだけ消費しているかを確認する手段がありませんでした。不要になったスキルを特定するには、OpenTelemetry のログエクスポーターを有効化して skill_activated イベントを収集するなど、手間のかかる方法しかありませんでした。

変更後

新版では /skill-doctor コマンドが追加されました。読み込まれているスキルのうち実際には使われていないものと、それぞれがコンテキストウィンドウで消費しているコスト(トークン量)を一覧で確認できます。この情報をもとに、不要なスキルを削除(prune)してコンテキストを節約できます。

ユーザーへの恩恵

ユーザーはコマンド一つで未使用スキルとそのコンテキストコストを把握し、不要なスキルを削除してコンテキストを節約できるようになりました。

変更前

対話セッション中にカスタムコマンドやスキルを実行すると、フロントマターで指定された model: の設定が無視され、デフォルトのモデルが使用されていました。

変更後

対話セッション中でも、カスタムコマンドやスキルのフロントマターで指定された model: の設定が正しく反映されるようになりました。

ユーザーへの恩恵

開発者は対話セッション中でも意図したモデルを指定してコマンドやスキルを実行できるようになります。

変更前

現在の作業ディレクトリ内のディレクトリを /add-dir コマンドで追加しようとすると、そのディレクトリのスキルやコマンドが読み込まれず、エラーとして拒否されていました。

変更後

現在の作業ディレクトリ内のディレクトリを /add-dir コマンドで追加できるようになりました。起動時の --add-dir と同様に、そのディレクトリ内の .claude/skills/、.claude/commands/、.claude/agents/ が自動的に読み込まれます。

ユーザーへの恩恵

作業中のディレクトリ内のカスタムスキルやコマンドを、起動時と同じように即座に利用できるようになります。

変更前

別の Claude Code プロセスが同時にプラグインマーケットプレイスを更新していた場合、バックグラウンドセッションが時折プラグインスキルなしで開始され、そのままの状態で継続していました。

変更後

別の Claude Code プロセスが同時にプラグインマーケットプレイスを更新していた場合でも、バックグラウンドセッションはプラグインスキルなしで開始されることはなくなりました。

ユーザーへの恩恵

プラグインスキルが正しくロードされ、セッションの機能が完全に利用可能になります。

変更前

矢印キー+Enterでナビゲートした行の上の行が誤って選択されていました。

変更後

矢印キー+Enterで正しい行が選択されるようになりました。

ユーザーへの恩恵

コマンドの実行が正確になり、操作ミスが減ります。

変更前

プラグインスキルのフロントマター name にすでに <plugin>: プレフィックスが含まれている場合、スラッシュメニューでそのプレフィックスが重複して表示されていました

変更後

プラグインスキルのフロントマター name にすでに <plugin>: プレフィックスが含まれている場合、スラッシュメニューでそのプレフィックスが重複して表示されなくなりました

ユーザーへの恩恵

プラグインスキルのコマンド名が正しく表示されるようになり、使い勝手が向上しました

変更前

skills/*/SKILL.md でスキルを定義しているプラグインに対し、/reload-plugins がスキル数を 0 と報告していました。

変更後

skills/*/SKILL.md でスキルを定義しているプラグインに対し、/reload-plugins が正しいスキル数を報告するようになりました。

ユーザーへの恩恵

正しいスキル数を確認できるようになります。

変更前

移動後の新しいディレクトリのプロジェクト設定、フック、.mcp.json サーバー、スキル、エージェントは、--resume を実行した後にのみ有効になっていました。

変更後

移動後の新しいディレクトリのプロジェクト設定、フック、.mcp.json サーバー、スキル、エージェントが、移動直後に有効になるように変更されました。

ユーザーへの恩恵

ディレクトリを移動した後、すぐに新しい設定やスキルが適用されるため、作業の継続がスムーズになります。

変更前

開発中に一時的に作業ディレクトリをクリーンアップまたは削除した場合、その後のすべてのコード変更やスキルのリロード処理で例外エラーが毎ターン発生していました。

変更後

ディレクトリの状態を正しく検知・ハンドリングするため、一時的なフォルダ削除の後でもスキルの変更監視とホットリロードがエラーを起こさず継続します。

ユーザーへの恩恵

ビルドスクリプト等で作業用ディレクトリを削除するたびに、連携している開発セッションを立ち上げ直す必要がなくなります。

変更前

開発中のスキル定義ファイル（SKILL.md）のフロントマター（メタデータ部分）に構文エラーがあっても、事前に検証する手軽な方法がなく、実際に実行してロードエラーになるまで不具合に気づきにくい状態でした。

変更後

プラグインのパッケージ化をしていないシンプルな .claude/skills ディレクトリであっても、検証コマンドを実行するだけでフロントマターの記述ミスを一括検知できます。

ユーザーへの恩恵

カスタムスキルを自作する際、実際に動かしてみることなくコマンド一発でメタデータの設定ミスを発見し、修正できるようになります。

変更前

claude.ai側から自動同期されて読み込まれるスキルが、ローカルマシン上に存在する同名のコマンドやMCPプロンプトを上書きして非表示にしてしまう危険性があり、また同期されたスキル本体がローカルシステム上で不意に任意のシェルコマンド(!記法)を実行したり、ファイルを読み込むといったセキュリティー上の懸念がありました。

変更後

同期スキルがローカル要素を上書きすることを防ぎ、詳細説明にはサニタイズと同期元ラベルが追加されます。また、同期されたスキルの実行時にはシェルコマンドの呼び出し(!記法)やローカルファイルのインポート(@記法)が無効化されます。

ユーザーへの恩恵

クラウドから同期されたスキルを実行する際、手元のPC上のファイルやシェルコマンドが意図せず操作される危険性を排除します。

変更前

サブエージェントとして実行したいモデルの選択が組織のポリシーなどで制限されている場合、警告なしに黙って親モデルへとフォールバックして処理が実行されていたため、どのモデルでタスクが実行されているかを正確に把握できませんでした。

変更後

指定したサブエージェントモデルが制限されて親モデルで代わりに実行される際、ターミナル上で明確に警告が表示されるようになります。

ユーザーへの恩恵

意図しないモデルの利用や制限による挙動の変化に、警告メッセージを見るだけですぐに気づけるようになります。

変更前

プラグインや組織経由で提供されたスキルが、同名の組み込みコマンドによって上書き・ブロックされていました。

変更後

スキルが優先的に解決されるようになり、非対話モードでもこれらのスキルを呼び出せるようになりました。

ユーザーへの恩恵

プラグインのスキルをいつでも実行できるようになります。

変更前

スキルパスの指定が制限されており、定義ミス時の修正が直感的ではありませんでした。

変更後

プラグインルートをスキルパスとして指定可能にし、エラーメッセージで適切な配置を推奨するようにしました。

ユーザーへの恩恵

プラグイン作成時のスキル配置ミスによるエラーを即座に修正できるようになります。

変更前

フォークしたタスクがフォアグラウンドで待機されることが多く、メイン作業を圧迫していました。

変更後

バックグラウンドがデフォルトになり、個別にfalse指定で変更可能になりました。

ユーザーへの恩恵

重いサブタスクを裏側で実行し、自身のメイン作業を中断させずに並行作業ができます。

変更前

プラグインのスキル名が正しく表示されず、どのプラグイン由来か特定できない状態でした。

変更後

スキル名とプラグイン名の紐付けを維持し、補完時にプレフィックスが正しく適用されるようになりました。

ユーザーへの恩恵

多数のプラグインを使っている環境でも、迷わずに正しいコマンドを選択できるようになります。

変更前

以前は Claude が状況に応じて /verify や /code-review スキルを自動的に判断し、実行していました。ユーザーが意図しないタイミングでこれらのスキルが起動されることがありました。

変更後

Claude が自動でこれらのスキルを実行することはなくなり、ユーザー自身が明示的に /verify や /code-review と入力したときのみ実行されるようになりました。

ユーザーへの恩恵

Claude が勝手にスキルを実行しなくなるため、自分の意図しないタイミングでレビューや検証が開始されるのを防げます。

変更前

スキル定義の中に $1 や $2 と記述しており、呼び出し時にその引数が渡されなかった場合、その文字列自体が消えてしまっていた。これにより、ドキュメント内の正規表現やシェルの変数記述が壊れることがあった。

変更後

対応する引数がないプレースホルダーは、置換されずにそのままの文字列として残されるようになった。

ユーザーへの恩恵

スキル内でシェル変数や正規表現のパターンを記述する際、意図せぬ文字列の消失を気にする必要がなくなります。

変更前

セッションのたびにプロジェクトの検証用スキルが再生成されており、効率が悪くなっていました。

変更後

関連コマンドに変更があった場合のみ再生成するようにロジックを最適化しました。

ユーザーへの恩恵

不要なオーバーヘッドが削減され、セッション開始時のレスポンスが高速化します。

変更前

特定のコマンド引数の順序によって、プラグインのコンポーネントが正しく読み込まれない場合がありました。

変更後

フラグの指定順序に関わらず、プラグインが正しく認識され一覧に表示されます。

ユーザーへの恩恵

コマンド入力時の柔軟性が向上し、期待通りにプラグインを読み込めるようになります。

変更前

スラッシュスキルを重ねて指定しても、最初の1つしか適切にロードされない制限がありました。

変更後

最大5つまでの先行スキルが順次正しくロードされるようになりました。

ユーザーへの恩恵

複数のツールやスキルを組み合わせた複雑なコマンドを、より直感的かつスムーズに実行できるようになります。

変更前

プロジェクト内の特定のディレクトリに閉じたスキルを定義していても、コンテキストに応じて適切にロード・解決されない場合がありました。

変更後

作業中のファイルに近いディレクトリにあるスキルが優先的にロードされます。名前が衝突した場合は <ディレクトリ名>:<スキル名> という形式で識別され、両方のスキルが利用可能な状態に保たれます。

ユーザーへの恩恵

大規模なモノレポなどで、ディレクトリごとに特化したスキルを定義しても競合を恐れることなく、現在の作業文脈に最適な補助機能を活用できます。

変更前

自動化スクリプトなどで -p フラグを使用して実行する際、ネストされたスキルが「ディレクトリ名付きの名前」を持つと、権限確認が入り実行が中断されることがありました。

変更後

非インタラクティブな実行時でも、ディレクトリ修飾されたスキルが適切に権限チェックを通過し、スムーズに実行されるようになりました。

ユーザーへの恩恵

CI/CD やバッチ処理などの自動化ワークフローにおいて、複雑なスキル構成であっても途中で止まることなくタスクを完遂できます。

変更前

.claude/skills や .claude/hooks を共有フォルダへのシンボリックリンクとして構成している Linux 環境では、セキュリティサンドボックスが正しく初期化できずエラーになっていました。

変更後

シンボリックリンクを適切に解決してサンドボックスを起動できるようになりました。

ユーザーへの恩恵

設定ファイルを複数の場所で共有・管理している開発環境でも、セキュリティ機能を有効にしたまま安全に Claude Code を利用できます。

変更前

特定のプラグインやフックが原因で Claude Code が正常に動作しない場合、原因を特定するために設定ファイルを個別に書き換える必要がありました。

変更後

原因不明の挙動が発生した際、--safe-mode を使うことで純粋な Claude Code の状態で起動し、カスタマイズによる影響かどうかを即座に切り分けられます。

ユーザーへの恩恵

複雑な設定を維持したまま、問題発生時の原因究明を迅速に行えるようになります。

変更前

プロジェクト独自のワークフローのみを Claude に実行させたい場合でも、常に標準搭載のスキルがコンテキストに含まれていました。

変更後

この設定を有効にすることで、Claude が組み込み機能ではなく、プロジェクトで定義した特定のルールやスキルのみを優先して使用するように制限できます。

ユーザーへの恩恵

AI の挙動をより厳格に制御し、組織固有の標準フローのみに従わせたい場合に役立ちます。

変更前

自作のスキルやプラグインを使用する場合でも、マーケットプレイスを経由するか、特定の登録手順を踏む必要がありました。

変更後

.claude/skills ディレクトリにファイルを配置するだけで、Claude Code が自動的にプラグインとして認識し、読み込むようになります。

ユーザーへの恩恵

開発中のカスタムスキルを即座に試せるようになり、プラグイン開発のイテレーションが大幅にスピードアップします。

変更前

新しいプラグインを作成する際、ディレクトリ構造や manifest ファイルを手動で一から作成する必要がありました。

変更後

専用の init コマンドにより、推奨される構造を持つプラグインのスケルトンが瞬時に生成されます。

ユーザーへの恩恵

ボイラープレートの作成時間を節約し、スキルの実装そのものに集中できるようになります。

変更前

エージェントのディスパッチ入力では補完対象が限定的で、標準的なコマンドやスキルを呼び出す際に正確な名前を記憶している必要がありました。

変更後

IDEのように包括的な補完が効くようになり、エージェントに対して/コマンドや強力な標準機能を素早く指示できます。

ユーザーへの恩恵

タイピングミスが減り、エージェントへの指示出しがより直感的でスピーディになります。

変更前

スキルの定義ファイル(SKILL.mdなど)を新規追加したり編集したりした際、変更を反映させるには一度 CLI を終了して再起動する必要がありました。

変更後

コマンド一つでディレクトリが更新されるため、スキルの開発や調整を行いながら、現在のセッションですぐに最新のスキルを試すことができます。

ユーザーへの恩恵

開発中のスキルの反復試行がスムーズになり、作業の中断を最小限に抑えられます。

変更前

セッション開始時のフックで新しいスキルをセットアップしても、モデルがそれらを認識するのは次のセッションからになるというタイムラグがありました。

変更後

フックの実行完了と同時にスキルの再読み込みが行われるため、動的に追加されたコマンドも初回から即座に使用可能になります。

ユーザーへの恩恵

環境構築スクリプトなどをフックに組み込んだ際、自動セットアップされたツールをすぐに Claude に使わせることができます。

変更前

利用制限の使用状況を確認する際、セッション全体のトークン消費量しか分からず、どの機能がコストを押し上げているのか特定が困難でした。

変更後

/usageコマンドの結果にカテゴリー別の詳細な内訳が追加され、スキルやプラグイン、特定のMCPサーバーが消費したコストを個別に把握できるようになりました。

ユーザーへの恩恵

どのツールが予算を消費しているかを正確に把握できるため、効率的なコスト管理や不要なMCPサーバーの停止などの最適化が容易になります。

変更前

プラグインにどのような機能(コマンドやスキルなど)が含まれているかを確認するには、実際にインストールしてみるまで詳細が不明でした。

変更後

インストール前の詳細画面で、プラグインが提供する具体的なコンポーネント(スキルやフックの種類、MCPサーバー構成など)がすべて表示されます。

ユーザーへの恩恵

自分のニーズに合ったプラグインかどうかを事前に判断できるため、不要なプラグインのインストールを避け、安心して機能を拡張できます。

変更前

プラグイン開発時、スキルのパス設定に誤り(フォルダではなくファイルを指定)があってもバリデーションで見逃され、実行時に問題が発生することがありました。

変更後

バリデーションコマンドがこの誤りを検知し、親ディレクトリを指定するよう具体的な修正案を提示するようになりました。

ユーザーへの恩恵

プラグイン作成時の設定ミスを早期に発見でき、開発サイクルを短縮できます。

変更前

これまでのプラグイン構造では、スキルを定義するために必ず skills/ という特定のサブディレクトリを作成する必要がありました。

変更後

プラグインのルートディレクトリに SKILL.md を置くだけでスキルとして公開・利用できるようになり、単純なプラグイン構成がよりシンプルになりました。

ユーザーへの恩恵

小さな単一機能のプラグインを作成する際の手間が減り、より直感的に機能を拡張できるようになります。

変更前

カレントディレクトリをスキルの参照先として指定すると、プラグインディレクトリ外への不正アクセスとして誤認され、エラーが発生する場合がありました。

変更後

ルートパス指定の検証ロジックが修正され、適切なスキル読み込みが可能になりました。

ユーザーへの恩恵

プラグイン開発時のディレクトリ構成の自由度が高まり、構成エラーに悩まされることがなくなります。

変更前

どのスキルがどのプラグインによって追加されたものか判別できず、管理や設定変更が不便でした。

変更後

コンテキスト一覧にプラグイン名が付記されるため、スキルの出所が明確になります。

ユーザーへの恩恵

特定のスキルの挙動を変更したい時に、どのプラグインを操作すべきか即座に判断できます。

変更前

プラグイン設定の記述方法によって意図せずスキルが読み込まれなかったり、指定ミスがあってもエラーが出ずに無反応だったりするため、デバッグが困難でした。

変更後

スキルの自動検出ロジックが整理され、設定ミスがある場合にはサイレントに失敗するのではなく、明確なエラーメッセージが表示されるようになりました。

ユーザーへの恩恵

プラグイン開発時のミスに気づきやすくなり、カスタムスキルの導入がより確実になります。

変更前

スキルを context: fork (フォークされたコンテキスト) で実行したり、新しいサブエージェントを起動したりした際、その最初のターンで Web 検索などの一部のツールが認識されず、呼び出しに失敗することがありました。

変更後

サブエージェントやスキルの実行開始直後から、WebSearch や WebFetch を含むすべての遅延ロードツールが正しく利用可能になります。

ユーザーへの恩恵

複雑な調査タスクをサブエージェントに任せる際、最初からスムーズに外部情報の検索を開始できるため、作業の停滞がなくなります。

変更前

プロジェクトやユーザー設定で定義されたスキル(カスタムコマンド)が増えると、/skills で一覧を表示した際に目的のスキルをスクロールして探す手間が発生していました。

変更後

/skills 画面の上部にタイプ・トゥ・フィルター形式の検索ボックスが搭載されました。スキルの名前や説明の一部を入力するだけで、瞬時にリストが絞り込まれます。

ユーザーへの恩恵

多数のカスタムスキルを使い分けている場合でも、必要なスキルを迷わず数秒で探し出し、すぐに実行に移ることができます。

変更前

「パーミッション確認をスキップする」設定にしていても、Claude Code 自身の構成ファイルが格納される特定のディレクトリへの書き込みには、安全上の理由から追加の確認が求められていました。

変更後

スキルやエージェントの定義ディレクトリへの書き込みが自動承認の対象に含まれました。これにより、Claude に自身のスキルを自律的に追加・修正させる際のフローが中断されなくなります。

ユーザーへの恩恵

Claude に自身の機能を拡張させる自動化タスクにおいて、ユーザーが手動で承認ボタンを押す手間が省け、完全な自律動作を実現できます。

変更前

スキル一覧から選択して確定しようとしても、コマンドが入力欄に入らず、再度手動で入力し直す必要がありました。

変更後

Enter キーで選択したスキルが即座にプロンプト欄に挿入されます。

ユーザーへの恩恵

コマンドパレットのように直感的にスキルを呼び出せるようになり、操作のテンポが改善されます。

変更前

多数のスキルがある場合、どのスキルがコンテキストを多く消費しているかを把握するのが難しく、トークン節約のための整理が困難でした。

変更後

各スキルの「重さ」を視覚的に把握し、コンテキスト容量を圧迫しているスキルを特定して管理できるようになりました。

ユーザーへの恩恵

コンテキスト使用量の最適化が容易になり、長いセッションでもモデルの精度を維持しやすくなります。

変更前

AIによる自動実行を禁止している特定のスキル(デプロイなど)を、チャットの入力途中で手動呼び出ししようとすると正しく認識されないバグがありました。

変更後

どのような入力タイミングでも、明示的なスキル呼び出しが確実に実行されるように修正されました。

ユーザーへの恩恵

「特定の操作は必ず自分の手で実行したい」というルールが徹底され、AIとの連携における信頼性が向上します。

変更前

登録したスキルが増えると、画面下のほうに隠れたスキルをマウスやキーボードで見ることができず、選択が困難でした。

変更後

リストのスクロールが正常に機能するようになり、多数のカスタムスキルを一覧から自由に選べるようになりました。

ユーザーへの恩恵

自分だけのツールセットをいくらでも増やしていくことができ、複雑なワークフローを容易に管理・呼び出しできます。

変更前

プラグインの管理やカスタムスキルの実行において、特定の高度な設定が正しく反映されなかったり、更新処理がOSの制限に抵触することがありました。

変更後

プラグイン・スキルの読み込みと実行エンジンが刷新され、複雑なカスタマイズも意図通りに動作するようになります。

ユーザーへの恩恵

独自のワークフローをプラグインとして構築・配布する際の信頼性と柔軟性が大幅に向上しました。

変更前

プラグインを更新したり新しくインストールした際、その変更を適用するために Claude Code 自体を立ち上げ直す必要がありました。

変更後

セッションを維持したまま、コマンド一つで最新のプラグイン機能を注入できるようになりました。

ユーザーへの恩恵

新しいツールを試したり開発中のプラグインを調整したりする際のデバッグサイクルが大幅に短縮されます。

変更前

プラグイン内のスキルをディレクトリ参照で読み込む際、スラッシュコマンド名がディレクトリ名に依存していたため、インストール方法や配置によってコマンド名が変わってしまうリスクがありました。

変更後

ディレクトリ名に関わらず、スキルファイル内のフロントマテリアルで定義された name が一貫してスラッシュコマンド名として使用されます。

ユーザーへの恩恵

スキルの共有や配布において、ユーザーが常に同じコマンド名で機能を呼び出せるようになり、混乱を防ぎ、安定した利用体験を提供できます。

変更前

特定のパスに基づいたルールが有効な際、プロジェクトのルートディレクトリ外にある重要な設定ファイルやメモリファイルに AI がアクセスできないことがありました。

変更後

プロジェクト外にあるグローバルな設定ファイル等も、パーミッションの範囲内で正しく読み書きや編集が可能になりました。

ユーザーへの恩恵

ユーザー設定やグローバルな指示ファイルをAIが適切に更新できるようになり、プロジェクトを跨いだカスタマイズがスムーズに反映されます。

変更前

大量のスキルを登録している場合、スキルの一覧情報だけでコンテキスト窓の多くを占有してしまい、肝心の対話に使える容量が減っていました。

変更後

説明文が適切に切り詰められることで、スキル情報を保持しつつも、AIとの対話に最大限のコンテキストを割り当てられるようになりました。

ユーザーへの恩恵

多数のカスタムスキルをプロジェクトに追加しても、AIの推論能力や記憶保持への悪影響を最小限に抑えられます。

変更前

スキルが増えるにつれメニューの並び順が予測しにくくなり、目的のスキルを探すのに時間がかかっていました。

変更後

一覧が辞書順で表示されるようになり、多数のスキルの中から必要なものを素早く見つけられるようになりました。

ユーザーへの恩恵

コマンドラインでの操作スピードが向上し、多数の自動化スキルを使いこなす際の効率が改善します。

変更前

スキルの適用範囲やプロジェクトルールを特定のパスに制限する paths: フィールドにおいて、単一のパターンしか記述できない、またはリスト形式の処理が不十分な場合がありました。

変更後

YAMLのリスト形式で複数のグロブパターンを指定できるようになり、より柔軟な適用範囲の設定が可能になりました。

ユーザーへの恩恵

フロントエンドとバックエンドの特定ディレクトリなど、関連する複数のパスに対して一つのルールを効率的に適用でき、コンテキストの管理が容易になります。

変更前

スキルを実行する際、セッション全体の思考レベル設定がそのまま適用されるため、特定の高度なタスクを実行するたびに手動でレベルを切り替える必要がありました。

変更後

スキルの定義ファイル(SKILL.md など)のフロントマターで effort レベルを事前に設定できるようになり、実行時に自動で最適な思考深さが選択されます。

ユーザーへの恩恵

「コードレビューは high」、「簡単な挨拶は low」のように、タスクの性質に合わせて最適な推論リソースを自動配分でき、速度と精度のバランスを最適化できます。

変更前

Git ワークツリーを利用した並行作業中に、そのワークツリー独自の自動化スクリプトやカスタムスキルが認識されませんでした。

変更後

ワークツリー環境からでも正しく設定ファイルが読み込まれ、メイン環境と同じ自動化機能が利用可能になりました。

ユーザーへの恩恵

複数の機能を並行して開発する際も、一貫した開発体験と自動化ツールを維持できます。

変更前

git pull などで .claude/skills/ 内の多数のファイルを一括更新すると、競合によりプログラムが停止することがありました。

変更後

ファイル変更検知の同期処理が改善され、 monorepo などの大規模な環境でも安全にスキルファイルを管理できるようになりました。

ユーザーへの恩恵

チーム開発でスキルの更新が頻繁に行われるプロジェクトでも、ツールを再起動することなく安定して作業を続けられます。

変更前

スキルのディレクトリ内に配置したスクリプトや補助ファイルを実行する際、現在の作業ディレクトリからの相対パスを記述する必要があり、汎用性に欠けていました。

変更後

スキルがどこに配置されていても、この変数を使用することで常に正しいパスで内部ファイルを参照できるようになりました。

ユーザーへの恩恵

スキルの可搬性が高まり、チーム間での共有やプラグイン化がより簡単かつ確実に行えるようになります。

変更前

プロジェクトの依存パッケージ(node_modules)内に含まれる悪意のあるファイルや意図しないファイルを、Claudeがスキルとして読み込んでしまうリスクがありました。

変更後

Gitで無視されているディレクトリがスキルの探索対象から除外されるようになり、安全性が向上しました。

ユーザーへの恩恵

信頼できない外部ライブラリの影響を排除し、安心して開発環境でClaudeを利用できます。

変更前

スキルから同梱のスクリプトやテンプレートファイルを呼び出す際、絶対パスや相対パスの指定が難しく、スキルの配置場所が変わると動作しなくなるリスクがありました。

変更後

予約済みの変数を使用して自身のディレクトリを動的に参照できるようになったため、配置場所に依存しないポータブルなスキルを構築できるようになりました。

ユーザーへの恩恵

スキルの再利用性や配布が容易になり、外部スクリプトと連携するような高度なスキルをより安定して動作させることができます。

変更前

明示的な説明文がないスキルは、たとえファイルが存在していても「利用不可」とみなされ、コマンドメニューや自動実行の対象外になってしまうことがありました。

変更後

説明文がなくてもファイル名などからフォールバックして認識されるようになり、記述が不完全な自作スキルでも確実に利用できるようになりました。

ユーザーへの恩恵

スキルの作成がより手軽になり、設定漏れによる「動かない」トラブルを減らすことができます。

変更前

「/clear」コマンドを実行しても、キャッシュされたスキル情報がリセットされず、古い情報が引き継がれてしまうことがありました。

変更後

「/clear」コマンドでスキルキャッシュが適切にリセットされるようになり、常に最新のスキル情報が利用できるようになりました。

ユーザーへの恩恵

会話をリセットする際の意図しない古いスキルの利用を防ぎ、より正確で一貫した動作を保証します。

変更前

プラグインに含まれるエージェントスキルが、完全なプラグイン名ではなく、単純なスキル名(ベア名)で参照された場合、エラーなくロードに失敗し、スキルが利用できない状態になっていました。

変更後

プラグインエージェントスキルのロードに関する問題が修正されました。ベア名で参照された場合でも、サイレントなロード失敗がなくなり、スキルが正しくロードされるようになりました。

ユーザーへの恩恵

プラグイン内のエージェントスキルが、より柔軟な参照方法で利用できるようになり、開発者はプラグインの連携を容易にしました。

変更前

多数のカスタムスキルをインストールすると、Claude Codeの組み込みスラッシュコマンド(/help、/modelなど)がオートコンプリートの候補リストから消えてしまい、発見や利用が困難になっていました。

変更後

多数のユーザー定義スキルがインストールされている場合でも、組み込みスラッシュコマンドがオートコンプリートドロップダウンに正しく表示されるようになりました。

ユーザーへの恩恵

組み込みコマンドの発見性が向上し、ユーザーはClaude Codeの基本機能をより容易に利用できるようになりました。これにより、ツールの使い勝手が向上しました。

変更前

gitワークツリーからClaude Codeを実行する際、プロジェクトレベルの.claude/agents/および.claude/skills/ディレクトリにあるカスタムエージェントやスキルが検出されない問題がありました。

変更後

gitワークツリーから実行した場合でも、プロジェクトレベルの.claude/agents/および.claude/skills/が正しく検出されるようになりました。

ユーザーへの恩恵

gitワークツリー環境でのカスタムエージェントとスキルの利用が改善され、開発者はワークツリー内でもプロジェクト固有の設定を正しく利用できるようになりました。

変更前

以前は、サンドボックスモードで動作しているClaude Codeが、許可なく.claude/skills ディレクトリにファイルを書き込む可能性がありました。これにより、セキュリティ上の懸念や、予期せぬ変更が発生するリスクがありました。

変更後

今回の変更により、サンドボックスモードでは、Claude Codeが.claude/skills ディレクトリにファイルを書き込むことができなくなりました。これにより、サンドボックスの隔離性が強化され、不必要なファイル操作が防がれます。

ユーザーへの恩恵

ユーザーは、サンドボックス環境でのセキュリティが向上し、Claude Codeが意図しないスキルファイルを作成・変更するリスクがなくなります。これにより、より安全で予測可能な開発環境を維持できます。

変更前

これまでは、追加ディレクトリ(--add-dir)で指定された場所にあるスキルは自動的にロードされませんでした。そのため、ユーザーはこれらのスキルを手動でロードするか、セッションを再起動する必要がありました。

変更後

追加ディレクトリ内のスキルが自動的に検出され、ロードされるようになりました。これにより、モノレポ構成などでパッケージ固有のスキルを使用している場合でも、それらのスキルがすぐに利用可能になります。

ユーザーへの恩恵

スキルをより柔軟に管理できるようになり、特に複数のプロジェクトや共有リソースを持つ環境での作業効率が向上します。セッション中にスキルを編集した場合も、再起動せずに変更が即座に反映されます。

変更前

カスタムスキルを利用するには、特定のディレクトリに配置する必要があり、管理が煩雑でした。

変更後

サブディレクトリ内の .claude/skills も自動で認識されるため、スキルの配置場所を気にする必要がなくなりました。

ユーザーへの恩恵

スキル管理の手間が省け、より柔軟にカスタム機能を利用できるようになります。

変更前

スキルファイルを新規作成したり既存のものを編集したりした際、その変更を反映させるには Claude Code のセッションを一度終了して再起動する必要がありました。

変更後

特定のディレクトリ内にあるスキルファイルが監視されるようになり、ファイルを保存するだけで Claude が自動的に最新の状態を読み込みます。

ユーザーへの恩恵

開発サイクルが高速化され、スキルの動作確認や微調整をストレスなくシームレスに行えるようになります。

変更前

スキルやコマンドを実行するとメインの会話コンテキストに履歴が蓄積され、トークン消費の増大や、メインエージェントの思考へのノイズ発生が避けられませんでした。

変更後

実行環境を独立したサブエージェントとして切り出せるようになり、大量のファイル読み込みや複雑な調査をメインの履歴を汚さずに行えます。

ユーザーへの恩恵

メインの会話履歴(コンテキスト)を節約しつつ、特定のタスクのみを専門のワーカーに任せるような高度な自動化フローを構築できます。

変更前

フォークされたコンテキストでスキルを実行する際、どの方針(読み取り専用か、書き込み許可かなど)を持つエージェントが担当するかを詳細に制御できませんでした。

変更後

タスクの性質に合わせて適切なビルトインエージェントやカスタムエージェントを選択し、スキルを実行できるようになります。

ユーザーへの恩恵

例えば、調査タスクには Explore エージェントを、複雑な修正には Bash エージェントを割り当てるなど、安全かつ効率的な役割分担が可能です。

変更前

以前のセッションを再開すると、そのプロジェクトに特化したカスタムスキルやディレクトリ構造の再スキャンが不完全で、Claude がそれらを認識できないことがありました。

変更後

セッションの再開時にも、最新のプロジェクトコンテキストと利用可能なスキルが正確に復元されるようになりました。

ユーザーへの恩恵

作業を中断した場所から、環境の差異を気にすることなくスムーズに開発を再開できます。