claude-code-plugin-template

🥈Silver

GitHub template for creating Claude Code plugin marketplaces. Includes plugin scaffolding, validation commands, hooks, skills, agents, and CI/CD workflows. Ready-to-use toolkit for teams distributing Claude Code plugins.

47170Updated 1mo ago

Intermediate30min to implementautomation

Saves ~45 min per use

Quick InstallView Source

git clone https://github.com/ivan-magda/claude-code-plugin-template.git

Works with:

Claude

Overview

About This Skill

How to Use

[{"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."}]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/ivan-magda/claude-code-plugin-template

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use the claude-code-plugin-template to scaffold a new plugin for [PLUGIN_NAME] in the [DOMAIN] category. Initialize the plugin with [LANGUAGE] and include [SPECIFIC_FEATURES] like [EXAMPLE_FEATURE]. Set up the CI/CD pipeline to run tests on [BRANCH_NAME] and deploy to [PLUGIN_MARKETPLACE]. Validate the plugin structure using the provided [VALIDATION_COMMAND] and ensure all hooks are configured for [HOOK_PURPOSE].

Example Output

```
# Plugin Scaffolding Complete: `claude-code-plugin-ai-reviewer`

## Structure Generated
```
claude-code-plugin-ai-reviewer/
├── .github/workflows/
│   ├── ci.yml          # Runs on PRs to `main`
│   └── release.yml     # Deploys to Marketplace on tag v*
├── src/
│   ├── skills/
│   │   └── ai-reviewer.skill.ts  # Skill: Code review agent
│   ├── agents/
│   │   └── reviewer.agent.ts     # Agent: PR reviewer logic
│   └── plugins/
│       └── index.ts              # Plugin entry point
├── tests/
│   ├── skills/
│   │   └── ai-reviewer.test.ts   # Unit tests
│   └── e2e/
│       └── reviewer.test.ts      # E2E tests
├── .claude/               # Plugin metadata
│   └── config.json
└── package.json           # Dependencies & scripts

## Validation & CI
- ✅ Ran `npm run validate-plugin` - All hooks passed
- ✅ CI pipeline triggered on PR to `main` (Node v20, Ubuntu)
- 🚀 Ready for deployment to `claude-code-plugin-marketplace`

## Key Features Configured
1. **Skill**: `ai-reviewer.skill.ts`
   - Input: `[PR_DIFF, CONFIG_FILE]`
   - Output: `review_comments.json` with line-specific suggestions
   - Hooks: `pre-commit`, `post-merge`

2. **Agent**: `reviewer.agent.ts`
   - Uses `claude-code` LLM for contextual reviews
   - Integrates with GitHub API for PR data

3. **CI/CD**: `release.yml`
   - Auto-deploys on `v1.0.0` tag
   - Runs `npm run test:e2e` before publish
```

**Next Steps:**
1. Update `config.json` with your API keys (e.g., `GITHUB_TOKEN`).
2. Add custom rules in `src/skills/ai-reviewer.skill.ts` (e.g., security checks).
3. Test locally with `claude run --plugin ./src/plugins`.
4. Push to GitHub and open a PR to trigger CI validation.

**Troubleshooting:**
- If hooks fail, check `.claude/hooks.log` for errors.
- For CI issues, review `ci.yml` workflow logs in GitHub Actions.