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 the name field. 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.json is 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 into scripts/ 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.

Installs
2
GitHub Stars
4
First Seen
Nov 3, 2026