plugin-checker

The plugin-checker is an essential quality assurance tool for developers building extensions for Claude Code. It provides a structured methodology to audit plugin directories, verifying that they meet the rigorous requirements for manifests, directory structures, and file naming conventions necessary for proper integration. By automating the identification of common pitfalls such as invalid JSON syntax in plugin.json, mislocated component files, or non-compliant frontmatter in agents and skills, this tool significantly reduces troubleshooting time and ensures that plugins are production-ready.

• Validates .claude-plugin/plugin.json for JSON syntax, name field compliance (kebab-case), and required author metadata.

• Audits directory layouts to ensure agents, skills, commands, and hooks are correctly placed according to the marketplace specification.

• Performs deep-dive checks on YAML frontmatter in .md files to ensure required fields like name, description, and model/color/tool configurations are present and valid.

• Verifies hooks.json structure, ensuring event names like PreToolUse and SessionStart are correctly mapped to executable scripts.

• Enforces path portability by checking for usage of ${CLAUDE_PLUGIN_ROOT} and ensuring script executables have proper shebang headers.

• Detects common configuration anti-patterns such as hardcoded absolute paths, missing documentation requirements, and improper file nesting.

• Ideal for developers and repository maintainers working on Claude Code ecosystems.

• Recommended usage involves running the audit command before submitting plugins or updating existing project structures.

• Integrates easily into CI pipelines to automate structure validation and linting of plugin manifests.

• Helps troubleshoot common errors like plugin load failures, missing triggers, or silent hook malfunctions.

• Provides a clear reporting format to categorize findings into critical issues and warnings, facilitating rapid remediation of structural flaws.