Skip to main content

18 · Plugins and Immutable Distribution

The full pack distributes one source tree as harness-native plugins and as a verified AgentSkills generation installed once into the canonical root ~/.agents/skills (real directories) plus Claude Code and Qwen Code symlink shims. The generation is content-addressed; host paths never point at a mutable staging directory or a hardcoded release version.

Packaging model​

The generation includes skills, agents, hooks, shared scripts, plugin manifests, and MCP configuration. The Claude package also carries its verified installer, ESM support library, flattened distribution contract, and execution descriptor so explicit activation never depends on repository-only files. Hooks do not install or upgrade the package automatically. The manifest records every file hash and mode plus the expected target projection. Installation verifies the complete generation before activation.

Claude Code and OpenCode​

Only marketplace manifests live at the repository root. Self-contained native packages are generated at dist/plugins/claude/prometheus-skill-pack and dist/plugins/codex/prometheus-skill-pack; every skill is materialized as skills/<skill-name>/ with its scripts, references, templates, assets, and file modes intact. Claude auto-discovers its supported hook file. Codex uses its generated native manifest and hook adapter contracts; inspect the packaged entrypoint and installed harness capability rather than assuming that a manifest alone activates hooks.

The root skill-system.json is the machine-readable authority for release and minimum-active versions, imports and SHAs, inventory exclusions, profiles, targets, projection modes, platform boundaries, marketplaces, and generated outputs. artifact-refiner and sycophancy-correction are adjacent pinned entries, not automatic umbrella dependencies.

Activation​

./install.sh --profile skills --targets detected
./install.sh --verify --targets detected --non-interactive

The installer stages privately, validates all payloads and target receipts, updates previous, then atomically switches current. Hook registrations point at stable dispatchers, so activation requires no hook rewrite.

Rollback and uninstall​

node scripts/install-plugin-generation.js --rollback
node scripts/install-plugin-generation.js --verify
./install.sh --uninstall --targets detected

Rollback selects the previous complete generation and restores copy targets. Uninstall removes only Prometheus-owned projections carrying valid ownership evidence; unrelated collisions are preserved and reported.

See the canonical Plugin Distribution section for the manifest design, full target matrix, stable dispatcher contract, collision behavior, rollback, and stale-cache removal.


Previous: ← 17 · Platform Support · Next: 19 · Installation →