Rename marketplace to webhook-skills, narrow per-skill sources, add bundle entry

[leggetter]

Summary

Three metadata-only changes to .claude-plugin/marketplace.json plus a README update:

1. Rename marketplace name: hookdeck-webhook-skills → webhook-skills. The catalog covers 33 third-party providers (Stripe, Shopify, GitHub, etc.) plus Hookdeck's own infrastructure plugins. Hookdeck branding in the install-command surface (<skill>@hookdeck-webhook-skills) implied a Hookdeck-specific catalog, which doesn't match the content. Users now install via <skill>@webhook-skills.

2. Per-skill subdirectory source for the 37 granular entries:

   • Before: source: "./" + skills: ["./skills/<name>"]
   • After: source: "./skills/<name>" + skills: ["./"]

   With the previous shape, each install pulled the entire repo into ~/.claude/plugins/cache/ and then activated one folder. After this change, each install pulls only skills/<name>/. Real install sizes (via git clone, respecting .gitignore): bundle ~3.1 MB, per-skill ~200 KB.

3. Add a webhook-skills bundle plugin entry (38th plugin) that exposes all 37 skills from a single plugin. Anthropic's plugin directory submission form is per-plugin; one bundle plugin lets a single directory submission cover the whole repo without requiring 37 separate submissions. The granular entries are unchanged.

4. README: add an Install with /plugin (Claude Code) subsection alongside the existing npx skills add instructions, documenting both the granular and bundle install paths and the skill-namespacing users will see in each case.

After this PR there are two /plugin install paths:

• Granular (per provider): /plugin install stripe-webhooks@webhook-skills — installs just that skill (~200 KB).
• Bundle (everything): /plugin install webhook-skills@webhook-skills — installs all 37 skills (~3 MB).

The webhook-skills@webhook-skills install command mirrors anthropics/skills' claude-api@claude-api pattern where a "default" plugin shares its marketplace's name.

Doc evidence for the syntax

From https://code.claude.com/docs/en/plugin-marketplaces.md:

Relative path | string (e.g. "./my-plugin") | Local directory within the marketplace repo. Must start with ./. Resolved relative to the marketplace root, not the .claude-plugin/ directory

skills | string|array | Custom paths to skill directories containing <name>/SKILL.md (marketplace-entry override; takes effect with strict: false)

strict: false: The marketplace entry is the entire definition. … the plugin doesn't need its own plugin.json. The marketplace entry defines everything.

Per-skill narrowing uses the relative-path source pattern with skills: ["./"] to expose the plugin root as the skill folder. The bundle keeps source: "./" because it legitimately needs to reach all 37 skill paths.

Cross-skill references audit

Pre-flight grep:

• Every provider SKILL.md recommends webhook-handler-patterns, but every link is an absolute https://github.com/hookdeck/webhook-skills/... URL. No relative file paths between skills.
• Same in reverse from webhook-handler-patterns/SKILL.md out to providers.
• Only intra-skill relative refs found (skills/clerk-webhooks/references/patterns.md → ../SKILL.md) — inside the same skill, unaffected.

Per-subdir migration is safe with no SKILL.md content changes.

Empirical install verification

/plugin marketplace add ./ + /plugin install stripe-webhooks@webhook-skills succeeded against this branch:

$ ls ~/.claude/plugins/cache/webhook-skills/stripe-webhooks/68d9280cf39b/
SKILL.md
examples/
references/

Only the stripe-webhooks folder — no AGENTS.md, no scripts/, no other 36 skills. And the skill surfaces in Claude as the plugin-namespaced stripe-webhooks:stripe-webhooks (the doc-correct form for plugin skills).

The bundle install path (webhook-skills@webhook-skills) hasn't been empirically tested yet — added in the second commit on this branch.

Bundle test plan (still to run)

• /plugin marketplace remove webhook-skills && /plugin marketplace add ./ (refresh to pick up the bundle entry)
• /plugin install webhook-skills@webhook-skills
• Confirm all 37 SKILL descriptions surface under the webhook-skills: namespace in the available_skills list.

Commits on this branch

1. 68d9280 Switch marketplace to per-skill subdir sources, rename to webhook-skills
2. 89a0d09 Add webhook-skills bundle plugin entry
3. 5300e32 README: document /plugin install path for Claude Code

🤖 Generated with Claude Code