Claude Code Skills

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

ユーザーに質問を投げるためのツールが「許可済み」リストに入っていると、プロンプトを出さずに空の回答で処理が進んでしまい、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ワークツリー環境でのカスタムエージェントとスキルの利用が改善され、開発者はワークツリー内でもプロジェクト固有の設定を正しく利用できるようになりました。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

スラッシュコマンドの補完機能は入力の開始時にしか働かず、文章の途中でスキルを引用したい場合などに不便でした。

変更後

「...をしてから /review して」のように、入力の途中で / を打つだけで適切なスキル候補がポップアップします。

ユーザーへの恩恵

会話の流れを止めることなく、必要なコマンドやスキルを素早く呼び出せるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

起動時にコマンドを直接実行しようとしても、対話モードの初期化プロセスによって無視されてしまうことがありました。

変更後

起動引数によるコマンド実行が確実に処理されるようになりました。

ユーザーへの恩恵

シェルスクリプトやエイリアスから Claude Code の特定機能を呼び出す自動化が、より確実に行えます。

変更前

コンテキスト使用量の内訳で、スキルの全内容が読み込まれているかのように誤った(過大な)トークン数が表示されることがありました。

変更後

実際にはスキルの説明文(フロントマター)だけがロードされているという事実に基づき、正確な使用量が表示されるようになりました。

ユーザーへの恩恵

現在のコンテキストの空き容量をより正確に把握でき、いつ要約(/compact)が必要かの判断を適切に行えます。