Skip to content

Add plugin marketplace structure#23

Merged
leggetter merged 2 commits into
mainfrom
add-plugin-marketplace-structure
May 11, 2026
Merged

Add plugin marketplace structure#23
leggetter merged 2 commits into
mainfrom
add-plugin-marketplace-structure

Conversation

@leggetter
Copy link
Copy Markdown
Collaborator

@leggetter leggetter commented May 11, 2026

Summary

Adds .claude-plugin/ metadata so this repo is a valid Claude Code plugin marketplace and can be submitted to the community marketplace (Claude.ai submission form). The three existing skills are bundled as a single plugin. No SKILL.md content, scripts, or tooling are modified, this is purely additive metadata.

What was added

  • .claude-plugin/marketplace.json — marketplace catalog with one plugin entry, source: "./" (the marketplace root itself).
  • .claude-plugin/plugin.json — plugin manifest, version 0.1.0.

Existing skill layout (skills/<name>/SKILL.md at the repo root) already matches the plugin spec, so nothing had to move.

Why

Adding the marketplace manifest lets users discover and install these skills through Claude Code's /plugin marketplace add flow and the various community plugin indexers. It's also the prerequisite for submitting to the official Anthropic marketplace.

Naming

Per Anthropic's marketplace docs, the bare name agent-skills is reserved and rejected by the Claude.ai marketplace sync, alongside claude-code-marketplace, claude-code-plugins, claude-plugins-official, anthropic-marketplace, anthropic-plugins, knowledge-work-plugins, and life-sciences. The GitHub repo name (hookdeck/agent-skills) is unaffected, only the values inside the JSON manifests had to be changed.

Chosen names:

  • Marketplace name: hookdeck-agent-skills
  • Plugin name: hookdeck

Inside Claude Code the skills are namespaced as:

  • hookdeck:hookdeck (the router skill)
  • hookdeck:event-gateway
  • hookdeck:outpost

Plugin name convention

The plugin name follows the convention used by other single-plugin vendors in the official Anthropic marketplace: plain brand name, no -skills or -plugin suffix. Examples from the official marketplace catalog:

Vendor Plugin name Source repo
Vercel vercel vercel/vercel-plugin
Supabase supabase supabase-community/supabase-plugin
Cloudflare cloudflare cloudflare/skills
Sentry sentry getsentry/sentry-for-claude
Stripe, Firebase, Linear, Prisma, MongoDB, PlanetScale, Railway plain brand various

The slightly tautological hookdeck:hookdeck namespace for the router skill mirrors the established supabase:supabase pattern in supabase/agent-skills, so this is a recognised shape in the ecosystem.

If we ever ship a second plugin from this repo we can switch to prefixed names (the AWS pattern: aws-amplify, aws-core, aws-data-analytics).

Validation

Validated locally with the bundled CLI:

$ claude plugin validate .
Validating marketplace manifest: .../.claude-plugin/marketplace.json
✔ Validation passed

Also smoke-tested loading the plugin with claude --plugin-dir . and confirmed all three skills resolve as hookdeck:hookdeck, hookdeck:event-gateway, and hookdeck:outpost.

Test plan

  • claude plugin validate . passes
  • claude --plugin-dir . loads the plugin and lists all three skills with the hookdeck: prefix
  • After merge, add the marketplace from the GitHub source and install: /plugin marketplace add hookdeck/agent-skills then /plugin install hookdeck@hookdeck-agent-skills
  • Submit to the official marketplace via https://claude.ai/settings/plugins/submit

🤖 Generated with Claude Code

leggetter and others added 2 commits May 12, 2026 00:31
Bundles the three existing skills (hookdeck, event-gateway, outpost) as
a single Claude Code plugin so this repo is a valid plugin marketplace
and can be submitted to the community marketplace.

- .claude-plugin/marketplace.json (one plugin entry, source "./")
- .claude-plugin/plugin.json (plugin manifest, version 0.1.0)

Marketplace name: hookdeck-agent-skills (the bare "agent-skills" name
is reserved by Anthropic and rejected by the Claude.ai marketplace
sync).

Plugin name: hookdeck-skills. Skills namespace as
hookdeck-skills:hookdeck, hookdeck-skills:event-gateway, and
hookdeck-skills:outpost inside Claude Code.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Matches the convention used by other single-plugin vendors in the
official Anthropic marketplace (vercel, supabase, cloudflare, sentry,
stripe, firebase, linear, prisma). Plain brand name, no -skills or
-plugin suffix in the plugin manifest.

Skills now namespace as hookdeck:hookdeck (router), hookdeck:event-gateway,
and hookdeck:outpost. The router's hookdeck:hookdeck mirrors the
established supabase:supabase pattern in supabase/agent-skills.

Marketplace name stays hookdeck-agent-skills (the bare agent-skills is
reserved by Anthropic).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@leggetter leggetter merged commit efe0b2d into main May 11, 2026
8 checks passed
@leggetter leggetter deleted the add-plugin-marketplace-structure branch May 11, 2026 23:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant