package-plugin
Installation
SKILL.md
Package a plugin payload
The archive is host-specific, not portable
There is one archive per host, built from one plugins/<host>/<plugin>/
payload. Never treat a built archive as a generic "OpenDesign plugin zip" and
never hand a Codex archive to another host. The payload's own contents are
host conventions:
| Payload member | Why it is host-specific |
|---|---|
.codex-plugin/plugin.json |
The manifest directory name is Codex's convention. Another host reads a different directory. |
open-design.package.json |
Declares schemaVersion: "open-design-codex-cloud-package/v3" and minimumCodexCliVersion. |
skills/<skill>/agents/openai.yaml |
Per-skill interface metadata keyed by host. A different host reads a different filename in agents/. |
The repository layout encodes the same rule: plugins/<host>/<plugin-name>/,
described under "Host directory convention" in AGENTS.md. Codex is the only
validated host in this revision.