claude-code-plugin-template

Claude Code Plugin Marketplace Template provides a ready-to-use GitHub repository structure for creating and distributing Claude Code plugins to your team or community. It includes a plugin development toolkit with scaffolding commands, slash commands for initialization and validation, example plugins, and automated GitHub Actions workflows that validate plugin structure on every push and PR. The template handles marketplace configuration, plugin manifests following official schema, documentation guides for commands, skills, hooks, and sub-agents, plus local testing capabilities. Teams can quickly set up their own marketplace, scaffold new plugins, add components like commands and skills, validate before release, and configure automatic marketplace installation across projects.

[{"step":"Install the template repository","action":"Run `gh repo clone claude-ai/plugin-template claude-code-plugin-[PLUGIN_NAME]` or use the GitHub template feature to create a new repo from the template.","tip":"Ensure you have GitHub CLI (`gh`) installed for easy cloning."},{"step":"Initialize the plugin","action":"Navigate to the cloned repo and run `npm install`. Then execute `npm run init-plugin -- --name [PLUGIN_NAME] --language [LANGUAGE]` to scaffold the plugin structure.","tip":"Use `--language` to specify TypeScript, Python, or JavaScript. Omit to default to TypeScript."},{"step":"Configure hooks and skills","action":"Edit the generated files in `src/skills/` and `src/agents/` to define your plugin's capabilities. Update `.claude/config.json` with your plugin metadata (e.g., `description`, `version`).","tip":"Use the provided `hooks/` directory to add pre/post-commit or pre/post-merge logic. Example: `hooks/pre-commit.sh` for linting."},{"step":"Set up CI/CD","action":"Modify `.github/workflows/ci.yml` and `release.yml` to match your deployment targets (e.g., GitHub Marketplace, npm, or private registry). Add secrets in GitHub Settings > Secrets.","tip":"For GitHub Marketplace, ensure your `package.json` includes `publishConfig` pointing to the correct registry."},{"step":"Validate and deploy","action":"Run `npm run validate-plugin` to check hooks and structure. Push changes to a branch to trigger CI validation, then create a release tag (e.g., `v1.0.0`) to deploy.","tip":"Use `claude run --plugin ./src/plugins` locally to test the plugin before deployment."}]