What is the difference between a hook and a utility script in this context?

Hooks are primary entry points that MUST emit to stderr on failure. Utility scripts are internal helpers where fallback behavior may be acceptable, though stderr is still encouraged.

Can this skill automatically fix my plugin code?

Yes, using the --fix flag allows the script to suggest and apply improved code patterns that replace silent failures with descriptive error messages.

Which file types does the validator support?

The validator supports structure and manifest checks for JSON files, and logic auditing for Bash (.sh) and Python (.py) scripts located in the hooks or scripts directories.

Why is silent failure prevention important for Claude Code skills?

Claude Code plugins must emit errors to stderr so the AI agent can perceive the failure and attempt a correction. Silent failures leave the agent and user without context, causing broken workflows.

Plugin Validator

Name: Plugin Validator
Author: terrylica

byterrylica

•

安全与测试

Ensures Claude Code marketplace plugins are robust by validating directory structures, manifest files, and preventing silent failures in hook scripts.

关于

Plugin Validator is a specialized tool designed for developers building Claude Code marketplace extensions. It automates the rigorous verification of plugin manifests (plugin.json) and audits hook entry points to ensure they adhere to strict error-reporting standards. By scanning for silent failure patterns in Bash and Python scripts—such as unhandled exceptions or quiet command failures—it guarantees that plugins fail loudly and descriptively, providing a better debugging experience and more reliable automation workflows.

主要功能

Silent Failure Audit: Scans hook scripts for risky patterns like 'except: pass' or unchecked shell commands.
Multi-Language Linting: Integrates Shellcheck and Python pattern matching to ensure cross-language reliability.
Automated Fix Suggestions: Provides a --fix flag to automatically patch common silent failure patterns with proper stderr emission.
8 GitHub stars
Manifest Schema Validation: Verifies required fields and valid JSON syntax in plugin.json files.
Entry Point Verification: Distinguishes between critical hook scripts and utility scripts to apply appropriate error handling rules.

使用场景

Automating quality assurance checks within a plugin development CI/CD pipeline.
Pre-release testing of new Claude Code plugins to ensure marketplace compatibility and reliability.
Refactoring legacy shell scripts to ensure all failures are properly reported to the agent's stderr.

关于

主要功能

Silent Failure Audit: Scans hook scripts for risky patterns like 'except: pass' or unchecked shell commands.
Multi-Language Linting: Integrates Shellcheck and Python pattern matching to ensure cross-language reliability.
Automated Fix Suggestions: Provides a --fix flag to automatically patch common silent failure patterns with proper stderr emission.
8 GitHub stars
Manifest Schema Validation: Verifies required fields and valid JSON syntax in plugin.json files.
Entry Point Verification: Distinguishes between critical hook scripts and utility scripts to apply appropriate error handling rules.

使用场景

Automating quality assurance checks within a plugin development CI/CD pipeline.
Pre-release testing of new Claude Code plugins to ensure marketplace compatibility and reliability.
Refactoring legacy shell scripts to ensure all failures are properly reported to the agent's stderr.