BrokenSkill

Validate SKILL.md frontmatter and structure in skill directories.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hamza-sahin/pawbalance --skill brokenskill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: BrokenSkill
Source: https://github.com/hamza-sahin/pawbalance/tree/main/.claude/skills/skill-creator/fixtures/broken-skill
Command: npx skills add https://github.com/hamza-sahin/pawbalance --skill brokenskill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps identify and fix issues in draft Skill units by validating the presence and correctness of SKILL.md frontmatter and basic structure.

Core Features & Use Cases

  • Frontmatter validation: ensures required fields like name and description exist and are accurately formatted.
  • Structural checks: detects missing sections, invalid formatting, and suggests remediation steps.
  • Rapid remediation: provides actionable steps to repair drafts and regenerate a valid Skill Unit.

Quick Start

Provide a clean, working draft of a Skill unit by running a validation pass on the current directory.

Frequently Asked Questions about BrokenSkill

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

FAQPage Schema
How do I validate SKILL.md frontmatter and fix broken skill drafts?▼

To validate SKILL.md frontmatter and fix broken skill drafts, run a validation pass on your skill directory to check that required fields like name and description exist, then follow the suggested remediation steps to correct invalid formats.

What is frontmatter validation for skill units?▼

Frontmatter validation for skill units is the process of ensuring required YAML fields like name and description exist and are accurately formatted at the top of a SKILL.md file before publishing.

Why does my skill draft have missing sections or invalid formatting?▼

Your skill draft has missing sections or invalid formatting because it lacks required structural elements or correctly formatted YAML frontmatter, which can be detected by running a structural validation pass on the directory.

Can I use quality assurance checks to correct YAML frontmatter in skill directories?▼

Yes, you can use quality assurance checks to correct YAML frontmatter in skill directories by analyzing the SKILL.md file to flag missing fields and generate actionable remediation steps for repair.

Do I need a SKILL.md file to run documentation quality assurance checks?▼

Yes, you need a SKILL.md file within your skill directory to run documentation quality assurance checks, as the validation scope specifically targets frontmatter and basic structural elements of this file.