fnl-plugin-packaging
Installation
SKILL.md
Plugin packaging
One repository, one skills/ folder, one manifest per host. This skill holds the decisions that stay stable across hosts. Field-level schemas change often, so read them from each host's own tools and docs at the time you package (the authority column below) instead of copying them into the repository.
| Host | Manifest | Catalog | Authority for fields and checks |
|---|---|---|---|
| Claude Code | .claude-plugin/plugin.json |
.claude-plugin/marketplace.json |
plugin manifest reference, marketplace reference, claude plugin validate . --profile directory; the plugin-dev and skill-creator skills for authoring |
| Codex | .codex-plugin/plugin.json |
.agents/plugins/marketplace.json |
build plugins, submission fields; no local validator, the portal validates the upload |
| Antigravity | .antigravity-plugin/plugin.json |
none; install from the repository URL | build plugins, agy plugin validate . --strict; the built-in plugin and agy-customizations skills |
1. Layout
- Skills live in
skills/<name>/SKILL.md; the folder name equals thenamefield. A shared name prefix keeps a pack's skills together and avoids collisions with other packs. - Each host's manifest sits in its own folder. A root
plugin.jsonis read by both Codex (its preferred location) and Antigravity (its native manifest, with a closed schema), so one file cannot satisfy both. - Keep every skill folder self-contained: single-skill installers (skills.sh) copy one folder and nothing around it. Disclose reference material into
references/and executables intoscripts/beside the skill that uses them; a file two skills need gets a copy in each, with a CI check that the copies match. A skill that cannot work without another names it as a dependency and says how to install it. Keep machine-specific facts in user configuration, never in the package. - Ship only what the host loads: no build output, caches, OS files, local notes or eval results.
Done when every host's validator finds the expected number of skills.