valid-skill

Validate SKILL.md frontmatter structure and Markdown body presence.

3|Updated Dec 27, 2025
One-click install
npx skills add https://github.com/princespaghetti/skset --skill valid-skill-princespaghetti
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: valid-skill
Source: https://github.com/princespaghetti/skset/tree/main/test/fixtures/valid-skill
Command: npx skills add https://github.com/princespaghetti/skset --skill valid-skill-princespaghetti

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a lightweight, verifiable unit to test the Skill Unit discovery and validation pipelines by ensuring the required frontmatter is present and well-formed.

Core Features & Use Cases

  • Frontmatter validation: checks that the SKILL.md entry point contains a name and description.
  • Structural integrity: ensures the body is present and ready for operational instructions.
  • Discovery readiness: helps teams validate new Skill Units before publishing to the library.

Quick Start

Run a validation pass on this skill unit to ensure SKILL.md frontmatter is present and the description is well-formed. Example: skset validate test/fixtures/valid-skill

Frequently Asked Questions about valid-skill

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

FAQPage Schema
How do I validate SKILL.md frontmatter before publishing to a library?

To validate SKILL.md frontmatter, run a validation pass that parses the YAML to ensure required fields like name and description are present. This lightweight process checks structural integrity without external dependencies.

What is YAML frontmatter validation for markdown files?

YAML frontmatter validation is the process of parsing markdown headers to verify required metadata fields exist and are well-formed. It ensures structural correctness by checking for essential properties like name and description.

How do I check if a skill unit has the required markdown body and metadata?

You can check a skill unit by running a validation pass that parses both the YAML frontmatter and the markdown body. This confirms the required metadata is present and the operational instructions body is not empty.

Can I validate skill unit metadata without installing external dependencies?

Yes, you can validate skill unit metadata without external dependencies by using a lightweight parser that processes minimal YAML frontmatter and markdown body text directly, requiring no additional packages or libraries.

Why does skill unit discovery fail when frontmatter is missing?

Skill unit discovery fails when frontmatter is missing because the validation pipeline cannot locate the required name and description fields in the SKILL.md file, preventing the unit from being indexed in the library.

What's the best way to test a skill unit discovery pipeline?

The best way to test a skill unit discovery pipeline is to run a validation pass on a ready-to-use test fixture, ensuring the SKILL.md entry point contains well-formed frontmatter and a present markdown body.