skills.rest
bejranonda
bejranondaCOMMUNITY
Explore all skills by this author →
GitHub

claude-plugin-validation

Validate Claude Code plugin manifests and directory structures for compliance.

27|16|Updated Oct 20, 2025
Search Tags:#quality assurance#compatibility#AI development#plugin validation#Claude plugins#manifest validation#installation prevention
One-click install
npx skills add https://github.com/bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude --skill claude-plugin-validation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-plugin-validation
Source: https://github.com/bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude/tree/main/skills/claude-plugin-validation
Command: npx skills add https://github.com/bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude --skill claude-plugin-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? This Skill ensures Claude Code plugins comply with official development guidelines, preventing installation failures, maintaining compatibility across versions, and streamlining the plugin release process. It saves developers time and frustration.

Core Features & Use Cases:

  • Plugin Manifest Validation: Checks plugin.json for required fields, valid JSON syntax, and semantic versioning.
  • Directory Structure & File Format Compliance: Validates the plugin's folder structure and the YAML frontmatter/Markdown format of agent, skill, and command files.
  • Cross-Platform Compatibility: Ensures proper handling of file paths, character encoding, and line endings across different operating systems.
  • Installation Failure Prevention: Provides pre-installation validation scripts and troubleshooting steps for common issues.
  • Use Case: Before publishing a new Claude plugin, use this skill to run a comprehensive validation, automatically detecting manifest errors, structural issues, and encoding problems that could cause installation failures, ensuring a smooth user experience.

Quick Start: Explain the "Required Structure" for a Claude Code plugin and the critical requirements for its plugin.json manifest.

Frequently Asked Questions about claude-plugin-validation

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

FAQPage Schema
How do I validate a Claude plugin manifest before installation?▼

Plugin manifest validation checks your plugin.json for required fields, valid JSON syntax, and semantic versioning (x.y.z format). Run validation during release preparation or before installation to catch manifest errors, encoding issues, and structural problems that could cause installation failures.

What's the required directory structure for a Claude Code plugin?▼

Claude plugins require a plugin.json manifest at the root, plus subdirectories for agents (agents/*.md), skills (skills/*/SKILL.md), and commands (commands/*.md). Each file must have valid YAML frontmatter and proper Markdown formatting to pass structural compliance checks.

Can I use Claude plugins across different operating systems?▼

Yes, plugin validation ensures cross-platform compatibility by checking file path handling, UTF-8 encoding without BOM, and consistent line endings. Validation prevents OS-specific failures during installation and manifest updates.

What causes Claude plugin installation failures and how do I prevent them?▼

Installation failures typically stem from manifest errors, invalid JSON syntax, missing required fields, incorrect file encoding, or structural non-compliance. Pre-installation validation automatically detects these issues and provides troubleshooting steps before deployment.

Why does my plugin.json fail validation?▼

Common validation failures include missing required fields, invalid semantic versioning, malformed JSON, UTF-8 encoding with BOM, file size exceeding 1MB, or missing YAML frontmatter in agent, skill, and command files. Validation output identifies the specific error for quick remediation.

Do I need to validate plugins before publishing to Claude Code?▼

Yes, validation during release preparation ensures manifest integrity, semantic versioning compliance, proper directory structure, and encoding standards. Running comprehensive validation before publishing prevents installation failures and maintains compatibility across Claude Code versions.

Related Skills

Explore More Software Engineering Skills→
karchthokarchtho

agents-commands-creator

Create Claude Code agents and commands with YAML frontmatter and plugin.json references.

Community
Advanced
abhattacherjeeabhattacherjee
1

skill-publishing

Package, validate, and distribute Claude Code skills as plugins or monorepo components.

Community
Advanced
pradyumnasagarpradyumnasagar
6

release-management

Manages ORS skill releases with versioning, changelogs, and marketplace updates.

Community
Intermediate
acaprinoacaprino
6

obsidian-check

Validate Obsidian plugin code against quality and style rules.

Community
Advanced