fix: make the Claude Code plugin installable and loadable

[Wladefant]

Problem

/plugin marketplace add https://github.com/renezander030/capcut-cli fails today, and even after a manual install the plugin won't load. Two root causes:

1. Marketplace manifest is in the wrong place and missing required fields.
Claude Code resolves the marketplace catalog at .claude-plugin/marketplace.json (not the repo root) and requires top-level name and owner. The repo shipped marketplace.json at the root with neither field, so adding the marketplace fails:

Error: Marketplace file not found at ...\.claude-plugin\marketplace.json

2. hooks/hooks.json is invalid, which blocks the whole plugin from loading.
Claude Code auto-discovers hooks/hooks.json by convention, validates it, and rejects the plugin:

Status: ✘ failed to load
Error: Hook load failed: expected record, received array (path: hooks)

The hook was broken three ways: (a) hooks was an array but must be a record keyed by event; (b) it used a non-existent on_plugin_enable event; (c) the command npm list -g capcut-cli >/dev/null 2>&1 || ... uses bash redirects that fail on Windows.

Changes

• Add .claude-plugin/marketplace.json with the required name + owner. The plugin lives at the repo root, so the plugin entry uses "source": "./". Remove the misplaced root marketplace.json.
• Fix hooks/hooks.json (kept, not removed — the "ensure capcut-cli is installed" intent is preserved):
  • hooks is now a record keyed by event;
  • event changed on_plugin_enable → SessionStart;
  • command is now a shell-agnostic node -e one-liner (Node ≥18 is already required) that checks with npm ls -g and installs only when missing — works on Windows, macOS and Linux.
• Remove the hooks field from plugin.json. Claude Code auto-loads hooks/hooks.json, so an explicit reference double-loads it and errors with Duplicate hooks file detected.

Verification

claude plugin validate <repo>                 # ✔ Validation passed
claude plugin marketplace add <repo>
claude plugin install capcut-cli@capcut-cli
claude plugin list
#   ❯ capcut-cli@capcut-cli   Status: ✔ enabled
claude plugin details capcut-cli
#   Skills (1)  capcut-edit
#   Hooks (1)   SessionStart  (harness-only — no model context cost)

Minor doc note (not in this PR)

The README's "Claude Code plugin" section says /plugin enable capcut-cli; after this fix the correct second step is /plugin install capcut-cli@capcut-cli (install auto-enables). Happy to add that one-line README tweak if you'd like it here.

[renezander030]

Hi @Wladefant,

Thank you so much for this — merged! 🙏 You fixed something I'd actually advertised in the README but was quietly broken: the /plugin marketplace add flow. Spot-on diagnosis on both counts — the manifest needing to live at .claude-plugin/marketplace.json with name/owner, and the old on_plugin_enable hook shape being invalid and silently blocking the whole plugin from loading. The portable node -e install check on SessionStart is a nice touch too.

First outside contribution to capcut-cli, and a genuinely useful one. Really appreciate you taking the time to track it down and write it up so clearly. If you end up using the CLI for anything, I'd love to hear how it goes — and PRs are always welcome.

Cheers,
Rene