A minimal Claude Code plugin example, distributed directly from GitHub — no npm publish, no registry auth.
├── .claude-plugin/
│ └── plugin.json # Plugin manifest (name, version, description)
├── skills/
│ └── hello-world/
│ └── SKILL.md # Skill definition (frontmatter + instructions)
├── marketplace.json # Marketplace registry — points to this GitHub repo
└── package.json # npm package metadata (no publishConfig needed)
- Plugin manifest —
.claude-plugin/plugin.jsonidentifies the plugin to Claude Code. - Skill discovery — Claude Code auto-discovers any
skills/*/SKILL.mdin the installed package. - Distribution —
marketplace.jsonuses"package": "github:moshfeu/claude-plugin-hello", which tells npm to install directly from this repo. No registry, no publish step needed.
# Add this marketplace (raw GitHub URL of marketplace.json)
claude marketplace add https://raw.githubusercontent.com/moshfeu/claude-plugin-hello/main/marketplace.json
# Install the plugin
claude marketplace install claude-plugin-helloNo tokens or authentication required — public GitHub repo = anyone can install.
Just push to GitHub. To pin to a specific commit or tag:
"package": "github:moshfeu/claude-plugin-hello#v1.1.0"After installing, type /hello <your name> in Claude Code.