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.