plugin-validation-skill

Validate Claude Code plugin manifests, hooks, skills, MCP servers, and marketplace entries.

4|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/Emasoft/claude-plugins-validation --skill plugin-validation-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-validation-skill
Source: https://github.com/Emasoft/claude-plugins-validation/tree/main/skills/plugin-validation-skill
Command: npx skills add https://github.com/Emasoft/claude-plugins-validation --skill plugin-validation-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes references (resource) components.

What problem does it solve?

This Skill helps teams validate Claude Code plugins, hooks, skills, MCP servers, and marketplaces to ensure they meet structure and safety requirements.

Core Features & Use Cases

  • Comprehensive validation: Verifies plugin manifests, directory structure, and component placement for plugins, skills, hooks, and MCP configurations.
  • Quality gate for releases: Integrates with CI workflows to enforce standards before publishing to marketplaces or deployment environments.
  • Guided remediation: Provides clear guidance on issues and fixes, with references to official validation resources.

Quick Start

  1. Navigate to the claude-plugins-validation repository and install dependencies.
  2. Validate an entire plugin: uv run python scripts/validate_plugin.py /path/to/plugin --verbose
  3. Validate a single skill: uv run python scripts/validate_skill.py /path/to/skill

Frequently Asked Questions about plugin-validation-skill

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

FAQPage Schema
How do I validate Claude Code plugin manifests and component structure?

Claude Code plugin validation verifies manifests, directory structure, and component placement by enforcing frontmatter presence and cross-checking against marketplace definitions. This structured quality gate ensures reliable plugin deployment.

Can I check MCP server configurations and hooks before deploying to a marketplace?

Yes, you can validate MCP server configurations and hooks before marketplace deployment. The validation process checks path portability and component structure, integrating into CI workflows to enforce standards before publishing.

How do I validate a single Claude Code skill in my development pipeline?

To validate a single Claude Code skill, run `uv run python scripts/validate_skill.py /path/to/skill`. This checks the skill's frontmatter and structure to ensure it meets required quality standards.

Why does my Claude Code plugin fail marketplace validation checks?

Marketplace validation fails when plugins lack required frontmatter, have incorrect component placement, or violate path portability rules. The validation process cross-checks these elements against marketplace definitions to identify structural issues.

Do I need pyyaml to run Claude Code plugin validation scripts?

Yes, pyyaml is a required dependency for running Claude Code plugin validation. You need to install dependencies in the validation repository before executing the Python scripts to validate plugins, skills, or MCP configurations.

What is the best way to enforce quality gates for Claude Code plugin releases?

The best way to enforce quality gates for Claude Code plugin releases is integrating structured validation into CI workflows. This verifies plugin manifests, hooks, skills, and MCP configurations before publishing to ensure reliable deployment.