plugin-authoring

Guide Claude Code plugin authoring with plugin.json and marketplace.json validation.

Updated Dec 4, 2025
One-click install
npx skills add https://github.com/armstrongl/super-duper-disco --skill plugin-authoring-armstrongl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-authoring
Source: https://github.com/armstrongl/super-duper-disco/tree/main/plugins/plugin-development/skills/plugin-authoring
Command: npx skills add https://github.com/armstrongl/super-duper-disco --skill plugin-authoring-armstrongl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Expert guidance for building Claude Code plugins, including best practices for plugin.json, marketplace.json, commands, agents, Skills, and hooks.

Core Features & Use Cases

  • Guided scaffolding and validation: helps ensure manifests and component structures are correct.
  • Best practices and consistency checks: enforces naming conventions, progressive disclosure, and documentation standards.
  • Audits and reviews: supports escalation to a reviewer for deeper audits when needed.

Quick Start

Start by adding a new skill with /plugin-development:add-skill plugin-authoring and then fill SKILL.md and any references as directed.

Frequently Asked Questions about plugin-authoring

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

FAQPage Schema
How do I structure a Claude Code plugin manifest for plugin.json and marketplace.json?

Claude Code plugin authoring requires structuring plugin.json and marketplace.json manifests alongside component files. Expert guidance enforces naming conventions, frontmatter compliance, and progressive disclosure standards to ensure correct scaffolding and validation.

What are the best practices for adding commands, agents, and hooks to a Claude Code plugin?

Best practices for adding commands, agents, skills, and hooks involve following naming conventions and documentation standards. Expert guidance enforces consistency checks across component structures to maintain progressive disclosure and manifest compliance.

How do I validate my Claude Code plugin structure before publishing?

Validating a Claude Code plugin structure requires scaffold validation and consistency reviews. Expert guidance checks frontmatter requirements, naming conventions, and manifest compliance, with escalation to a plugin-reviewer for deeper audits when needed.

Can I use plugin-authoring guidance to modify existing Claude Code plugins?

Plugin authoring guidance applies to both creating and modifying Claude Code plugins. It supports adding commands, agents, skills, or hooks to existing manifests while ensuring ongoing compliance with best practices and structural consistency.

When should I escalate a Claude Code plugin for a deeper audit review?

Escalation to a plugin-reviewer is recommended when standard scaffold validation and consistency checks surface complex compliance issues. Deeper audits ensure frontmatter requirements, naming conventions, and best practices are fully met before publication.

Do I need to follow specific frontmatter requirements when authoring Claude Code plugin Skills?

Frontmatter requirements are mandatory when authoring Claude Code plugin Skills. Expert guidance ensures compliance with these standards alongside naming conventions and documentation rules to maintain structural consistency and progressive disclosure.