菜单
Link an existing plugin to an existing marketplace (local or GitHub source). Use when appending an existing plugin to a marketplace.json. Used dynamically via the-skills-menu (TRDD-478d9687).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Add a new component (skill / agent / command / hook / mcp) to an existing plugin. Use when scaffolding a single component into a plugin without re-running the generator. Used dynamically via the-skills-menu (TRDD-478d9687).
Add plugin dependencies to a target plugin (explicit --add specs or --from copy from another plugin's plugin.json). Use when adding/copying plugin.json::dependencies entries with atomic rollback on regression. Used dynamically via the-skills-menu (TRDD-478d9687).
Add a new hook entry to hooks/hooks.json in an existing plugin (idempotent — skips duplicate entries; cross-platform-aware). Use when adding a new event-handler that must run identically on Linux/macOS/Windows. Used dynamically via the-skills-menu (TRDD-478d9687).
Bump plugin version and run the full publish pipeline (plugin.json, pyproject.toml, README badge, CHANGELOG, push, release). Use when bumping version + publishing the current plugin via publish.py. Used dynamically via the-skills-menu (TRDD-478d9687).
Routes the /cpv-main-menu Stop-hook menu via scripts/print_menu.py + claude-menu-system. Used dynamically via the-skills-menu (TRDD-478d9687) — used by the /cpv-main-menu flow. Use when navigating CPV's many commands via a single entry point.
Deterministic codemod CLI — bulk-fix backtick-path to markdown-link, add TOC stubs, dedup blank lines, and other mechanical text transforms (issue 17). Zero LLM cost. Use when mechanical fixes outnumber semantic ones. Used dynamically via the-skills-menu (TRDD-478d9687).
| name | link-plugin-marketplace |
| description | Link an existing plugin to an existing marketplace (local or GitHub source). Use when appending an existing plugin to a marketplace.json. Used dynamically via the-skills-menu (TRDD-478d9687). |
| when_to_use | When the cpv-main-menu user picks GitHub setup → Link plugin to marketplace, or any flow needs to append an existing plugin to a marketplace.json |
| user-invocable | false |
Appends an existing plugin to an existing marketplace's marketplace.json, preserving entries for other plugins. If a plugin with the same name is already listed, its entry is replaced in place with fresh metadata (so re-runs stay idempotent — one entry per name, never duplicated). Uses the correct source.source schema key (not the legacy source.type). Loaded dynamically via the-skills-menu, reached via the GitHub setup → Link plugin menu branch.
uv on PATH.claude-plugin/marketplace.json (or marketplace.json at root)owner/repo (emits {source: "github", repo: "owner/repo"})marketplace.json exists at the canonical location.owner/repo GitHub slug.manage_plugin.py --link-plugin <marketplace-path> <plugin-spec>.name is replaced in place with fresh metadata.plugin-validation-skill (or validate_marketplace.py --strict).Copy this checklist and track your progress:
owner/repo)manage_plugin.py --link-plugin executedmarketplace.json updatedvalidate_marketplace.py --strict re-run, exit 0marketplace.json::plugins[].source: "relative-path" with relative path stored.source: "github" with repo: "owner/repo".| Error | Resolution |
|---|---|
| Marketplace not found | Verify path; check for .claude-plugin/marketplace.json |
| Plugin already linked | Re-runs are idempotent — the same-name entry is replaced in place (refreshing version/description), never duplicated |
| Local plugin not found | Verify path; .claude-plugin/plugin.json must exist |
| GitHub repo invalid | Verify owner/repo slug exists on GitHub |
| Validator regression after link | Check upstream cross-validation (RC-MKPL-*) findings |
Link a local plugin into a local marketplace:
uv run python "${CLAUDE_PLUGIN_ROOT}/scripts/manage_plugin.py" \
--link-plugin ~/marketplaces/my-hub ~/src/my-plugin
Link a GitHub plugin into a local marketplace:
uv run python "${CLAUDE_PLUGIN_ROOT}/scripts/manage_plugin.py" \
--link-plugin ~/marketplaces/my-hub Emasoft/claude-plugins-validation
create-plugin skill — create a new marketplace from scratchplugin-management skill — full plugin lifecycle managementplugin-validation-skill — validate a GitHub marketplace after linkingmarketplace-authoring-contract skill — entry shape rules (name, version, source)