dev:validate

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.

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.

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.

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.

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.

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.