plugin-validator

Validate Bosun plugin manifests, agents, skills, and cross-component references.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/curphey/bosun --skill plugin-validator-curphey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-validator
Source: https://github.com/curphey/bosun/tree/main/skills/plugin-validator
Command: npx skills add https://github.com/curphey/bosun --skill plugin-validator-curphey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Plugin Validator ensures the Bosun plugin can be trusted by validating the manifest, agents, skills, and commands, and by checking cross-component references before release or major changes.

Core Features & Use Cases

  • Phase-based validation of the manifest, agents, skills, and commands to detect missing references and configuration errors.
  • Cross-component consistency checks to ensure skills are correctly mapped to their agents and that no components are orphaned.
  • Guidance for release readiness, onboarding, and ongoing codebase health checks.

Quick Start

Run the plugin-validator to validate the full Bosun plugin against manifest, agents, skills, and cross-references.

Frequently Asked Questions about plugin-validator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a Bosun plugin manifest before release?

To validate a Bosun plugin manifest before release, run a full validation check to confirm plugin.json correctness, verify agent and skill frontmatter, and detect missing references or misconfigurations across all components for remediation.

What causes orphaned components in a Bosun plugin ecosystem?

Orphaned components in a Bosun plugin ecosystem occur when skills lack correct mappings to their parent agents. Cross-component consistency checks identify these broken inter-component references and report them for remediation.

How do I check cross-component references in Bosun agents and skills?

Cross-component reference checks in Bosun agents and skills confirm that all required frontmatter exists and inter-component mappings are correct. This phase-based validation detects missing references and configuration errors during audits.

Do I need a valid plugin.json to run Bosun plugin validation?

Yes, a valid plugin.json is an enforced requirement for Bosun plugin validation. The validator checks manifest correctness alongside agent and skill frontmatter to ensure cross-component consistency and release readiness.

What is the best way to audit Bosun plugin codebase health?

The best way to audit Bosun plugin codebase health is running end-to-end validation across the manifest, agents, skills, and commands. This ongoing quality audit detects missing references, misconfigurations, and orphaned components.