| name | octo-marketplace |
| version | 0.4.0 |
| description | Search, install, publish, and update Marketplace Skills, MCP server listings, and Experts/Squads (专家/专家团). Load after octo-shared. |
| metadata | {"requires":{"bins":["octo-cli"],"skills":["octo-shared"]}} |
octo-marketplace — Skills and MCP servers
All commands use $OCTO_API_BASE_URL/market/api/v1/*, authenticate with the
active bot profile, and send its Space context. Marketplace is one backend with
several catalog domains, exposed as marketplace skill, marketplace mcp, and
marketplace expert / marketplace squad.
Load only the reference matching the task:
| Task | Read |
|---|
| Search, install, publish, or update a Skill ZIP | skills.md |
| Search, install, create, probe, or update an MCP listing | mcp.md |
| Search, create, update, or publish an Expert (专家) or Squad (专家团) | expert.md |
Shared output rule
For a non-paginated command, normalize the backend payload before reading its
fields because CLI versions may either unwrap the backend envelope or retain it:
payload=$(octo-cli marketplace ... | jq -c '.data.data // .data')
Do not apply that expression to any command whose backend response is
{data:[...], pagination:{...}} — the CLI output layer flattens that shape,
exposing the result array directly as CLI .data and pagination as
._pagination. This covers the paginated skill list / mcp list search
commands and the offset-paginated expert list / squad list (and their
mine variants), regardless of whether the command supports --page-all.
Shared safety rule
- Show the target object and intended mutation before install, publish, create,
replacement, or update; continue only after explicit user confirmation.
- Never print presigned URLs, tokens, headers containing secrets, or raw secret
values.
- Do not change records outside the user-selected Skill, MCP, Expert, or Squad.
- On failure, preserve the previously installed runtime configuration.
