skill-compat-matrix について
skill-compat-matrix は、スキルのメタデータや同梱アセットが対応ハーネスにどう対応するかを報告するリポジトリ用スキルです。スキル単位またはリポジトリ全体のレポートを JSON 形式でも生成し、インストールや設定変更は行いません。
主な機能
- 01スキル単位の互換性マトリクス
- 02リポジトリ全体の互換性概要
- 03機械可読な JSON 出力
- 04移植可能なフィールドと実行環境固有フィールドの分類
- 05設定を変更しない互換性レポート
活用シーン
- 01スキルを文書化する前にハーネス互換性を確認
- 02リポジトリ内のスキル間でフィールドの移植性を確認
- 03JSON 形式の互換性レポートを生成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/skill-compat-matrixを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/evals.jsonscripts/check.pycompat_matrix.pyscripts/asset_toolkit/validate_hooks.py詳細
スキル互換性マトリックス
スキルのフロントマターと同梱アセットが、サポート対象のハーネスにどのように対応するかをまとめます。
対象範囲： 互換性の報告のみです。スキルのインストールやハーネス設定の編集は行いません。
ディスパッチ
| $ARGUMENTS | アクション |
|---|---|
<name> | 1 つのスキルのマトリックス |
repo / --all | リポジトリ内のすべてのスキルのマトリックス概要 |
--format json | 機械可読なレポート |
| 空 | ハーネスの一覧とフィールドのティアを表示 |
フィールドのティア
| ティア | 例 |
|---|---|
| portable-core | name、description、license、metadata |
| portable-but-variable | allowed-tools、スクリプト、リファレンス |
| runtime-specific | user-invocable、hooks、context、paths |
結果を解釈する際は、skills/skill-creator/references/runtime-compatibility.md を読み込んでください。
ワークフロー
uv run python skills/skill-compat-matrix/scripts/compat_matrix.py <name>
uv run python skills/skill-compat-matrix/scripts/compat_matrix.py --all --format json
検証契約
uv run python skills/skill-compat-matrix/scripts/check.py
重要なルール
- 不明またはベストエフォートのハーネスの動作は、明示的に示してください。
- ランタイム固有のフィールドを、移植可能な安全制御として扱わないでください。
- 実行可能なサーフェスについては、マトリックスの出力に skill-creator のセキュリティ監査を組み合わせてください。
- このスキルからハーネスのプロジェクションを変更しないでください。
- インストール先のパスに関する注記は、実行するコマンドではなく、ドキュメントとしてのみ記載してください。
コメント
Markdown 対応