skill-compat-matrix

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill Compat Matrix

Skill兼容性矩阵

Summarize how a skill's frontmatter and bundled assets map to supported harnesses.

Scope: Compatibility reporting only. Does not install skills or edit harness configs.

总结Skill的前置信息和捆绑资源如何与受支持的harness对应。

适用范围： 仅用于兼容性报告，不负责安装Skill或编辑harness配置。

Dispatch

调度

$ARGUMENTS	Action
`<name>`	Matrix for one skill
`repo` / `--all`	Matrix summary for all repo skills
`--format json`	Machine-readable report
Empty	Show harness list and field tiers

$ARGUMENTS	操作
`<name>`	单个Skill的兼容性矩阵
`repo` / `--all`	仓库中所有Skill的兼容性矩阵汇总
`--format json`	机器可读格式的报告
无参数	显示harness列表和字段层级

Field Tiers

字段层级

Tier	Examples
portable-core	`name` , `description` , `license` , `metadata`
portable-but-variable	`allowed-tools` , scripts, references
runtime-specific	`user-invocable` , `hooks` , `context` , `paths`

Load

skills/skill-creator/references/runtime-compatibility.md

when interpreting results.

层级	示例
portable-core	`name` , `description` , `license` , `metadata`
portable-but-variable	`allowed-tools` , scripts, references
runtime-specific	`user-invocable` , `hooks` , `context` , `paths`

解读结果时，请查看

skills/skill-creator/references/runtime-compatibility.md

文档。

Workflow

工作流程

bash

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

bash

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

Validation Contract

验证契约

bash

uv run python skills/skill-compat-matrix/scripts/check.py

bash

uv run python skills/skill-compat-matrix/scripts/check.py

Critical Rules

关键规则

Mark unknown or best-effort harness behavior explicitly.
Never treat runtime-specific fields as portable safety controls.
Pair matrix output with skill-creator security audit for executable surfaces.
Do not mutate harness projections from this skill.
Include install-path notes only as documentation, not commands to run.

明确标记未知或尽力而为的harness行为。
切勿将运行时特定字段视为可移植的安全控制措施。
将矩阵输出与Skill创建者的安全审计结合，检查可执行面。
不要通过此Skill修改harness的映射。
仅将安装路径说明作为文档包含，不作为可执行命令。