Claude Code Skills

変更前

修正前は、claude-api スキル内のエラーコード参照が実際の挙動と一致しておらず、モデルアクセス失敗やベータヘッダー利用不可のケースを誤って 403 として説明していた。

変更後

修正後は、モデルアクセス失敗時には 404、利用不可のベータヘッダーには 400 を返すなど、実際の API 応答とエラーコード参照の内容が一致する。

ユーザーへの恩恵

スキルが参照するエラーコードが正確になり、開発者が API エラーを診断する際に誤ったステータスコードを前提にするリスクを減らせる。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

マネージド設定でバンドルスキルのエイリアス(例: /doctor に対する checkup)をキーにした skillOverrides エントリーを書いても無視され、スキルを非表示にできなかった。また、Skill(name) の deny ルールは <dir>:name 形式で列挙されたネストされたスキルをカバーしておらず、そのようなスキルの呼び出しをブロックできなかった。

変更後

マネージド設定の skillOverrides エントリーが、バンドルスキルのエイリアス(例: /doctor の checkup)をキーにしても適用されるようになった。また、Skill(name) の deny ルールが <dir>:name 形式で列挙されたネストされたスキルにも一致するようになった。

ユーザーへの恩恵

管理者はバンドルスキルをエイリアス名でも確実に無効化でき、deny ルールでネストされたスキルの呼び出しも確実にブロックできる。

変更前

スキルやスラッシュコマンドを実行すると、IDE で選択していた行の選択状態が失われ、「N 行選択中」というコンテキストが Claude に届いていませんでした。

変更後

スキルやスラッシュコマンドを実行しても IDE で選択中の行が維持されるようになり、「N lines selected」というコンテキストが Claude に届くようになりました。

ユーザーへの恩恵

エディタでコードを選択したままコマンドを実行でき、選択範囲を明示した指示をそのまま Claude に伝えられるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

コード内のバグや不具合が発生し、システムの安定性が損なわれることがありました。

変更後

バグの特定から修正、およびシステムの安定性を高めるための改善が行われました。

ユーザーへの恩恵

開発者はバグ修正や信頼性向上の作業を効率化し、より安定したコードベースを維持できるようになります。

変更前

セッションでエラーが発生した際、ユーザーは手動でフィードバックを記述する必要がありました。

変更後

Claudeが自動的にフィードバック報告書をドラフト作成し、ユーザーがレビューして送信できるようになりました。

ユーザーへの恩恵

エラー報告の手間が省け、フィードバックの品質が向上します。

変更前

APIの使用状況を分析してコストを最適化する機能がありませんでした。

変更後

コスト要因を一つずつ測定して改善できるようになり、APIの使用効率が向上します。

ユーザーへの恩恵

APIコストを最適化し、予算内で開発を継続できます。

変更前

/claude-apiスキルは一部のAdmin API機能しか利用できませんでした。

変更後

より多くのAdmin API機能が利用可能になり、組織の管理が強化されました。

ユーザーへの恩恵

組織の管理タスクが効率化され、セキュリティとコンプライアンスが向上します。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

/-- で始まるプロンプト（Lean ドキュメントコメントなど）が未知のスラッシュコマンドとして拒否されていました。

変更後

/-- で始まるプロンプトは未知のスラッシュコマンドとして拒否されず、Claude に送信されるようになりました。

ユーザーへの恩恵

Lean ドキュメントコメントなどのプロンプトが正常に送信されるようになります。

変更前

Python プロジェクトで古い anthropic SDK（0.x）を使用している場合、手動でコードを書き換えて 1.x にアップグレードする必要がありました。また、タイムアウトの設定に httpx.Timeout が参照されたままになっていました。

変更後

/claude-api upgrade コマンドを実行するだけで、プロジェクト内の API 移行が自動的に行われます。さらに、スキルの Python リファレンスも更新され、タイムアウトには 1.x に準拠した anthropic.Timeout が正しく使用されるようになります。

ユーザーへの恩恵

古い API コードを検索して手動で書き換える手間をかけることなく、1コマンドで最新の SDK 仕様に適合させることができます。

変更前

セルフホストされたサンドボックス環境でManaged Agentsを動かす際、WebSearchツールやWebFetchツールでの独自ドメイン設定や、セッションをまたぐメモリ保存領域を適切に連動させて制御する仕組みが不足していました。

変更後

同梱の「claude-api」スキルがアップデートされ、組織固有のセルフホスト環境であっても、Web検索・取得のアクセス許可ドメイン設定やメモリ保存機能が正しく適用されるようになります。

ユーザーへの恩恵

セルフホスト環境のサンドボックスから、セキュリティポリシーに沿った安全なWeb検索やメモリ機能を利用できるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

claude-api などの大規模な仕様解説を含む内蔵スキルをセッション内で一度でもロードすると、巨大なAPI定義ドキュメント全体がコンテキストウィンドウの先頭に一括して詰め込まれるため、会話履歴で使えるトークン残量が最初から極端に削られていました。

