Verified:GitHub

plugin-validator

Validate Claude Code plugin structure, SKILL.md metadata, and dependency integrity.

1|Updated Mar 27, 2026

Search Tags:#claude code #plugin validation #schema compliance #dependency checks #skill metadata #diagnostic report #mcp wiring

One-click install

npx skills add https://github.com/Ameng2001/astra-studio-plugins --skill plugin-validator-ameng2001

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: plugin-validator
Source: https://github.com/Ameng2001/astra-studio-plugins/tree/main/studio-quality/skills/plugin-validator
Command: npx skills add https://github.com/Ameng2001/astra-studio-plugins --skill plugin-validator-ameng2001

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) components.

What problem does it solve?

Plugin authors need to catch structural issues, missing or malformed skill metadata, and broken dependency wiring before shipping, but manual review is slow and error-prone.

Core Features & Use Cases

Structural validation: Verifies plugin.json and resolved declared paths, including skills, commands, hooks, and MCP server entries.
Skill validation: Confirms each SKILL.md has valid YAML frontmatter with required fields and checks name/dir alignment plus referenced file existence.
Dependency integrity checks: Validates .mcp.json, hooks.json event names, and declared plugin dependencies, then produces a remediation-focused report.
Studio status update (optional): If a matching workspace exists, moves built skills to tested and advances plugin phase when checks pass.

Quick Start

Run plugin-validator with the path to your plugin directory to generate a pass/fail summary and a JSON report with concrete remediation steps.

Frequently Asked Questions about plugin-validator

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

FAQPage Schema

Can I automate moving built skills to tested after validation passes?▼

Yes, if a matching workspace exists, the validation process can optionally trigger a studio status update that moves built skills to tested and advances the plugin phase automatically when all checks pass.

How do I validate Claude Code plugin structure before packaging?▼

Validate plugin structure by running scripts that verify plugin.json paths, check SKILL.md YAML frontmatter, confirm MCP and hooks wiring, and output a diagnostic report with pass/fail status and remediation steps.

What does Claude Code plugin dependency validation check?▼

Dependency validation checks .mcp.json, hooks.json event names, and declared plugin dependencies, producing a remediation-focused report to resolve broken MCP wiring or missing components.

Do I need Python to run plugin validation scripts?▼

Yes, Python is required to run the plugin validation scripts that inspect plugin directories, verify SKILL.md frontmatter, check dependency integrity, and generate the combined diagnostic report.