feat: add plugin-dev-guide meta-skill for skill navigation#196
Merged
sjnims merged 3 commits intosjnims:mainfrom Jan 28, 2026
Merged
feat: add plugin-dev-guide meta-skill for skill navigation#196sjnims merged 3 commits intosjnims:mainfrom
sjnims merged 3 commits intosjnims:mainfrom
Conversation
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 sjnims#184
sjnims
requested changes
Jan 26, 2026
Owner
sjnims
left a comment
sjnims
left a comment
There was a problem hiding this comment.
Review: Request Changes
Thanks for this contribution! The meta-skill is well-structured and addresses #184 nicely. A few changes needed before merging:
Required Changes
1. Update CLAUDE.md (line 7)
The skill and command counts need updating:
- 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.2. Bump version across all files
Adding a feature should increment the version. Update in 3 locations:
plugins/plugin-dev/.claude-plugin/plugin.json→0.3.3.claude-plugin/marketplace.jsonmetadata.version→0.3.3.claude-plugin/marketplace.jsonplugins[0].version→0.3.3CLAUDE.mdversion line →v0.3.3
Optional Suggestions
3. Add frontmatter to command (consistency)
Other commands specify allowed-tools and model. Consider adding:
---
description: Get an overview of plugin development capabilities and skill routing
argument-hint: [question or task]
allowed-tools: Skill, AskUserQuestion
model: sonnet
---4. Clarify skill count in SKILL.md (line 18)
Currently says "9 specialized skills" which is accurate but could confuse users. Consider:
- The plugin-dev toolkit provides 9 specialized skills for building Claude Code plugins.
+ The plugin-dev toolkit provides 9 specialized skills for building Claude Code plugins, plus this guide.Note about CI failures: All workflow failures are expected — they're caused by OIDC token restrictions on fork PRs, not issues with your code. The markdown lint/link checks passed. ✅
Looking forward to the updates!
- 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
1 task
sjnims
added a commit
that referenced
this pull request
Jan 28, 2026
Version bump to v0.3.3 ## Changes ### Added - **New skill: plugin-dev-guide** - Meta-skill providing overview of plugin development and routing to specialized skills (#196) - **New reference: commands-vs-skills.md** - Explains when to use commands vs skills and migration path ### Changed - **Update documentation for commands/skills merge** - Clarified that commands and skills use the same Skill tool mechanism but differ in complexity (fixes #198) ### Documentation - **Add plugin-dev-guide to Available Commands table** - Updated README with new command (#200) ### Maintenance - **Update plugin author metadata** - Synced author info to match marketplace owner ## Checklist - [x] Version updated in plugin.json, marketplace.json, CLAUDE.md - [x] CHANGELOG.md updated with release notes - [x] Markdownlint passes - [x] Version comparison links updated in CHANGELOG 🤖 Generated with [Claude Code](https://claude.ai/code) Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a guide skill that helps users navigate the 9 specialized plugin-dev skills, routing them to the appropriate skill based on their task.
plugin-dev-guideskill with decision tree and common workflowsplugin-dev-guidecommand for autocomplete discoverability (workaround for #18949)Changes
skills/plugin-dev-guide/SKILL.mdcommands/plugin-dev-guide.mdplugin.jsonmarketplace.jsonTest plan
claude plugin marketplace remove plugin-dev-marketplace; claude plugin marketplace add ./; claude plugin install plugin-dev; claude -d/plugin-dev:plugin-dev-guideappears in autocomplete/plugin-dev:plugin-dev-guide how do I add a hook?/plugin-dev:plugin-dev-guide(no args)Closes #184