変更後

スキルの定義は最小限の説明のみで読み込まれ、具体的なAPIの使い方やリファレンスの詳細は Claude が実際にその情報を必要として呼び出した瞬間にのみ必要な部分だけがコンテキストに追加されるようになります。

ユーザーへの恩恵

重いリファレンス系のスキルを使用する際に、AIのトークン消費量を節約し、セッションがすぐに文字数オーバー（オートコンパクト）になって過去の重要な対話履歴が消えてしまうのを防ぐことができます。

変更前

プロジェクト側で独自に作成した review スキルなどが優先される際、Claude Code 組み込みの /review などのショートカット用エイリアスまで連動して無効化され、「不明なコマンド」としてエラーになっていました。

変更後

ユーザー定義スキルが同名の同梱スキルを上書き（シャドウイング）している場合でも、組み込みエイリアスは衝突せずに正常に動作を維持します。

ユーザーへの恩恵

プロジェクトごとに同名のカスタムスキルを作成しても、慣れ親しんだ組み込みのショートカットコマンドをそのまま併用できます。

変更前

カスタムスキルに引数として $ や ${} を含む特定の文字列（コード片や環境変数など）を渡した際、その値が誤って内部のテンプレート変数置換として解釈・再評価され、意図しない値に化けてしまう問題がありました。

変更後

置換は一回のみ実行され、ユーザーから渡された引数の値そのものがそのままプレースホルダーに埋め込まれるようになります。

ユーザーへの恩恵

ドル記号や中括弧を含む複雑な文字列やコード、パスプレースホルダーをエラーの心配なく引数としてスキルに渡すことができるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

Claudeによる自動起動が禁じられたスキルがある時、Claudeが自分で似たような手順を勝手に再現しようとしてしまい、意図しない破壊的アクションなどが起こる恐れがありました。

変更後

自動起動禁止スキルが必要と判断した際、Claudeは処理を止めてユーザーへ「手動でこのスキルコマンドを実行してください」と直接リクエストします。

ユーザーへの恩恵

意図しないスクリプトの自動模倣を防ぎ、危険な定型処理を人間の手動トリガーの安全な監視下のみで確実に実行させることができます。

変更前

API連携スキルにおいて古いOpus 4.8がデフォルト設定となっており、最新モデルを利用するために手動での変更が必要でした。

変更後

最新のOpus 5が標準となり、必要に応じてスムーズに移行が行える構成になりました。

ユーザーへの恩恵

モデルを手動で書き換えることなく、標準設定のままで最新の高度な推論機能を利用できます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

真偽値としてtrue/falseのみがサポートされており、記述の柔軟性が低く不便でした。

変更後

yes, no, on, off, 1, 0も許容され、直感的な記述が可能になりました。

ユーザーへの恩恵

構成ファイルの作成時に、慣れた形式で柔軟にフラグを記述できます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

会話の初期段階で/loop(定期実行タスク)を使用すると、そのセッションがセッションピッカー(/resume)に表示されなくなり、後から作業を再開することが困難になっていました。

変更後

/loopを実行してもセッションが永続的に非表示になることはなくなりました。通常のセッションと同様に、後から履歴を辿って再開することが可能です。

ユーザーへの恩恵

定期的なチェックを行わせたセッションを、後でいつでも呼び出して詳細を確認したり続きを指示したりできるようになる。

変更前

Windowsのファイルパス制限により同期が不安定になることがありました。また、会話をリセット(/clear)すると、内部で使用しているWeb検索やフェッチ用のプロキシ接続が切れてしまい、検索ができなくなる問題がありました。

変更後

ディレクトリの命名がより堅牢になり、Windows環境での信頼性が向上しました。また、コンテキストをクリアしても内部プロキシの状態が維持されるようになり、一貫してWebツールを利用できます。

ユーザーへの恩恵

Windows環境やWeb検索を多用するワークフローにおいて、ツールが突然使えなくなるトラブルを避けられるようになる。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

標準搭載のデータ可視化スキルにおいて、チャートの色の違いが視覚的に十分でない場合や、色覚多様性の観点での閾値設定が最適化されていませんでした。そのため、生成されたグラフが一部のユーザーにとって読み取りにくいことがありました。

変更後

OKLab表色系を用いた知覚的な色差判定を導入し、色覚多様性に対応するための閾値を再調整しました。これにより、より多くのユーザーにとって判別しやすく、視覚的に洗練されたパレットでグラフが描画されるようになります。

ユーザーへの恩恵

生成されたチャートの色が見づらいときに、手動で配色を指定し直す手間がなくなります。

変更前

設定ファイル内で[a-z]のようなパターンを記述する際に形式が不適切だと、ファイル検索やワークツリーへのファイルコピーが予期せず失敗したり、不完全な結果になったりすることがありました。

変更後

パターンの解析処理が堅牢になり、多少の記述の不備があっても致命的なエラーを避け、正しくファイルが読み込まれるようになりました。

ユーザーへの恩恵

