plugin-validator

Validate Claude Code plugin manifests, structure, frontmatter, and dependencies.

7|Updated Nov 23, 2025
One-click install
npx skills add https://github.com/poindexter12/waypoint --skill plugin-validator-poindexter12
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-validator
Source: https://github.com/poindexter12/waypoint/tree/main/claire/skills/plugin-validator
Command: npx skills add https://github.com/poindexter12/waypoint --skill plugin-validator-poindexter12

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code plugins can suffer from misconfigurations, broken manifests, and inconsistent structures; this skill provides a comprehensive validation pass to detect and surface issues early.

Core Features & Use Cases

  • Manifest validation: ensure plugin.json exists, is valid JSON, and contains required fields.
  • Structure validation: verify referenced files exist, paths are relative, and directory conventions are followed.
  • Frontmatter validation: check YAML frontmatter in agents/commands and SKILL.md presence (if applicable) for required fields.
  • Dependency validation: detect circular references and ensure skill/agent references resolve.
  • Reporting & remediation: provide actionable guidance and recommended fixes.

Quick Start

Validate a plugin directory to surface manifest, structure, and dependency issues.

Frequently Asked Questions about plugin-validator

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

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

To validate Claude Code plugin structure, this skill checks the plugin.json manifest, internal file references, and directory conventions to detect misconfigurations and broken paths. It applies comprehensive checks across manifest, structure, frontmatter, and dependencies to surface issues early.

What does YAML frontmatter validation check for in plugin commands?

YAML frontmatter validation checks agents and commands for required fields and verifies SKILL.md presence where applicable. It enforces frontmatter rules to prevent common configuration failures in Claude Code plugins.

Can I detect circular references and broken dependencies in Claude Code plugins?

Yes, you can detect circular references and broken dependencies in Claude Code plugins using dependency validation. This skill ensures all skill and agent references resolve correctly and reports any circular dependencies found.

What's the best way to fix broken plugin.json manifests?

The best way to fix broken plugin.json manifests is to run a validation pass that reports actionable guidance and recommended fixes. This skill verifies that plugin.json exists, contains valid JSON, and includes all required fields.

Why does my Claude Code plugin fail to load due to missing internal references?

Claude Code plugins fail to load when internal references point to non-existent files or use incorrect paths. Structure validation verifies that all referenced files exist, paths are relative, and directory conventions are followed.