mcpField
S
skill-compat-matrix

skill-compat-matrix

github.com/wyattowalshAgent workflows535 installsUpdated 8w ago
Repository

About skill-compat-matrix

skill-compat-matrix is a repository skill that reports how skill metadata and bundled assets map to supported harnesses. It offers per-skill or repository-wide reports, including machine-readable JSON, without installing skills or changing harness configuration.

Key features

  1. 01Per-skill compatibility matrix
  2. 02Repository-wide compatibility summary
  3. 03Machine-readable JSON output
  4. 04Classification of portable and runtime-specific fields
  5. 05Compatibility reporting without configuration changes

Use cases

  1. 01Check harness compatibility before documenting a skill
  2. 02Review field portability across repository skills
  3. 03Generate a JSON compatibility report

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wyattowalsh/agents --skill skill-compat-matrix

After installing, type/skill-compat-matrixin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

evals/
evals.json
scripts/
check.py
compat_matrix.py
scripts/asset_toolkit/
validate_hooks.py

Details

From the project README

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

$ARGUMENTSAction
<name>Matrix for one skill
repo / --allMatrix summary for all repo skills
--format jsonMachine-readable report
EmptyShow harness list and field tiers

Field Tiers

TierExamples
portable-corename, description, license, metadata
portable-but-variableallowed-tools, scripts, references
runtime-specificuser-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

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

Comments

Markdown supported