# Marketplace and Extension Manifests

This directory documents the Sealos skill pack distribution surfaces.

## Owned manifest files

- `.codex-plugin/plugin.json` — Codex plugin manifest; points directly to root `skills/`.
- `.agents/plugins/marketplace.json` — local Codex marketplace entry.
- `.claude-plugin/plugin.json` — Claude Code-compatible plugin manifest.
- `.qoder-plugin/plugin.json` — Qoder plugin manifest; explicitly loads every root skill exposed by Codex.
- `marketplace.json` — root marketplace bundle entry for Claude-compatible hosts.
- `.claude-plugin/marketplace.json` — Claude marketplace mirror of the root marketplace entry.
- `.codebuddy-plugin/marketplace.json` — CodeBuddy marketplace entry.
- `gemini-extension.json` — Gemini CLI extension manifest using `CLAUDE.md` as context.
- `qwen-extension.json` — Qwen Code extension manifest using `CLAUDE.md` as context.
- `openclaw.plugin.json` — OpenClaw / ClawHub-style bundle pointer.
- `package.json`, `cordis.patch.yml`, `index.js` — DeepSeek Harness profile bundle over root `skills/**`.
- `distribution/platforms.json` — platform support registry.
- `commands/sealos.md` — plugin slash-command entry for hosts that support command directories.
- `qoder.md` — Qoder plugin-level routing and safety instructions.

## Support claims

`distribution/platforms.json` is the source of truth for host support claims:

- `verified` means this repository has a current validation command or host smoke test.
- `install-target` means a manifest is present for the host, but live host execution may still be environment-dependent.
- `context-only` means the host can ingest the repository context and skills, but slash-command exposure is not claimed.

## Maintenance rules

- Keep all manifest versions in sync with `.codex-plugin/plugin.json`.
- Keep all `skills` arrays pointed at root `./skills/...` paths.
- Keep `./skills/sealos-canvas` in every explicit plugin or marketplace skill array. Directory-pointer hosts inherit Canvas from the canonical root tree.
- Treat `.codex-plugin/plugin.json` as the sole package-version source; derive comparisons and archive names from its `version` field.
- Keep `.agents/plugins/marketplace.json`, Codex directory pointers, and OpenClaw's `.claude-plugin/plugin.json` source as pointers. Do not add copied skill trees to pointer hosts.
- Keep the Qoder skill inventory aligned with every `skills/*/SKILL.md` loaded by the Codex plugin.
- Do not copy skill directories into host-specific package folders.
- Keep plugin examples as `$sealos` for Codex and `/sealos` for Claude Code-compatible hosts.
- Keep `/sealos-deploy`, `/sealos-database`, and `/sealos-s3` as the direct `skills.sh` subset. Canvas remains available through the installed plugin pack after verified deployment state.

## Plugin validation

- Run `python3 scripts/validate-codex-plugin.py` when Codex, Claude Code, or Qoder metadata or the platform registry changes.
- Run `python3 scripts/package-qoder-plugin.py` and inspect the generated ZIP before Qoder import testing.