ファイルの除外設定やスキル定義が意図通りに機能するようになり、リポジトリ構成の不整合によるエラーに悩まされることがなくなります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

スキルを繰り返し呼び出すと、その指示内容が都度コンテキストに追加され、貴重なコンテキストウィンドウを消費していました。

変更後

スキル実行時に既存のスキル手順が既に存在する場合は重複登録を避けるようにし、効率的に管理します。

ユーザーへの恩恵

コンテキストウィンドウの消費を抑え、複雑なスキルを多用してもClaudeの推論精度を維持しやすくなります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

クリーンアップ処理に多くのトークンを消費し、効率が悪化していました。

変更後

処理の最適化により、品質レビューにかかるトークンコストが大幅に抑えられました。

ユーザーへの恩恵

レビューの効率化によりコストが削減されるため、より頻繁かつ低コストで品質レビューを実行できます。

変更前

インストールしたプラグインによって提供されているスキルを、プラグインの管理画面から直接確認することができませんでした。

変更後

Installedタブ内にSkillsセクションが設けられたことで、各プラグインがどのスキルを導入したのかが一目で分かるようになりました。

ユーザーへの恩恵

プラグインを通じて追加された新機能を把握しやすくなり、適切なスラッシュコマンドを選択して実行することが容易になります。

変更前

設定キーの記述形式が厳格に固定されており、慣れない形式で記述するとエラーになる場合がありました。

変更後

display-name、default-enabled、fallback などの主要なキーで柔軟な命名規則がサポートされました。

ユーザーへの恩恵

開発者が使い慣れたコーディングスタイルでスキル定義ファイルを記述できるようになり、記述ミスの軽減に繋がります。

変更前

フロントマターの構文エラーがあるとスキル全体が無視され、なぜコマンドが機能しないのか原因が分かりにくい状態でした。

変更後

多少の構文エラーがあってもスキル自体はロードされ、利用可能な状態を維持するように堅牢性が向上しました。

ユーザーへの恩恵

軽微な記述ミスでスキルが使えなくなるトラブルを防ぎ、スムーズなカスタマイズを可能にします。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

ディレクトリを移動した後も、ステータスラインや内部情報が移動前のブランチ名を表示したままになることがありました。

変更後

移動先のディレクトリに基づいた最新の Git 情報が即座に反映されるようになります。

ユーザーへの恩恵

現在の作業コンテキストを正確に把握でき、誤ったブランチに対して操作を依頼するリスクを回避できます。

変更前

使用状況の表示が大まかな合計値に限られており、どのスキルや MCP サーバーがどれだけのトークンを消費しているのか詳細を把握することが困難でした。

変更後

時間枠ごとの内訳や、キャッシュ効率、さらには特定のカスタムツールごとの消費量が視覚化され、詳細なコスト分析が可能になりました。

ユーザーへの恩恵

使用量の多い要因を特定してプロンプトを最適化したり、特定のツールのコスト対効果を評価したりすることが可能になります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

モデルがタスクを作成する際に微細なフォーマットエラーを起こすと、タスクの登録自体が失敗することがありました。

変更後

Claude がタスクリストをより正確かつ柔軟に操作できるようになり、タスクの進捗管理がより堅牢になりました。

ユーザーへの恩恵

複雑なタスクを AI に任せる際の、内部的なエラーによる中断が少なくなります。

変更前

スキル定義のコマンド内で「$1」のようにドル記号と数字が並ぶと、変数値の置換と誤認される制限がありました。

変更後

バックスラッシュによるエスケープが可能になり、金額やシェル変数などドル記号を含む文字列を正確に記述できます。

ユーザーへの恩恵

シェルスクリプトや価格情報を含む複雑なカスタムスキルを、構文エラーを気にせず定義できるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

/simplifyを実行すると、内部的に/code-review --fixが呼び出されており、単純なコードの簡素化を望んでいる場合でも、バグハンティングを含む重いレビュープロセスが実行されていました。

変更後

/simplifyはクリーンアップ(共通化、効率化など)に特化したレビューとして独立しました。バグの探索は行わず、コードの可読性や効率の改善のみを迅速に行います。

ユーザーへの恩恵

意図しないロジック変更のリスクを減らしつつ、リファクタリングやコードの整理をより高速かつ確実に行えるようになります。

変更前

最新モデルであるClaude Opus 4.8を自身のアプリケーション開発で活用したい場合、APIの仕様変更や移行のベストプラクティスを自分で調べる必要がありました。

変更後

Claude Code内のヘルプスキルを通じて、Opus 4.8の最新リファレンスや、コードを4.8向けに自動アップグレードするためのガイダンスを直接受け取れます。

ユーザーへの恩恵

Anthropicの最新モデルのパワーを、自身のプロダクトに最小限の調査コストで安全に導入できるようになります。

変更前

以前の /code-review は修正箇所の指摘のみを行い、修正を適用するにはユーザーが手動でコードを書き換えるか、別のコマンドを組み合わせる必要がありました。

