fix(plugin): remove the duplicate hooks key from the installed manifest

[kherembourg]

Symptom

A fresh claude plugin install purchasely@Purchasely-AI-Plugin loads the skills, the commands and the agent, but claude plugin list reports the plugin as broken:

❯ purchasely@Purchasely-AI-Plugin
    Version: 2.0.0-rc.5
    Scope: user
    Status: ✘ failed to load
    Error: Hook load failed: Duplicate hooks file detected: ./hooks/hooks.json
    resolves to already-loaded file
    /Users/…/.claude/plugins/cache/Purchasely-AI-Plugin/purchasely/2.0.0/hooks/hooks.json.
    The standard hooks/hooks.json is loaded automatically, so manifest.hooks
    should only reference additional hook files.

The consequence is the SessionStart hook: hooks/intro.md never reaches the session, so the routing text that tells the agent which skill to load is missing.

Cause

Claude Code loads hooks/hooks.json by convention. A manifest that declares it again is a duplicate.

2.0.0-rc.6 already fixed this, but in the wrong file. It removed the key from the root .claude-plugin/plugin.json, while .claude-plugin/marketplace.json installs "source": "./purchasely". The manifest the harness actually reads is purchasely/.claude-plugin/plugin.json, and that one kept "hooks": "./hooks/hooks.json" through 2.0.0, 2.0.1 and 2.1.0.

Checked the other manifests: purchasely/.cursor-plugin/plugin.json, purchasely/.codex-plugin/plugin.json, .claude-plugin/plugin.json and .cursor-plugin/plugin.json declare no hooks key. One line changes.

Verification

Installed the fixed copy from a local marketplace, uninstalled afterwards:

$ claude plugin list
❯ purchasely@Purchasely-AI-Plugin
    Version: 2.1.0
    Status: ✔ enabled

$ claude plugin details purchasely@Purchasely-AI-Plugin
  Skills (9)  …
  Hooks (1)  SessionStart  (harness-only — no model context cost)

Status goes from ✘ failed to load to ✔ enabled, and the hook is inventoried.

A 2.1.1 release follows this merge.

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

Removes the redundant hook declaration from the nested Claude plugin manifest so marketplace installations rely on Claude Code’s conventional hooks/hooks.json discovery and no longer fail duplicate-hook validation.

• Updates the changelog with the failure mechanism, affected installation path, and corrected behavior.
• Leaves the packaged SessionStart hook assets in place for automatic discovery.

Confidence Score: 5/5

The PR appears safe to merge because it removes the duplicate registration while preserving the conventionally loaded SessionStart hook.

The marketplace installs the nested package, its hook assets remain present, and the removed manifest entry was the duplicate reference preventing Claude Code from loading the plugin successfully.

Important Files Changed

Filename	Overview
purchasely/.claude-plugin/plugin.json	Removes the duplicate explicit hook path while retaining the conventionally discovered hook file in the installed package.
CHANGELOG.md	Accurately documents the duplicate-hook failure, marketplace source mapping, and scope of the fix.

_{Reviews (1): Last reviewed commit: "fix(plugin): remove the duplicate hooks ..." | Re-trigger Greptile}