What does the PopKit Validation Engine check?

It audits the entire plugin structure, including agent definitions, skill frontmatter consistency, hook files, and routing configurations to ensure the plugin operates correctly.

Can I use this in my CI/CD pipeline?

Absolutely. By using the --json flag, you can programmatically parse validation reports to block deployments if the plugin health score falls below a certain threshold.

Is it safe to use the auto-fix feature?

Yes, the 'apply' mode is restricted to safe structural changes like adding missing frontmatter or registering orphaned agents; it never modifies code logic or deletes files.

How is the Plugin Health Score calculated?

The engine starts at a 100-point score and applies deductions based on issue severity: critical errors (missing files), high-priority errors (invalid JSON), and warnings (naming inconsistencies).

PopKit Validation Engine

Name: PopKit Validation Engine
Author: jrc1883

byjrc1883

•

安全与测试

Validates Claude Code plugin integrity and applies safe automatic fixes for structure, agents, and skill configurations.

The PopKit Validation Engine is a diagnostic and repair utility designed to maintain the structural integrity of Claude Code plugins. It performs deep audits of agents, skills, hooks, and routing configurations to ensure every component of your AI workflow automation is correctly defined and linked. By providing a comprehensive health score and categorized issue reporting, it helps developers identify critical errors before release. The engine includes a safe auto-fix capability that can instantly repair common metadata issues, register orphaned agents, and normalize frontmatter, making it an essential tool for both local development and automated CI/CD pipelines.

主要功能

015 GitHub stars

02Comprehensive integrity auditing for agents, skills, and hooks

03Safe auto-fix functionality for common structural and metadata issues

04Automated health scoring and grading system for plugin quality

05Validation of routing configurations and naming consistency

06Detailed CLI reporting with JSON output support for CI/CD integration

使用场景

01Verifying plugin structure and configuration before a production release

02Synchronizing and fixing agent registration after adding new features

03Integrating automated quality gates into GitHub Actions or CI/CD pipelines

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jrc1883/popkit-claude pop-validation-engine

For use in Claude.ai and ChatGPT

Download Skill