変更後

修正案の提示から適用までが一貫して行えるようになり、コードの重複排除やリファクタリング、効率化の提案が直接ワーキングツリーに反映されます。

ユーザーへの恩恵

レビューで見つかった改善点を即座にコードに適用できるため、品質向上と開発サイクルの高速化を同時に実現できます。

変更前

スキル実行中に、意図しないツールの使用(例：特定の操作中にファイル削除ツールを呼ばせないなど)をきめ細かく制御することが困難でした。

変更後

スキルごとに利用可能なツールのセットを制限できるため、モデルが特定のワークフローに集中し、より安全かつ正確に動作するように定義できます。

ユーザーへの恩恵

カスタムコマンドの挙動をより厳密に制御でき、エージェントによる誤操作や不要なツール呼び出しのリスクを軽減できます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

スキルの定義ファイル内の名前とフォルダ名が一致していない場合、コマンドを入力しても次に何を入力すべきかのガイド(引数ヒント)が出現しませんでした。

変更後

スキルの定義名がどのようなものであっても、Tab補完後に適切な引数ヒントや候補が動的に表示されるようになりました。

ユーザーへの恩恵

カスタムスキルの使い勝手が向上し、定義をいちいち確認しなくても正しい引数でコマンドを打ち込めるようになります。

変更前

特定のスキルが独自の「effort」設定で動作している間も、ステータスバーにはユーザーがデフォルトで設定している数値が表示されており、実際の動作と表示が食い違っていました。

変更後

現在アクティブなスキルやエージェントが適用している、実際の思考レベルがステータスバーに正確に反映されるようになりました。

ユーザーへの恩恵

Claudeが現在どれだけの「思考の深さ」で作業しているのかを、ステータスバーを見て正しく把握できます。

変更前

以前の/simplifyは、コードの整理と修正を目的としたスキルでしたが、レビューに特化した機能やGitHub PRへの直接的なフィードバック送信機能は限られていました。

変更後

名称変更とともに、バグの検出と報告に特化したレビュー機能へ進化しました。エフォートレベルの調整や、GitHubとの連携によるPR上での直接的なコメント投稿が可能になります。

ユーザーへの恩恵

コードの品質チェックをClaudeに任せ、修正案をGitHub PRに直接反映させることができるため、チーム内でのコードレビューの効率が飛躍的に向上します。

変更前

特定のスキルを起動してすぐにバックグラウンドで作業を継続させようとしても、通常のテキスト入力がないという理由で移動できないことがありました。

変更後

入力の種類にかかわらず、会話のどの時点からでもスムーズにセッションをバックグラウンドへ移行できます。

ユーザーへの恩恵

定型的な自動化タスクをスキルとして起動し、すぐにターミナルを解放して別の作業に移るというワークフローが確実に実行できます。

変更前

既存の /simplify コマンドは、最近編集したファイルの品質や効率の修正を行う「スキルのセット」として定義されていましたが、名前から機能が直感的に伝わりにくい側面がありました。また、コードレビューの強度をユーザーが直接制御する手段も提供されていませんでした。

変更後

コマンド名が機能に即した /code-review になり、引数としてエフォートレベル(low, medium, high, xhigh, max)を指定できるようになりました。これにより、簡単なチェックから徹底的な分析まで、目的に応じたレビューが可能になります。

ユーザーへの恩恵

変更の意図が明確になり、重要なプルリクエスト前には高いエフォートレベルで深くレビューさせるなど、状況に応じた使い分けでコードの品質向上に役立てられます。

変更前

セッション開始直後に /batch などのスキルやカスタムコマンドのみを入力した場合、内部的なフラグ管理の不備により、/background によるデタッチ(バックグラウンド移行)が実行できない不具合がありました。

変更後

入力の種類に関わらず、スラッシュコマンドから始まるセッションでも正しくバックグラウンド処理へと移行できるようになりました。

ユーザーへの恩恵

大規模な変更を一括で行う /batch のような重い処理を、コマンド入力直後にすぐバックグラウンドに逃がしてターミナルを解放することができます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

特定の条件下でスキルが自分自身をフォークされたコンテキストで呼び出すと、意図せず無限ループが発生し、リソースを過剰に消費してしまうことがありました。

変更後

スキルが自分自身を無限に再invokeしないように制御が追加されました。

ユーザーへの恩恵

スキルの実行が安定し、予期せぬ無限ループによるトークンの浪費や動作のフリーズを防ぐことができます。

変更前

スキルのディレクトリ内でプログラムのビルドなどを行うと、大量の中間ファイル生成を検知してスキル再読み込みが走り、システムリソースを食いつぶしてエラーになることがありました。

変更後

監視対象を定義ファイルである .md ファイルに限定することで、無関係なファイル生成によるオーバーヘッドを解消しました。

ユーザーへの恩恵

スキルの開発やテストを行いながらビルドを実行しても、ツールが重くなったりクラッシュしたりせず、スムーズに開発を続けられます。

