Skip to content

Conversation

@kylesnowschwartz
Copy link
Contributor

@kylesnowschwartz kylesnowschwartz commented Jan 26, 2026

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.

  • New plugin-dev-guide skill with decision tree and common workflows
  • New plugin-dev-guide command for autocomplete discoverability (workaround for #18949)
  • Updates skill count to 10 in manifests

Changes

File Purpose
skills/plugin-dev-guide/SKILL.md Meta-skill with routing logic (972 words)
commands/plugin-dev-guide.md Command wrapper for slash menu visibility
plugin.json Updated description (10 skills)
marketplace.json Updated description (10 skills)

Test plan

  • Load plugin locally: claude plugin marketplace remove plugin-dev-marketplace; claude plugin marketplace add ./; claude plugin install plugin-dev; claude -d
  • Verify /plugin-dev:plugin-dev-guide appears in autocomplete
  • Test routing: /plugin-dev:plugin-dev-guide how do I add a hook?
  • Test overview: /plugin-dev:plugin-dev-guide (no args)

Closes #184

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
Copy link
Owner

@sjnims sjnims left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.json0.3.3
  • .claude-plugin/marketplace.json metadata.version0.3.3
  • .claude-plugin/marketplace.json plugins[0].version0.3.3
  • CLAUDE.md version 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!

@sjnims sjnims self-assigned this Jan 26, 2026
sjnims and others added 2 commits January 25, 2026 20:53
- 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature]: Meta-Skill

2 participants