Package and distribute Codex plugins with schema-safe manifests, skills, app config, marketplace assets, and release-ready validation.
Implement Codex plugin packaging: manifest authoring, skill reuse, app integrations, marketplace assets, and distribution to the Codex plugin directory.
.codex-plugin/plugin.json with required name, version, description fields.skills/ directory from plugin root (reused across platforms)..app.json for third-party app integrations.assets/ with marketplace visuals (icon, screenshots).integration_tests/validate-codex-manifest.sh.{
"name": "my-plugin",
"version": "1.0.0",
"description": "Brief description of what this plugin does",
"author": { "name": "your-name" },
"license": "Apache-2.0",
"repository": "https://github.com/owner/repo",
"skills": "./skills/"
}
Required: name (kebab-case), version, description
Optional: author, license, repository, skills (path to skills directory)
plugins/<plugin-name>/
├── .codex-plugin/
│ └── plugin.json # Codex manifest (required)
├── skills/
│ └── <name>/SKILL.md # Shared skills (also used by Claude Code, Cursor)
├── .mcp.json # MCP server config (shared across platforms)
├── .app.json # Third-party app integrations (Codex-specific)
└── assets/
├── icon.svg # Plugin icon (64x64 recommended)
└── screenshot.png # Marketplace screenshot
Codex skills follow the same SKILL.md format as Claude Code skills. They live in the shared skills/ directory and are automatically picked up by all platforms that support them.
Frontmatter:
---