変更前

スキルをたくさん登録していると、起動するたびに「スキルが多すぎて一部が簡略化されています」という警告が毎回表示され、ノイズになっていました。

変更後

起動画面はクリーンに保たれ、問題がある場合だけ /doctor で詳細を確認する運用に変更されました。

ユーザーへの恩恵

毎回の起動がスッキリとし、本当に必要な警告(エラーなど)を見逃しにくくなります。

変更前

/loop コマンドの待機時間中に停止操作を行っても、次の実行スケジュールがキャンセルされず、意図せず再始動してしまうことがありました。

変更後

アイドル中のキャンセル入力を正しく受け取り、スケジュールされたタスクを完全に停止できるようになりました。

ユーザーへの恩恵

長時間のループ実行を、止めたいタイミングで確実に終了させることができます。

変更前

並列実行中の作業が完了する前に目標達成の判定が行われてしまい、誤った判定が下されることがありました。

変更後

すべての子プロセスやサブタスクの完了を待ってから、最終的なゴール評価が行われるように同期が改善されました。

ユーザーへの恩恵

複雑な並列作業の完了判定が正確になり、エージェントが確実に仕事を終えるまで監視を継続できます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

スキルの権限設定でワイルドカードを使っても、意図した通りのプレフィックス一致が行われない場合がありました。

変更後

Bashコマンドと同様のルールでワイルドカードが動作し、特定のプラグイン配下のスキルを一括で許可するなどの設定が確実に反映されます。

ユーザーへの恩恵

きめ細やかな権限管理を少ない記述で確実に行えるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

/myplugin review のように引数を伴うような形式のプラグインコマンドを実行しようとしても、正しく認識されず実行できないことがありました。

変更後

コマンドのパース処理が改善され、スペースを含むカスタムプラグインコマンドも確実に実行できるようになりました。

ユーザーへの恩恵

プラグインによって追加された高度な機能を、自然なコマンド入力で利用できます。

変更前

スキルをモデルやメニューから隠す、あるいは特定の条件下でのみ有効にするといった個別のオーバーライド設定が正しく反映されない問題がありました。

変更後

offで完全に隠す、user-invocable-onlyでユーザーのみ実行可能にする、name-onlyで説明を折り畳むといった制御が確実に行えるようになります。

ユーザーへの恩恵

多数のスキルがある場合でも、重要なものだけをモデルに見せることでコンテキストを節約し、作業効率を高めることができます。

変更前

Bedrock や Vertex AI などの環境では /fast モードがサポートされていませんが、コマンドを入力すると無関係なカスタムスキルが誤って起動してしまうことがありました。

変更後

サポートされていない環境では正しく「利用不可」であることが示され、意図しないスキルの実行を防ぎます。

ユーザーへの恩恵

プロバイダーごとの機能制限が明確になり、意図しない挙動による混乱を回避できます。

変更前

テレメトリデータにおいて、スキルが実行された事実は分かっても、それがユーザーの直接入力なのか、Claudeの自発的な提案なのか、あるいは別のスキルからの呼び出しなのかを区別できませんでした。

変更後

invocation_trigger属性により、"user-slash"(手動入力)、"claude-proactive"(Claudeによる提案)、"nested-skill"(入れ子実行)の識別が可能になりました。

ユーザーへの恩恵

組織内でのスキルの利用傾向をより詳細に分析し、どのスキルがどのように役立っているかを正確に把握して改善に役立てることができます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

カスタムスキルが実行される際、モデルがどの程度の思考深度(low/medium/high/max)で動作しているかをスキル側で把握する手段がありませんでした。

変更後

スキル定義内で ${CLAUDE_EFFORT} を使用することで、現在の推論設定に応じた動的な命令の切り替えやコンテキストの調整が可能になります。

ユーザーへの恩恵

高負荷(high effort)時にはより詳細な分析を指示するなど、ユーザーの設定に合わせた最適な出力をスキル側で制御できるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

現在実行中または予定されているタスクの一覧を取得した際、並び順がバラバラだったため、特定のタスクの進捗を追跡するのが困難でした。

変更後

タスクが生成された ID 順にソートされて表示されるようになります。

ユーザーへの恩恵

タスクの実行順序や依存関係を直感的に把握しやすくなり、複雑なマルチタスクの管理がスムーズになります。

変更前

フルパスでのファイル参照を入力しようとした際、コマンドの自動補完機能が誤ってコマンドとして解釈し、エラーを出すことがありました。

変更後

ファイルパスの入力を正しく認識し、コマンドと混同しないように改善されました。

ユーザーへの恩恵

ファイルパスのコピペがスムーズになり、AI への指示出しがより快適になります。

変更前

GitHub CLI (gh) を使用して PR 作成などを行う際、レート制限に達するとエージェントがエラーの原因を正しく理解できず、リトライを繰り返して制限をさらに悪化させることがありました。

変更後

レート制限エラーが発生した際、Bash ツールがエージェントに対して「レート制限に達した」という具体的なヒントを返すようになりました。これにより、AI は賢く「待機」を選択できるようになります。

