plugin-validation

Validate Claude Code plugin structure, manifests, and SKILL.md frontmatter.

10|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/viktorbezdek/skillstack --skill plugin-validation-viktorbezdek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-validation
Source: https://github.com/viktorbezdek/skillstack/tree/main/plugin-dev/skills/plugin-validation
Command: npx skills add https://github.com/viktorbezdek/skillstack --skill plugin-validation-viktorbezdek

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill catches structural issues in Claude Code plugins that cause installation failures, loading errors, or CI breaks, preventing wasted time on preventable mistakes.

Core Features & Use Cases

  • Manifest and Frontmatter Validation: Checks plugin.json syntax, required fields, and SKILL.md YAML frontmatter for name/description correctness and name-directory matching.
  • Cross-Reference and Structure Checks: Verifies referenced files exist and enforces directory conventions, including multi-skill plugin validation.
  • Use Case: Before pushing a new plugin to GitHub, run validation to confirm no drift in versions or missing references, ensuring smooth marketplace publishing and CI passes.

Quick Start

Validate the structure of my Claude Code plugin directory to catch any errors before publishing.

Frequently Asked Questions about plugin-validation

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

FAQPage Schema
How do I validate Claude Code plugin manifests and frontmatter for structural errors?

To validate Claude Code plugin structure, check plugin.json syntax, required fields, and SKILL.md YAML frontmatter for name and description correctness, ensuring name-to-directory consistency before publishing.

Why does my Claude Code plugin fail to load or break CI pipelines?

Claude Code plugin loading failures often stem from structural issues like invalid plugin.json manifests, incorrect SKILL.md frontmatter, or missing reference cross-references that validation checks can detect and prevent.

Can I check referenced files and directory conventions for multi-skill plugins?

Yes, cross-reference and structure checks verify that referenced files exist and enforce directory conventions, including validation for multi-skill plugins to catch missing references or naming drift.

What is the best way to review third-party Claude plugins before shipping?

The best way to review third-party Claude plugins is running structural validation to detect manifest errors, frontmatter issues, and reference mismatches without assessing functional output or skill quality.

Does plugin validation check functional output and skill quality?

No, plugin validation checks structural correctness of manifests, frontmatter, and references, satisfying error detection in plugin structure conventions without assessing functional output or skill quality.

How do I set up CI integration workflows to catch Claude plugin structural issues?

Set up CI integration workflows by running validation steps that check plugin.json manifests, SKILL.md frontmatter, and reference cross-references to confirm no version drift or missing files before pushing.