From ae29b9d7bc44daf48c0d9db416fcdd634dbccad5 Mon Sep 17 00:00:00 2001 From: kylesnowschwartz Date: Mon, 26 Jan 2026 13:00:26 +1300 Subject: [PATCH 1/2] feat: add plugin-dev-guide meta-skill for skill navigation Adds a guide skill that helps users navigate the 9 specialized plugin-dev skills. Routes users to the appropriate skill based on their task. - New skill: plugin-dev-guide with decision tree and workflows - New command: plugin-dev-guide for autocomplete discoverability - Update skill count to 10 in plugin.json and marketplace.json Closes #184 --- .claude-plugin/marketplace.json | 2 +- plugins/plugin-dev/.claude-plugin/plugin.json | 2 +- .../plugin-dev/commands/plugin-dev-guide.md | 10 + .../skills/plugin-dev-guide/SKILL.md | 214 ++++++++++++++++++ 4 files changed, 226 insertions(+), 2 deletions(-) create mode 100644 plugins/plugin-dev/commands/plugin-dev-guide.md create mode 100644 plugins/plugin-dev/skills/plugin-dev-guide/SKILL.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 478fd8a..aac066b 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -11,7 +11,7 @@ "plugins": [ { "name": "plugin-dev", - "description": "Comprehensive toolkit for developing Claude Code plugins. Includes 9 expert skills covering hooks, MCP integration, LSP servers, commands, agents, marketplaces, and best practices. AI-assisted plugin creation and validation.", + "description": "Comprehensive toolkit for developing Claude Code plugins. Includes 10 expert skills covering hooks, MCP integration, LSP servers, commands, agents, marketplaces, and best practices, plus a guide skill for navigation. AI-assisted plugin creation and validation.", "version": "0.3.2", "author": { "name": "Daisy Hollman", diff --git a/plugins/plugin-dev/.claude-plugin/plugin.json b/plugins/plugin-dev/.claude-plugin/plugin.json index 47ac0c3..1f9bb66 100644 --- a/plugins/plugin-dev/.claude-plugin/plugin.json +++ b/plugins/plugin-dev/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "plugin-dev", "version": "0.3.2", - "description": "Comprehensive toolkit for developing Claude Code plugins. Includes 9 expert skills covering hooks, MCP integration, LSP servers, commands, agents, marketplaces, and best practices. AI-assisted plugin creation and validation.", + "description": "Comprehensive toolkit for developing Claude Code plugins. Includes 10 expert skills covering hooks, MCP integration, LSP servers, commands, agents, marketplaces, and best practices, plus a guide skill for navigation. AI-assisted plugin creation and validation.", "author": { "name": "Daisy Hollman", "email": "daisy@anthropic.com" diff --git a/plugins/plugin-dev/commands/plugin-dev-guide.md b/plugins/plugin-dev/commands/plugin-dev-guide.md new file mode 100644 index 0000000..2700370 --- /dev/null +++ b/plugins/plugin-dev/commands/plugin-dev-guide.md @@ -0,0 +1,10 @@ +--- +description: Get an overview of plugin development capabilities and skill routing +argument-hint: [question or task] +--- + +Invoke the plugin-dev:plugin-dev-guide skill to load plugin development guidance. + +Then help with: $ARGUMENTS + +If no arguments provided, summarize what plugin development capabilities are available and ask the user what they want to build or learn about. diff --git a/plugins/plugin-dev/skills/plugin-dev-guide/SKILL.md b/plugins/plugin-dev/skills/plugin-dev-guide/SKILL.md new file mode 100644 index 0000000..c842d0b --- /dev/null +++ b/plugins/plugin-dev/skills/plugin-dev-guide/SKILL.md @@ -0,0 +1,214 @@ +--- +name: plugin-dev-guide +description: This skill should be used when the user asks about "Claude Code plugins", "plugin development", "how to build a plugin", "what plugin components exist", "plugin architecture", "extending Claude Code", or needs an overview of plugin development capabilities. Acts as a guide to the 9 specialized plugin-dev skills, explaining when to activate each one. Load this skill first when the user is new to plugin development or unsure which specific skill they need. +--- + +# Plugin Development Guide + +This meta-skill provides an overview of Claude Code plugin development and routes to specialized skills based on the task at hand. + +## Plugin Development Skills Overview + +The plugin-dev toolkit provides 9 specialized skills for building Claude Code plugins. Each skill handles a specific domain of plugin development. + +### Skill Quick Reference + +| Skill | Purpose | +| ------- | --------- | +| **plugin-structure** | Directory layout, manifest, component organization | +| **command-development** | Slash commands with frontmatter | +| **agent-development** | Autonomous subagents | +| **skill-development** | Creating skills with progressive disclosure | +| **hook-development** | Event-driven automation | +| **mcp-integration** | Model Context Protocol servers | +| **lsp-integration** | Language Server Protocol for code intelligence | +| **plugin-settings** | User configuration via .local.md | +| **marketplace-structure** | Plugin marketplace creation | + +## When to Use Each Skill + +### Starting a New Plugin + +**Skill: `plugin-structure`** + +Use when the user needs to: + +- Create a new plugin from scratch +- Understand plugin directory layout +- Configure plugin.json manifest +- Learn about component auto-discovery +- Use ${CLAUDE_PLUGIN_ROOT} for portable paths + +### Adding User-Facing Commands + +**Skill: `command-development`** + +Use when the user needs to: + +- Create slash commands (/command-name) +- Configure command frontmatter (description, allowed-tools, model) +- Use dynamic arguments ($ARGUMENTS, $1, $2) +- Reference files with @ syntax +- Execute bash inline with `[BANG]` backticks + +### Creating Autonomous Agents + +**Skill: `agent-development`** + +Use when the user needs to: + +- Create subagents for complex tasks +- Write agent system prompts +- Configure agent triggering (description with examples) +- Choose agent models and colors +- Restrict agent tool access + +### Building Skills + +**Skill: `skill-development`** + +Use when the user needs to: + +- Create skills that extend Claude's capabilities +- Write SKILL.md with proper frontmatter +- Organize skill content with progressive disclosure +- Create references/, examples/, scripts/ directories +- Write effective trigger phrases + +### Implementing Event Hooks + +**Skill: `hook-development`** + +Use when the user needs to: + +- React to Claude Code events (PreToolUse, Stop, SessionStart, etc.) +- Create prompt-based or command-based hooks +- Validate tool inputs before execution +- Enforce completion standards +- Block dangerous operations + +### Integrating External Services via MCP + +**Skill: `mcp-integration`** + +Use when the user needs to: + +- Add MCP servers to plugins +- Configure stdio, SSE, HTTP, or WebSocket servers +- Set up authentication (OAuth, tokens) +- Use MCP tools in commands and agents +- Discover existing MCP servers on PulseMCP + +### Adding Code Intelligence via LSP + +**Skill: `lsp-integration`** + +Use when the user needs to: + +- Add Language Server Protocol servers to plugins +- Enable go-to-definition and find-references +- Configure language-specific servers (pyright, gopls, rust-analyzer) +- Set up extensionToLanguage mappings +- Enhance Claude's code understanding + +### Managing Plugin Configuration + +**Skill: `plugin-settings`** + +Use when the user needs to: + +- Store user-configurable settings +- Use .claude/plugin-name.local.md pattern +- Parse YAML frontmatter in hooks +- Create temporarily active hooks +- Manage agent state + +### Creating Plugin Marketplaces + +**Skill: `marketplace-structure`** + +Use when the user needs to: + +- Create a marketplace for multiple plugins +- Configure marketplace.json +- Set up plugin sources (relative, GitHub, git URL) +- Distribute plugins to teams +- Organize plugin collections + +## Decision Tree for Skill Selection + +``` +User wants to... +├── Create/organize a plugin structure? → plugin-structure +├── Add a slash command? → command-development +├── Create an autonomous agent? → agent-development +├── Add domain expertise/knowledge? → skill-development +├── React to Claude Code events? → hook-development +├── Integrate external service/API? → mcp-integration +├── Add code intelligence/LSP? → lsp-integration +├── Make plugin configurable? → plugin-settings +└── Distribute multiple plugins? → marketplace-structure +``` + +## Common Multi-Skill Workflows + +### Building a Complete Plugin + +1. **Start**: Load `plugin-structure` skill to create directory layout +2. **Add features**: Load `command-development` for user-facing commands +3. **Automation**: Load `hook-development` for event-driven behavior +4. **Configuration**: Load `plugin-settings` if user configuration needed +5. **Validation**: Use plugin-validator agent to validate structure + +### Creating an MCP-Powered Plugin + +1. **Start**: Load `plugin-structure` for basic structure +2. **Integration**: Load `mcp-integration` to configure MCP servers +3. **Commands**: Load `command-development` to create commands that use MCP tools +4. **Agents**: Load `agent-development` for autonomous MCP workflows + +### Building a Code Intelligence Plugin + +1. **Start**: Load `plugin-structure` for basic structure +2. **LSP**: Load `lsp-integration` to configure language servers +3. **Commands**: Load `command-development` for commands using LSP features + +### Building a Skill-Focused Plugin + +1. **Start**: Load `plugin-structure` for basic structure +2. **Skills**: Load `skill-development` to create specialized skills +3. **Validation**: Use skill-reviewer agent to validate skill quality + +## Available Agents + +The plugin-dev plugin also provides 3 agents: + +| Agent | Purpose | +|-------|---------| +| **plugin-validator** | Validates plugin structure and manifests | +| **skill-reviewer** | Reviews skill quality and triggering | +| **agent-creator** | Generates new agents from descriptions | + +Use agents proactively after creating components to ensure quality. + +## Available Commands + +| Command | Purpose | +|---------|---------| +| `/plugin-dev:start` | Entry point - choose plugin or marketplace creation | +| `/plugin-dev:create-plugin` | 8-phase guided plugin creation workflow | +| `/plugin-dev:create-marketplace` | 8-phase guided marketplace creation workflow | + +--- + +## User Request + +$ARGUMENTS + +If the user provided a request above, analyze it and either: + +1. **Route to a specific skill** if the request clearly matches one domain +2. **Answer directly** using this guide's overview information +3. **Ask for clarification** if the request is ambiguous + +If no request was provided, summarize the available plugin development capabilities and ask what the user wants to build or learn about. From fc97a0a68489e50ba2125687f5ce782a29179dbb Mon Sep 17 00:00:00 2001 From: kylesnowschwartz Date: Mon, 26 Jan 2026 17:23:04 +1300 Subject: [PATCH 2/2] =?UTF-8?q?chore:=20bump=20version=200.3.2=20=E2=86=92?= =?UTF-8?q?=200.3.3=20and=20update=20component=20counts?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Bump plugin version to 0.3.3 in plugin.json and marketplace.json - Update CLAUDE.md version reference and component counts (10 skills, 3 agents, 4 slash commands) - Add command frontmatter (allowed-tools, model) to plugin-dev-guide - Clarify skill count statement in plugin-dev-guide SKILL.md --- .claude-plugin/marketplace.json | 4 ++-- CLAUDE.md | 4 ++-- plugins/plugin-dev/.claude-plugin/plugin.json | 2 +- plugins/plugin-dev/commands/plugin-dev-guide.md | 2 ++ plugins/plugin-dev/skills/plugin-dev-guide/SKILL.md | 2 +- 5 files changed, 8 insertions(+), 6 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 5f737f8..2137a34 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -6,13 +6,13 @@ }, "metadata": { "description": "Unofficial plugin-dev plugin marketplace. Originally created by Daisy Hollman at Anthropic, now maintained by Steve Nims.", - "version": "0.3.2" + "version": "0.3.3" }, "plugins": [ { "name": "plugin-dev", "description": "Comprehensive toolkit for developing Claude Code plugins. Includes 10 expert skills covering hooks, MCP integration, LSP servers, commands, agents, marketplaces, and best practices, plus a guide skill for navigation. AI-assisted plugin creation and validation.", - "version": "0.3.2", + "version": "0.3.3", "author": { "name": "Steve Nims", "url": "https://github.com/sjnims" diff --git a/CLAUDE.md b/CLAUDE.md index 35b4477..882fcb4 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,9 +4,9 @@ Guidance for Claude Code working in this repository. ## What This Is -Plugin marketplace containing the **plugin-dev** plugin - a toolkit for developing Claude Code plugins. Provides 9 skills, 3 agents, 3 slash commands. +Plugin marketplace containing the **plugin-dev** plugin - a toolkit for developing Claude Code plugins. Provides 10 skills, 3 agents, 4 slash commands. -**Version**: v0.3.2 | [CHANGELOG.md](CHANGELOG.md) +**Version**: v0.3.3 | [CHANGELOG.md](CHANGELOG.md) ## MCP Tool Requirements (CRITICAL) diff --git a/plugins/plugin-dev/.claude-plugin/plugin.json b/plugins/plugin-dev/.claude-plugin/plugin.json index 1c78c38..6821991 100644 --- a/plugins/plugin-dev/.claude-plugin/plugin.json +++ b/plugins/plugin-dev/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "plugin-dev", - "version": "0.3.2", + "version": "0.3.3", "description": "Comprehensive toolkit for developing Claude Code plugins. Includes 10 expert skills covering hooks, MCP integration, LSP servers, commands, agents, marketplaces, and best practices, plus a guide skill for navigation. AI-assisted plugin creation and validation.", "author": { "name": "Steve Nims", diff --git a/plugins/plugin-dev/commands/plugin-dev-guide.md b/plugins/plugin-dev/commands/plugin-dev-guide.md index 2700370..d393236 100644 --- a/plugins/plugin-dev/commands/plugin-dev-guide.md +++ b/plugins/plugin-dev/commands/plugin-dev-guide.md @@ -1,6 +1,8 @@ --- description: Get an overview of plugin development capabilities and skill routing argument-hint: [question or task] +allowed-tools: Skill, AskUserQuestion +model: sonnet --- Invoke the plugin-dev:plugin-dev-guide skill to load plugin development guidance. diff --git a/plugins/plugin-dev/skills/plugin-dev-guide/SKILL.md b/plugins/plugin-dev/skills/plugin-dev-guide/SKILL.md index c842d0b..33ab28b 100644 --- a/plugins/plugin-dev/skills/plugin-dev-guide/SKILL.md +++ b/plugins/plugin-dev/skills/plugin-dev-guide/SKILL.md @@ -9,7 +9,7 @@ This meta-skill provides an overview of Claude Code plugin development and route ## Plugin Development Skills Overview -The plugin-dev toolkit provides 9 specialized skills for building Claude Code plugins. Each skill handles a specific domain of plugin development. +The plugin-dev toolkit provides 9 specialized skills for building Claude Code plugins, plus this guide. Each skill handles a specific domain of plugin development. ### Skill Quick Reference