ユーザーへの恩恵

API 制限による予期せぬエラーで作業が中断されるのを防ぎ、AI が自律的に適切なタイミングでリトライを行うため、GitHub 連携の信頼性が向上します。

変更前

/loop による定期実行の待機を途中で止める方法が分かりにくく、再開時の状況把握も困難でした。

変更後

Escキーで待機を即座に解除でき、再開時に「Claude resuming /loop wakeup」と表示されるため状態が明確になりました。

ユーザーへの恩恵

定期タスクの制御がより直感的になり、意図しないタイミングでのタスク実行を簡単に防げます。

変更前

頻繁に使う安全なコマンドであっても、その都度実行許可を求められることがあり、手動で.claude/settings.jsonに許可ルールを記述するのは手間でした。

変更後

新スキルが実行履歴から最適な許可リストを作成し、設定ファイルへの追加を提案してくれるため、セキュリティを維持しつつ承認の手間を最小限に抑えられます。

ユーザーへの恩恵

「何度も同じ許可を求められる」というストレスが軽減され、開発作業の中断回数を大幅に減らすことができます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

Claudeが勝手に「commitというコマンドがあるはずだ」と思い込んで実行し、結果として「Unknown skill」というエラーで処理が中断されることがありました。

変更後

Claudeが利用可能なスキルのみを正しく把握し、無効なコマンド呼び出しを行わないようになりました。

ユーザーへの恩恵

エージェントが勝手に自滅するようなエラーが減り、タスク完了までの流れが途切れることなくスムーズになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

モデルはビルトインの特殊なワークフローコマンドを直接認識できず、ユーザーが手動でコマンドを入力して指示する必要がありました。

変更後

エージェントがSkillツールを通じて自律的に適切なスラッシュコマンド(/init、/security-review等)を選択し、実行できるようになりました。

ユーザーへの恩恵

プロジェクトの初期化やコードレビューなどの定型的な高度なタスクを、Claudeに任せるだけで自動的に最適なツールを使って完遂してくれます。

変更前

プラグインがバックグラウンドでシステムの状態や特定のイベントを継続的に監視する標準的な仕組みが不足していました。

変更後

プラグインのマニフェストに「monitors」キーを定義することで、セッション中ずっと動作し続けるバックグラウンドプロセスを簡単に管理できるようになりました。

ユーザーへの恩恵

CIの結果待ちやログの監視など、開発者が手動で確認しなくてもClaudeがバックグラウンドで状況を把握し、必要な時に通知してくれるようになります。

変更前

定期的なポーリングやリマインダーを行うコマンドが「/proactive」と「/loop」で混在しており、機能の把握が難しくなっていました。

変更後

「/loop」が標準的な名称となり、どちらのコマンドを入力しても使い慣れた定期実行機能を利用できるようになりました。

ユーザーへの恩恵

コマンド体系が整理され、ドキュメントに記載されている定型タスクの繰り返し実行機能を迷わず利用できるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

分析レポートの作成が終わっても、そのファイルがどこに保存されたかの情報が提示されないことがありました。

変更後

レポート生成後、必ずファイルへのアクセス手段が表示されるようになります。

ユーザーへの恩恵

自分の作業傾向を分析した結果を、確実に確認・保存できるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

Anthropic の最新機能である Managed Agents に関するリファレンスが不足しており、AIにその実装方法を相談しても正確な回答が得にくいことがありました。

変更後

APIリファレンスが最新化され、より高度なAI連携アプリケーションの開発を Claude が強力にサポートできるようになりました。

ユーザーへの恩恵

最新のAI開発トレンドをその場で把握し、実装コードにすぐ反映させることができます。

変更前

「。/」のように日本語入力を続けていると補完が動かず、わざわざ「。 /」と半角スペースを入れなければならず、日本語入力の大きなストレスになっていました。

変更後

日本語の句読点のすぐ後にコマンドを入力しても、即座に候補が表示されるようになりました。

ユーザーへの恩恵

日本語での自然な対話の流れを止めることなく、スムーズにファイル参照やスキル呼び出しが行えます。

変更前

APIリファレンスを確認する際、標準的なAPIの情報は得られましたが、新しく登場したManaged Agentsの仕様や実装方法についてのガイドが含まれていませんでした。

変更後

最新のエージェント関連機能についても、ツール内から直接正確なリファレンスを参照できるようになりました。

ユーザーへの恩恵

ドキュメントサイトを探し回ることなく、エージェントを活用した高度なアプリ開発の情報を手元で素早く確認できます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

スキルファイル(SKILL.md)のフロントマテリアル内にフックを定義しても、システムに認識されず動作しない不具合がありました。

変更後

スキル定義内のフックが正しく読み込まれ、指定したイベントに応じて実行されるようになりました。

ユーザーへの恩恵

スキルのライフサイクルに合わせたカスタム動作を確実に行えるようになり、より高度なプラグイン開発が可能になります。

