plugin-authoring

Guide creation, validation, and safe edits of Claude Code plugins.

63|15|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/ivan-magda/claude-code-plugin-template --skill plugin-authoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-authoring
Source: https://github.com/ivan-magda/claude-code-plugin-template/tree/main/plugins/plugin-development/skills/plugin-authoring
Command: npx skills add https://github.com/ivan-magda/claude-code-plugin-template --skill plugin-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides expert guidance for designing, validating, and maintaining Claude Code plugins, including plugin.json, marketplace.json, commands, agents, skills, and hooks. It helps teams scaffold, review, and refine plugin structures to reduce risk and complexity.

Core Features & Use Cases

  • Guided scaffolding: start new plugins or components with vetted templates and safe defaults.
  • Validation & review: audit manifests, references, and workflows to ensure correctness and compliance.
  • Progressive disclosure guidance: structure SKILLs and nested components with templates and best practices (templates/examples).
  • Use Case: When starting a new plugin, outline required files, generate SKILL frontmatter, and verify consistency between plugin.json and marketplace.json.

Quick Start

Diagnose your repository structure, then let this Skill propose a plan of action. After confirmation, you can run /plugin-development:validate to audit, or /plugin-development:init to scaffold a new plugin.

Frequently Asked Questions about plugin-authoring

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

FAQPage Schema
How do I scaffold a new Claude Code plugin with proper structure?

Scaffolding a Claude Code plugin creates a vetted template with plugin.json, marketplace.json, and required component files pre-configured with safe defaults. Use the `/plugin-development:init` command to generate a new plugin structure that enforces frontmatter conventions and manifest consistency, reducing setup errors.

What files and conventions do I need to include in a Claude Code plugin?

Claude Code plugins require plugin.json and marketplace.json manifests, frontmatter conventions for SKILLs and nested components, organized command and hook definitions, and consistent cross-file references. This Skill guides creation of these files with templates and validates their alignment.

How do I validate that my plugin.json and marketplace.json are correct?

Plugin validation audits manifest structure, file references, and workflow compliance against guardrails for safe edits. Run `/plugin-development:validate` to check plugin.json and marketplace.json consistency, detect missing components, and verify your plugin meets authoring standards.

Can I use templates to organize commands, agents, and skills within my plugin?

Yes, this Skill provides templates and best practices for structuring commands, agents, skills, and hooks with progressive disclosure guidance. Templates enforce consistent organization across nested components and reduce complexity when designing plugin architecture.

What are the best practices for designing a safe, maintainable Claude Code plugin?

Best practices include using provided scaffolding templates, separating concerns across plugin.json and marketplace.json, defining clear frontmatter conventions, and applying guardrails on edits. This Skill embeds these practices into workflows to reduce risk during plugin design and review cycles.

Does this apply to plugins with non-standard layouts or custom hook structures?

Yes, this Skill applies across standard and non-standard plugin layouts, including custom commands, agents, skills, hooks, and component arrangements. It provides guidance and validation whether your plugin follows conventional structure or uses specialized configurations.