plugin-forge_skill

Overview

This skill creates and manages Claude Code plugins with the correct directory layout, manifests, and marketplace integration. It automates scaffolding, version bumps, manifest updates, and local install/test workflows to streamline plugin development and publishing. Use it to ensure plugins follow marketplace conventions and semantic versioning.

How this skill works

The tool provides scripts and conventions to scaffold plugin directories, generate plugin and marketplace manifests, and update both when versions change. It inspects plugin folders for commands, skills, agents, hooks, and external integration metadata, then updates marketplace.json entries and supports local install/uninstall test flows. Automation scripts (create_plugin.py, bump_version.py) perform routine tasks to avoid manual mistakes.

When to use it

• Creating a new plugin for a Claude Code marketplace
• Adding or modifying plugin components (commands, skills, agents, hooks)
• Bumping plugin versions and keeping manifests in sync
• Setting up or testing a plugin locally before publish
• Preparing plugin entries for marketplace distribution

Best practices

• Follow the prescribed directory layout for plugins and component subfolders to ensure correct namespacing
• Keep plugin.json and marketplace.json versions in sync; use the bump script to automate semantic versioning
• Name commands using subdirectory names to derive /namespace:command paths consistently
• Include clear author, description, keywords, and category metadata in manifests for discoverability
• Use conventional commit messages to make changelogs and releases predictable

Example use cases

• Scaffold a new productivity plugin with metadata and initial command files using the create script
• Add a new command or agent, then bump the plugin minor version and update marketplace entry automatically
• Run local install/uninstall workflow to validate plugin behavior in a development Claude Code marketplace
• Convert a utility tool into a marketplace-ready plugin with proper manifests and keywords for search