変更前

/claude-api スキルで提供される情報は基本的なAPIリファレンスが中心で、高度なエージェントを構築するための具体的な設計ノウハウまではカバーしきれていませんでした。

変更後

最新のAgent SDKを最大限に活用するための、ツール設計やキャッシュ効率化といった実践的なベストプラクティスが提供されるようになりました。

ユーザーへの恩恵

Anthropicのモデル特性を活かした、より高性能でコスト効率の良いAIエージェントを迅速に開発できるようになります。

変更前

画像を添付して指示を出すと、設定していたカスタムルール(CLAUDE.mdの内容など)が無視されてしまう場合がありました。

変更後

メッセージに画像が含まれていてもシステムプロンプトやコンテキストが一貫して維持されるようになり、指示の遵守率が向上しました。

ユーザーへの恩恵

スクリーンショットなどを活用した視覚的な指示を出しつつ、プロジェクトの規約に則った回答を確実に得ることができます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

起動時に「セットアップ」「スラッシュコマンドのロード」「エージェントのロード」を順番に行っていたため、入力が可能になるまでわずかな待ち時間がありました。

変更後

これらの準備処理を並列で実行するように改善され、起動時間が約30ms短縮されました。

ユーザーへの恩恵

claude と打ち込んでから入力できるようになるまでのレスポンスがより機敏になり、開発のリズムを崩しません。

変更前

過去のやり取りやツール実行の詳細を確認するトランスクリプトモードでは、特定のキーワードやエラーメッセージを探すために、長いログをすべて手動でスクロールして探す必要がありました。

変更後

標準的なターミナルツールと同様に、/ キーで検索バーを開き、会話履歴内を自由に検索できるようになりました。n や N キーでマッチした箇所を素早く移動できます。

ユーザーへの恩恵

膨大なデバッグログや過去の長い会話の中から、必要な情報を即座に見つけ出せるようになり、問題解決のスピードが向上します。

変更前

非インタラクティブモード(-p)でスクリプトを実行する際も、通常のセッションと同様にフックの実行やプラグインの同期、メモリの読み込みが行われていました。

変更後

--bare フラグを使用することで、純粋にモデルの推論のみを高速に実行できるようになります。このモードでは OAuth 認証等がバイパスされるため、API キーの設定が必須となります。

ユーザーへの恩恵

CI/CD パイプラインや自動化スクリプトにおいて、不要なオーバーヘッドを削減し、起動速度の向上と実行の安定性を確保できます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

プラグイン開発時に YAML のパースエラーやスキーマ違反があっても、実行するまで気づけないことがありました。

変更後

バリデーションコマンドで事前に構文エラーや設定の誤りを網羅的にチェックできるようになりました。

ユーザーへの恩恵

プラグイン開発のデバッグ効率が上がり、より高品質な拡張機能を短時間で作成できます。

変更前

モデル拡張コンテキストを使用している非常に長いセッションで特定のスキルを実行しようとすると、実際には余裕があるにもかかわらずコンテキスト不足のエラーが発生する場合がありました。

変更後

スキルの呼び出しにおけるコンテキスト計算ロジックが修正され、大規模なコードベースを対象にした作業でも安定してスキルを実行できるようになりました。

ユーザーへの恩恵

超巨大なプロジェクト全体をコンテキストに入れながら、カスタムスキルを制限なく活用した開発が可能になります。

変更前

シェルコマンドでパイプと感嘆符(!)を組み合わせて使用すると、エスケープが正しく行われずコマンドが失敗することがありました。

変更後

jq の比較演算子などを含む複雑なシェルコマンドも、Bash ツールを通じて正確に実行されるようになりました。

ユーザーへの恩恵

AIによる高度なフィルタリングや一括処理の精度が向上し、手動でのコマンド修正の手間が省けます。

変更前

組織レベルで確認を必須に設定していたツールであっても、ユーザーの個別設定や特定のスキルがそれを上書きして自動実行できてしまうセキュリティ上の懸念がありました。

変更後

パーミッションの優先順位が厳格化され、管理ポリシーで指定されたルールが個別の許可設定よりも優先して適用されるようになります。

ユーザーへの恩恵

企業やチームで定めたセキュリティ・ガバナンスが確実に適用され、意図しないツールの自動実行をより強固に防止できます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

特定のクラウドプロバイダーやプライバシー設定を利用しているユーザーは、定期的な状態確認などを行う /loop 機能が制限されていました。

変更後

環境に依存せず /loop スキルと cron ツールが利用可能になり、ビルド監視などの自動化が可能になりました。

ユーザーへの恩恵

あらゆる利用形態のユーザーが、スケジューリング機能による高度なワークフロー自動化の恩恵を受けられます。

変更前

定期的なデプロイ状況の確認やコードレビューなど、繰り返し行いたいタスクを毎回手動で入力するか、外部の cron ジョブとして設定する必要がありました。

変更後

