dev:validate

Validate Claude plugin versions, frontmatter, cross-references, Python syntax, and hooks.

43|5|Updated Mar 31, 2026

Search Tags:#python #validation #plugin #integrity #shell #ci #cross-references

Ready to run

npx skills add https://github.com/raphaelchristi/harness-evolver --skill dev-validate-raphaelchristi

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: dev:validate
Source: https://github.com/raphaelchristi/harness-evolver/tree/main/.claude/skills/dev-validate
Command: npx skills add https://github.com/raphaelchristi/harness-evolver --skill dev-validate-raphaelchristi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures a Claude plugin repository is consistent, complete, and release-ready by detecting mismatched versions, missing frontmatter, broken cross-references, Python syntax errors, and hook misconfigurations before they cause runtime failures.

Core Features & Use Cases

Version synchronization: Compares package.json and .claude-plugin/plugin.json to detect version drift.
Frontmatter and cross-reference validation: Verifies SKILL.md and agents/*.md frontmatter fields and that subagent_type references resolve to existing agents.
Python and hook checks: Parses Python tools for syntax errors and confirms hook scripts are present and executable, with JSON validation for hook metadata.
Use Case: Run as part of pre-release checks or CI to catch repository inconsistencies that would break agent deployments or automated testing.

Quick Start

Run the dev:validate skill to check versions, frontmatter fields, agent cross-references, Python tool syntax, and hook script validity before release.

Frequently Asked Questions about dev:validate

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

FAQPage Schema

How do I validate plugin integrity and cross-references in a Claude plugin repository?▼

To validate plugin integrity, run a check that compares package.json and plugin.json versions, verifies SKILL.md frontmatter, confirms subagent_type references resolve, and checks Python tool syntax before release.

What is plugin version drift and how do I detect it before a release?▼

Plugin version drift occurs when package.json and .claude-plugin/plugin.json versions mismatch. You detect it by running a validation check that compares these files to ensure version synchronization across the repository.

How do I check Python syntax errors and hook configurations in an LLM agent toolchain?▼

You check Python syntax errors and hook configurations by parsing Python tool files for syntax validity and confirming hook scripts are present, executable, and have valid JSON metadata during repository health checks.

Can I run cross-reference validation for agent files in a CI pipeline?▼

Yes, you can run cross-reference validation in CI pipelines. The validation checks agents/*.md frontmatter and verifies that subagent_type references resolve to existing agents to prevent deployment failures.

What files do I need to provide access to for plugin repository health checks?▼

You need shell access with Python3 and read access to package.json, .claude-plugin/plugin.json, skills/*/SKILL.md, agents/*.md, tools/*.py, and hooks to perform version sync, frontmatter, syntax, and cross-reference checks.

Why do my agent deployments fail due to broken cross-references in SKILL.md files?▼

Agent deployments fail when SKILL.md frontmatter is missing or subagent_type references do not resolve to existing agents. Running validation checks detects these broken cross-references before they cause runtime failures.