# Distribution matrix (reference)

Extended channel list for skills + plugins. Verify against upstream docs when shipping.

## Skills (`npx skills`)

| Channel | Public | Private | MCP | Hooks |
|---------|--------|---------|-----|-------|
| `npx skills add owner/repo` | Yes | Yes (if git access) | No | No |
| skills.sh index | Yes (public repos) | No | No | No |
| Project scope | `.agents/skills/` + agent symlinks | Same | No | No |
| Global `-g` | `~/.agents/skills/` | Same | No | No |
| Zed native | `.agents/skills/` project | `~/.agents/skills/` global | No | No |

## Plugins by agent

| Channel | Manifest | Marketplace install | Private team |
|---------|----------|---------------------|--------------|
| Cursor public | `.cursor-plugin/plugin.json` | cursor.com/marketplace publish | N/A |
| Cursor team | `.cursor-plugin/marketplace.json` | Dashboard import GitHub repo | Teams / Enterprise |
| Claude Code | `.claude-plugin/*` | `/plugin marketplace add` | Private git + tokens |
| Codex | `.codex-plugin/plugin.json` | `.agents/plugins/marketplace.json` + `codex plugin add` | Repo or personal marketplace |
| Open Plugin v1 | `.plugin/plugin.json` | Host-specific | Vendor-neutral baseline |
| Cline / Kiro hooks | varies | skills CLI + native hooks | varies |

## Product example (generic product MCP)

| Step | Command |
|------|---------|
| Skills only | `npx skills add <owner>/<repo>` |
| Full harness | `[toolkit-cli] init cursor` |
| Claude marketplace | `/plugin marketplace add <owner>/<repo>` |
| Codex marketplace | `codex plugin marketplace add <owner>/<repo>` |

## When to use which

```text
Only instructions, many agents     → skills repo + npx skills
Hooks / MCP / commands bundle      → plugin manifest per agent
Multiple plugins one repo          → marketplace.json
Cursor org-internal only           → team marketplace (private Git)
Claude team private git            → .claude-plugin/marketplace.json + tokens
Codex local development            → .agents/plugins/marketplace.json + reinstall/cache refresh
Zed reusable workflow              → .agents/skills/ direct child skill folder
```
