| name | list-components |
| description | Lists the plugins, skills, commands, agents, hooks, and MCP servers in a marketplace. Read-only — makes no changes. Use when inspecting what a marketplace contains, or checking existing components before adding or removing one. |
list-components
Lists every component in a marketplace. Read-only inventory.
Procedure
-
Ask the user for the marketplace name (or use the active one). Confirm the
directory exists: zcode_tools/marketplaces/<name>/.
-
Read marketplace.json and list registered plugins:
python3 -c "import json; d=json.load(open('zcode_tools/marketplaces/<name>/marketplace.json')); [print(f' plugin: {p[\"name\"]} v{p[\"version\"]} — {p[\"description\"]}') for p in d.get('plugins',[])]"
-
Scan the directory tree and report counts:
- Plugins:
zcode_tools/marketplaces/<name>/plugins/*/ (each with
.zcode-plugin/plugin.json).
- Skills (plugin-scoped):
plugins/*/skills/*/SKILL.md.
- Skills (user-scoped):
skills/*/SKILL.md.
- Commands:
plugins/*/commands/*.md and commands/*.md.
- Agents:
plugins/*/agents/*.md and agents/*.md.
- References:
plugins/*/references/*.md.
- CLI tools:
plugins/*/tools/*/.
- Hooks: read
hooks.json and list non-empty event arrays.
- MCP servers: read
mcp.json and list entries under mcpServers.
- Providers: read
v2-config.template.json and list entries under
provider (with enabled status).
-
Print a summary table:
Marketplace: <name>
Plugins: N (names)
Skills: N (plugin-scoped: X, user-scoped: Y)
Commands: N
Agents: N
References: N
CLI tools: N
Hooks: N active (events: ...)
MCP servers: N
Providers: N (enabled: X, disabled: Y)
-
If a component type has zero entries, report "(none)" — do not omit it.
Rules
- Read-only: do not create, edit, or delete any file.
- Report exact paths so the user can act on them.
- For hooks and MCP servers, only list non-empty entries (skip the empty
skeleton arrays present in every marketplace template).
