What does the plugin validation check specifically?

It verifies that marketplace.json follows the JSON schema, source paths exist, SKILL.md has valid kebab-case naming and descriptions, and ensures no orphaned directories exist.

Can I use this for plugins outside the interstate-skills repo?

While optimized for the interstate-skills structure, its validation logic serves as a best-practice template for any Claude Code plugin architecture.

How does the hook audit prevent silent failures?

It scans shell scripts for commands like mkdir or cp without error handling (unless set -e is used) and flags Python scripts using generic 'except: pass' blocks.

How do I scaffold a new plugin using these tools?

The skill facilitates the development process and works alongside the '/plugin-dev:create' command for interactive plugin scaffolding.

What runtimes are required for these tools?

The validation script requires Bun for execution, while the hook audit tool utilizes standard Bash and Python environments.

Plugin Development & Validation Tools

Name: Plugin Development & Validation Tools
Author: rube-de

byrube-de

•

Seguridad y Pruebas

Validates Claude Code plugin structures and audits hook scripts to prevent silent failures and ensure schema compliance.

This skill provides a comprehensive suite of development tools designed specifically for maintaining the quality and reliability of Claude Code plugins within the interstate-skills ecosystem. It automates the validation of SKILL.md frontmatter, checks marketplace JSON schemas for consistency, and performs deep audits of shell and Python hook scripts to identify unhandled errors or silent failures. By enforcing standardized naming conventions and robust error-handling patterns, it ensures that your agent skills are production-ready, well-documented, and free from common integration bugs.

Características Principales

01SKILL.md frontmatter linting for naming and description standards

02Python exception audit for dangerous bare 'except: pass' blocks

03Orphan directory detection and plugin source path verification

04Automated JSON Schema validation for marketplace registries

05Static analysis of shell scripts for missing error handling (set -e)

061 GitHub stars

Casos de Uso

01Auditing legacy hook scripts for potential silent runtime failures

02Ensuring consistency in SKILL.md metadata across a large plugin collection

03Validating new plugins before submitting to the interstate-skills marketplace

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rube-de/interstate-skills plugin-dev

For use in Claude.ai and ChatGPT

Download Skill