Skill Compat Matrix
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.
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 |
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.
Workflow
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
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.