plugin-validation

Validate Claude Code plugin structures and metadata for configuration errors.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill validates Claude Code plugin structures and metadata to prevent misconfigurations and ensure compliance with plugin guidelines.

Core Features & Use Cases

  • Validate that plugin.json exists and contains required fields like name.
  • Validate that each skill's SKILL.md contains the required name and description in frontmatter and that references are coherent.
  • Generate a lint-like report highlighting errors and warnings to guide fixes.
  • Use case: A development team runs the validator before publishing a plugin to the marketplace to catch structural issues early.

Quick Start

Run the validator on your plugin directory: "${CLAUDE_PLUGIN_ROOT}/scripts/validate-plugin.sh" [path]

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 structure before publishing?

To validate Claude Code plugin structure, run the validation script on your plugin directory. It checks plugin.json and SKILL.md frontmatter, verifies references for commands, skills, agents, and hooks, and generates a lint-like report of configuration errors.

What is plugin metadata validation and when do I need it?

Plugin metadata validation is the process of checking plugin.json and SKILL.md files for required fields like name and description. You need it before publishing a plugin to the marketplace to catch structural issues and ensure format compliance early.

How do I lint plugin.json and check SKILL.md frontmatter references?

You can lint plugin.json and check SKILL.md frontmatter by running the validator script. It enforces required fields such as name and description, checks reference coherence across commands, skills, agents, and hooks, and highlights warnings to guide fixes.

Does the Claude Code plugin validator require any dependencies to run?

The Claude Code plugin validator requires no external dependencies to run. It operates as a standalone shell script that analyzes your plugin directory structure and metadata directly to catch configuration errors.

Why does my Claude Code plugin validation report show missing frontmatter fields?

Your Claude Code plugin validation report shows missing frontmatter fields because the validator enforces required metadata like name and description in SKILL.md. It generates these lint-like warnings to guide you in fixing format compliance issues.