skill-validator

Validate Bosun skill frontmatter, structure, and cross-references before release.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skills are Bosun's knowledge packages. Invalid skills break the plugin. This skill guides systematic validation of Bosun skills before they ship.

Core Features & Use Cases

  • Frontmatter validation: ensures required fields and proper frontmatter structure
  • Structure validation: checks for required sections (Overview, Red Flags, Checklist, Quick Commands/Patterns)
  • Reference validation: verifies that cited references exist and are properly linked
  • Use Case: Before releasing a new skill, run validation to catch missing fields or broken references and prevent a broken plugin

Quick Start

Run the validator on a skill's SKILL.md to verify frontmatter, structure, and references before release

Frequently Asked Questions about skill-validator

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

FAQPage Schema
How do I validate Bosun skill definitions before shipping?

Validate Bosun skill definitions by checking frontmatter for required fields, verifying structural sections like Overview and Checklist, and ensuring cross-references exist before release to prevent broken plugins.

What frontmatter fields are required for a Bosun skill?

Required frontmatter fields for a Bosun skill are enforced during validation to ensure compliance, while extraneous fields are forbidden to maintain strict structural quality and prevent plugin failures.

How do I check for broken references in Bosun skills?

Check for broken references in Bosun skills by running cross-reference validation that verifies cited references exist and are properly linked across skills before release.

What sections are required in a Bosun SKILL.md file?

A Bosun SKILL.md file requires specific structural sections including Overview, Red Flags, Checklist, and Quick Commands or Patterns to pass structure validation checks before shipping.

Why does my Bosun plugin break after adding a new skill?

Your Bosun plugin breaks when new skills have missing frontmatter fields or broken cross-references, which is why validating skill definitions to enforce required fields and verify links is necessary before release.