Is YAML frontmatter validation included?

Yes, the skill specifically checks for valid YAML syntax in the header of Markdown files, ensuring no tabs are used for indentation and all required metadata fields are present.

What files does this validator check?

It validates the .claude-plugin/plugin.json manifest, agent definitions in the agents folder, skill files (SKILL.md), command files, and general file encoding across the project.

Why is my Claude Code plugin failing to install?

Installation failures are often caused by JSON syntax errors in the manifest, missing required fields like 'version' or 'author', or incorrect directory structures. This skill identifies and helps fix these issues.

Does this skill handle cross-platform path issues?

Yes, it checks for Windows path separators, case sensitivity, and line ending compatibility to ensure plugins work reliably across Linux, Mac, and Windows environments.

Can it fix encoding issues?

While its primary role is validation, the skill provides guidance on normalizing file encodings to UTF-8 and managing Git line-ending configurations to prevent corruption.

Claude Plugin Validator

Name: Claude Plugin Validator
Author: bejranonda

bybejranonda

•

セキュリティとテスト

Validates Claude Code plugin manifests, directory structures, and file formats to ensure seamless installation and standard compliance.

概要

This skill provides a comprehensive validation framework for Claude Code plugins, ensuring they adhere to official development guidelines and cross-platform compatibility standards. It automates critical checks for the plugin manifest (plugin.json), directory hierarchy, YAML frontmatter, and file encoding, specifically targeting common issues that cause installation failures. By integrating this skill into your development workflow, you can prevent breakage, debug loading errors, and maintain compatibility across different Claude Code versions, making it an essential tool for plugin developers aiming for production-ready releases.

主な機能

Pre-installation diagnostic scripts to prevent deployment breakage
Directory structure and naming convention verification for agents and skills
9 GitHub stars
Cross-platform compatibility audits including path handling and line endings
YAML frontmatter parsing and syntax checking for Markdown definitions
Automated plugin manifest (plugin.json) schema and requirement validation

ユースケース

Debugging 'Plugin failed to load' errors and installation failures
Ensuring cross-platform compatibility for plugins used across Windows, Mac, and Linux
Preparing a Claude Code plugin for public release or repository distribution

概要

主な機能

Pre-installation diagnostic scripts to prevent deployment breakage
Directory structure and naming convention verification for agents and skills
9 GitHub stars
Cross-platform compatibility audits including path handling and line endings
YAML frontmatter parsing and syntax checking for Markdown definitions
Automated plugin manifest (plugin.json) schema and requirement validation

ユースケース

Debugging 'Plugin failed to load' errors and installation failures
Ensuring cross-platform compatibility for plugins used across Windows, Mac, and Linux
Preparing a Claude Code plugin for public release or repository distribution