plugin-validator

Validates Claude Code plugin structure against the official specification.

2|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/shawn-sandy/agentics --skill plugin-validator-shawn-sandy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-validator
Source: https://github.com/shawn-sandy/agentics/tree/main/plugins/agentic-plugin-dev/skills/plugin-validator
Command: npx skills add https://github.com/shawn-sandy/agentics --skill plugin-validator-shawn-sandy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the tedious and error-prone process of manually verifying if a Claude Code plugin adheres to the official specification, saving developers time and preventing common structural errors.

Core Features & Use Cases

  • Comprehensive Validation: Checks manifest files, directory structure, component frontmatter, and marketplace cross-references.
  • Detailed Reporting: Provides a scored report with clear PASS/FAIL indicators for each check.
  • Use Case: Before publishing a new plugin, run this validator to catch any structural issues, ensuring it's ready for discovery and installation.

Quick Start

Use the plugin-validator skill to validate the plugin located at the path './plugins/my-new-plugin'.

Frequently Asked Questions about plugin-validator

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

FAQPage Schema
How do I validate a Claude Code plugin before publishing?

To validate a Claude Code plugin, run the plugin-validator against your plugin directory path. It audits manifest fields, directory layout, component frontmatter, and marketplace references, producing a detailed scored report to ensure compliance.

What does a Claude plugin structural compliance check include?

A Claude plugin structural compliance check includes auditing manifest files, verifying the directory layout, inspecting component frontmatter, and cross-referencing marketplace references to produce a scored PASS or FAIL report.

Why does my Claude plugin fail marketplace discoverability checks?

Your Claude plugin fails marketplace discoverability checks when its manifest fields, directory layout, component frontmatter, or marketplace references do not adhere to the official specification. Run a validation audit to identify specific structural errors.

Can I automatically audit component frontmatter for Claude plugins?

Yes, you can automatically audit component frontmatter for Claude plugins by running the plugin-validator. It checks frontmatter adherence to the official specification and includes the results in a detailed scored report.

What is the best way to check Claude plugin manifest fields for errors?

The best way to check Claude plugin manifest fields for errors is using an automated validation tool. It audits manifest fields against the official specification and generates a detailed scored report with clear PASS or FAIL indicators.