/loop コマンドを使用することで、セッション内で直接、指定した時間間隔でコマンドやプロンプトを自動実行できるようになりました。

ユーザーへの恩恵

モニタリングや定期的なタスクの自動化が Claude Code 内で完結し、開発者が手動で繰り返しコマンドを打つ手間が大幅に削減されます。

変更前

過去の会話をレジュームする際、すでに把握しているはずのスキル情報が何度も送信され、無駄にコンテキストウィンドウと API コストを消費していました。

変更後

スキルの注入ロジックが見直され、重複した情報の送信が回避されるようになりました。

ユーザーへの恩恵

レジューム時の読み込みが速くなるだけでなく、1 回の再開につき約 600 トークンが節約され、コスト効率が向上します。

変更前

Claude APIを利用したツールやアプリケーションの開発時、リファレンスやベストプラクティスを別途ブラウザなどで調べる必要がありました。

変更後

/claude-api スキルを実行することで、主要なプログラミング言語向けのAPIリファレンスやSDKの使用例を即座にコンテキストに読み込めるようになりました。

ユーザーへの恩恵

開発中のコンテキストを離れることなく、正しいAPIの使用法やツール利用のパターンを確認できるため、実装のスピードと正確性が向上します。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

ユーザーに質問を投げるためのツールが「許可済み」リストに入っていると、プロンプトを出さずに空の回答で処理が進んでしまい、Claude が必要な情報を得られないまま暴走することがありました。

変更後

対話が必要なツールについては、リストに含まれていても必ずユーザーの入力を待つように修正されました。

ユーザーへの恩恵

Claude との認識の相違が減り、重要な確認事項が見逃されることなく、対話に基づいた正確なタスク遂行が期待できるようになります。

変更前

説明文の中に「用途：デバッグ、テスト」のようにコロンを使って記述すると、YAML 解析エラーが発生してスキルが機能しなくなる制限がありました。

変更後

コロンを含む説明文も正しくパースされるようになったため、より自然で詳細なスキルの説明を記述できるようになりました。

ユーザーへの恩恵

スキルの説明を分かりやすく書けるようになり、Claude が適切な状況で正しいスキルを選択する精度が向上します。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

コードのレビュー、リファクタリング、大規模な変更の自動化を行うための専用スラッシュコマンドがありませんでした。

変更後

「/simplify」コマンドでコードの改善提案と修正を、「/batch」コマンドでコードベース全体にわたる大規模な変更を、それぞれスラッシュコマンドから直接実行できるようになりました。

ユーザーへの恩恵

コードの品質向上と、複数ファイルにまたがる変更の自動化が容易になり、開発者の生産性が向上します。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

プラグインの SKILL.md ファイルの説明部分が予期しないデータ型(例: YAML配列)であった場合、スラッシュコマンドのオートコンプリート機能がクラッシュしていました。

変更後

スラッシュコマンドのオートコンプリート機能が、様々なデータ型の SKILL.md 説明を正しく処理できるようになりました。

ユーザーへの恩恵

プラグインの SKILL.md の説明部分のデータ型に関わらず、オートコンプリート機能が安定して動作するようになります。

変更前

長期間実行されるセッションでは、APIストリームバッファ、エージェントコンテキスト、スキル状態などのリソースが解放されずに蓄積され、メモリ使用量が増加する問題がありました。

変更後

長期間実行されるセッションにおけるメモリ使用量が改善されました。APIストリームバッファ、エージェントコンテキスト、スキル状態などのリソースが、使用後に適切に解放されるようになりました。

ユーザーへの恩恵

長時間のセッションでもメモリ使用量が抑えられるため、Claude Codeのパフォーマンスが安定し、メモリ不足による予期せぬ終了や遅延を防ぐことができます。これにより、ユーザーはより快適に長時間の作業に取り組めます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

SKILL.mdのフロントマッターで、nameやdescriptionに数値のみを指定した場合、Claude Codeがそれを正しく処理できず、クラッシュする問題がありました。

変更後

SKILL.mdフロントマッターのnameまたはdescriptionにベア数値が指定された場合でも、クラッシュせずに文字列として正しく変換されるようになりました。

ユーザーへの恩恵

スキル定義の柔軟性が向上し、数値のみの名称でも問題なくスキルを作成・利用できるようになりました。これにより、開発者はより自由にスキルの命名を行えます。

変更前

SKILL.mdのフロントマッターで argument-hint にYAMLシーケンス構文を使用すると、Reactアプリケーション内でクラッシュ(エラー #31)が発生する問題がありました。

変更後

SKILL.mdフロントマッターの argument-hint でYAMLシーケンス構文が使用された場合でも、Reactクラッシュ(エラー #31)が発生せず、値が文字列として正しく変換されるようになりました。

ユーザーへの恩恵

スキル定義における argument-hint の柔軟性が向上し、YAMLシーケンス構文を利用しても問題なく動作するようになりました。これにより、より詳細な引数ヒントを提供できます。

変更前

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

変更後

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

ユーザーへの恩恵

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