skill-test

Validate YAML frontmatter, phase structure, and procedural hints in SKILL.md files.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill skill-test-polsegu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-test
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/skill-test
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill skill-test-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structural and behavioral compliance checks for Claude Skill Units, ensuring skills meet the required frontmatter fields, phase structure, and handoff protocols.

Core Features & Use Cases

  • Validates YAML frontmatter (name, description, argument-hint, user-invocable, allowed-tools)
  • Checks multi-phase structure and required sections across skills
  • Generates actionable reports and recommended follow-ups for improvements
  • Supports static, spec, category, and audit modes for comprehensive validation

Quick Start

Run a repository-wide static lint with /skill-test static all to validate structural compliance across the repository.

Frequently Asked Questions about skill-test

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

FAQPage Schema
How do I validate YAML frontmatter in SKILL.md files?

To validate YAML frontmatter in SKILL.md files, use the static lint mode to check required fields like name, description, argument-hint, user-invocable, and allowed-tools. Running a repository-wide static lint ensures structural compliance across all skill definitions.

What is the best way to audit Claude skill definitions for compliance?

The best way to audit Claude skill definitions is to run an audit mode evaluation that checks phase structure and procedural hints. This generates actionable compliance reports and recommended handoff follow-ups for improvements.

Do I need external dependencies to run static analysis on skill definitions?

No external dependencies are required to run static analysis on skill definitions. The validation tooling uses built-in capabilities and the catalog to check YAML frontmatter and phase structure without installing additional packages.

How do I check the multi-phase structure of my skills?

To check the multi-phase structure of your skills, execute a spec or category mode evaluation. This validates required sections and procedural hints across your skills, ensuring behavioral compliance with handoff protocols.

Why does my skill definition fail the handoff protocol validation?

Skill definition handoff protocol validation fails when required procedural hints or phase sections are missing. The compliance report identifies these structural gaps and provides actionable recommendations to fix the skill definition.

Can I generate compliance reports for multiple skills at once?

Yes, you can generate compliance reports for multiple skills at once by running a repository-wide static lint. This evaluates all skills in the directory and outputs a comprehensive compliance report with handoff recommendations.