# Skill Compat Matrix

> Report portable vs runtime-specific skill fields across supported harnesses. Use when auditing cross-agent compatibility. NOT for live installs or packaging.

- Skill: `wyattowalsh/skill-compat-matrix` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add wyattowalsh/skill-compat-matrix`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wyattowalsh/skill-compat-matrix/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: wyattowalsh (https://skillmd.com/u/wyattowalsh)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wyattowalsh/skill-compat-matrix

---


# 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

```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
```

## 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.