add-plugin

Scaffold and publish Claude plugins with plugin.json and marketplace.json registration.

Updated Jan 21, 2026

Search Tags:#testing #CLI #scaffold #plugin #marketplace #SKILL.md #plugin.json

Ready to run

npx skills add https://github.com/powdream/claude-plugins --skill add-plugin-powdream

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: add-plugin
Source: https://github.com/powdream/claude-plugins/tree/main/.claude/skills/add-plugin
Command: npx skills add https://github.com/powdream/claude-plugins --skill add-plugin-powdream

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured guide to scaffold and publish new plugins for the Claude plugins marketplace. It covers creating the required plugin.json, SKILL.md structure, and registration steps.

Core Features & Use Cases

Scaffold plugin directories (plugins/<plugin-name>/, .claude-plugin/, skills/<skill-name>/) with required fields.
Validate that plugin.json contains name, description, and version; register the plugin in marketplace.json for discovery.
Test and iterate using the CLI workflow to ensure smooth deployment and activation.

Quick Start

Create a new plugin folder at plugins/<plugin-name> with .claude-plugin/plugin.json (name, description, version) and at least one skill under skills/<skill-name>/SKILL.md. Register in .claude-plugin/marketplace.json and run claude CLI to test the plugin.

Frequently Asked Questions about add-plugin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I scaffold a new plugin for the Claude marketplace?▼

To scaffold a new plugin, create a directory at plugins/<plugin-name> with a .claude-plugin/plugin.json file containing required fields like name, description, and version, then add skills under skills/<skill-name>/SKILL.md.

What fields are required in plugin.json for Claude plugin registration?▼

The plugin.json file requires three mandatory fields: name, description, and version. These fields validate your plugin structure before you register it in marketplace.json for discovery.

How do I register a plugin in marketplace.json to make it discoverable?▼

You register a plugin by adding its details to the .claude-plugin/marketplace.json file after creating the directory structure and validating the required plugin.json fields, ensuring the plugin becomes discoverable in the Claude marketplace.

Can I test my plugin workflow using the Claude CLI before publishing?▼

Yes, you can test and iterate on your plugin workflow using the provided Claude CLI process. This ensures smooth deployment and activation by validating the plugin structure before publishing to the marketplace.

What is the correct directory structure for publishing a Claude plugin?▼

The correct structure includes plugins/<plugin-name>/ as the root, a .claude-plugin/ directory containing plugin.json and marketplace.json, and a skills/<skill-name>/ directory containing the SKILL.md file.