plugin-formatter

Format Claude Code plugin structures and metadata to marketplace guidelines.

2|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/ZenterFlow/claude-priority --skill plugin-formatter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-formatter
Source: https://github.com/ZenterFlow/claude-priority/tree/main/plugin-formatter/skills/plugin-formatter
Command: npx skills add https://github.com/ZenterFlow/claude-priority --skill plugin-formatter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, jq, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Manually validating and formatting Claude Code plugins is a time-consuming and error-prone process, often leading to non-compliance with marketplace guidelines. This Skill eliminates that burden by automating the entire compliance workflow.

Core Features & Use Cases

  • Automated Formatting: Converts directory and file names to lowercase-with-hyphens, auto-fixes JSON fields (e.g., author string to object), and regenerates README.md skill lists.
  • Comprehensive Validation: Checks plugin.json, marketplace.json, and manifest.json against schemas, validates skill.md frontmatter, and ensures correct plugin structure.
  • Use Case: A developer creating a new Claude plugin can simply activate this Skill to ensure their project instantly meets all marketplace standards, saving hours of manual review, debugging, and rework.

Quick Start

Use the plugin-formatter skill to format the current plugin directory.

Frequently Asked Questions about plugin-formatter

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

FAQPage Schema
How do I validate and format Claude plugin structures to marketplace guidelines?

Plugin-formatter automates compliance validation by converting directory and file names to lowercase-with-hyphens, fixing JSON fields, validating plugin.json and marketplace.json against schemas, and regenerating documentation. Run it on your plugin directory to instantly meet all marketplace standards.

What file formats and structures does plugin-formatter check?

Plugin-formatter validates .claude-plugin/plugin.json, marketplace.json, manifest.json, skill.md frontmatter, and plugin repository structure including agents/, skills/, README.md, plugin.md, and marketplace.json files for JSON validity and naming conventions.

Can I use plugin-formatter to fix naming conventions in existing plugins?

Yes. Plugin-formatter automatically converts all directory and file names to lowercase-with-hyphens format and auto-fixes JSON fields like author strings to objects, making it ideal for retrofitting existing plugins to marketplace standards.

Do I need to manually regenerate README.md and plugin.md after formatting?

No. Plugin-formatter regenerates or validates README.md and plugin.md automatically as part of the compliance workflow, eliminating manual documentation updates and keeping metadata aligned with your plugin structure.

What are the dependencies required to run plugin-formatter?

Plugin-formatter requires python3 and jq. These tools handle JSON parsing and script execution needed to validate schemas and transform plugin metadata during the formatting process.

Can plugin-formatter handle optional manifest files in my plugin?

Yes. Plugin-formatter includes optional manifest handling as part of its comprehensive validation, checking manifest.json when present while maintaining flexibility for plugins that use alternative metadata structures.