creating-plugins

jeongsk 的头像作者 jeongsk

使用命令、代理、技能、挂钩和 MCP 服务器创建 Claude Code 插件的指南。当用户想要创建新插件、添加插件组件(命令、代理、挂钩)、设置插件市场或需要 plugin.json 配置帮助时使用。

📖 中文导读:使用命令、代理、技能、挂钩和 MCP 服务器创建 Claude Code 插件的指南。当用户想要创建新插件、添加插件组件(命令、代理、挂钩)、设置插件市场或需要 plugin.json 配置帮助时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: creating-plugins description: Guide for creating Claude Code plugins with commands, agents, skills, hooks, and MCP servers. Use when the user wants to create a new plugin, add plugin components (commands, agents, hooks), set up a plugin marketplace, or needs help with plugin.json configuration.

Plugin Creator

Create Claude Code plugins to extend functionality with custom commands, agents, skills, hooks, and MCP servers.

Plugin Creation Workflow

1. Gather Requirements

Ask the user:

  • What functionality should the plugin provide?
  • Which components are needed? (commands, agents, hooks, MCP servers, skills)
  • Who is the target audience? (personal, team, public)

2. Create Plugin Structure

my-plugin/
├── .claude-plugin/
│   └── plugin.json      # Required
├── commands/            # Optional: slash commands
├── agents/              # Optional: sub-agents
├── skills/              # Optional: agent skills
├── hooks/               # Optional: event handlers
└── .mcp.json           # Optional: MCP servers

3. Write plugin.json

Minimal example:

{
  "name": "my-plugin",
  "description": "Brief description",
  "version": "1.0.0",
  "author": {"name": "Author Name"}
}

4. Add Components

Based on user requirements, add:

  • Commands: See commands.md for slash command format
  • Agents: See agents.md for agent definition format
  • Hooks: See hooks.md for event handler configuration
  • MCP Servers: See mcp-servers.md for server configuration

5. Test Locally

Create a test marketplace:

mkdir test-marketplace/.claude-plugin

Create test-marketplace/.claude-plugin/marketplace.json:

{
  "name": "test-marketplace",
  "owner": {"name": "Developer"},
  "plugins": [{"name": "my-plugin", "source": "./my-plugin"}]
}

Test commands:

/plugin marketplace add ./test-marketplace
/plugin install my-plugin@test-marketplace

Quick Reference

Command File (commands/hello.md)

---
description: Greet the user
---
# Hello Command
Greet the user warmly.

Agent File (agents/reviewer.md)

---
description: Code review specialist
capabilities: ["review", "suggestions"]
---
# Reviewer
Review code for quality and best practices.

Hooks (hooks/hooks.json)

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{"type": "command", "command": "prettier --write $CLAUDE_FILE_PATH"}]
    }]
  }
}

References

Plugin Development

Plugin Components

Skills Development