valid-skill

Validate SKILL.md frontmatter and extract metadata for Skill discovery.

4|2|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/nick-orton/vybz --skill valid-skill-nick-orton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: valid-skill
Source: https://github.com/nick-orton/vybz/tree/main/tests/fixtures/skills_v2/valid-skill
Command: npx skills add https://github.com/nick-orton/vybz --skill valid-skill-nick-orton

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill unit provides a minimal, compliant structure to prove the discovery and parsing workflow for Skill units. It ensures that a SKILL.md exists at the root with a valid YAML frontmatter containing a name and description, enabling consistent indexing and tooling.

Core Features & Use Cases

  • Validates the existence of SKILL.md at the root and enforcement of required frontmatter fields (name, description).
  • Enables metadata extraction for indexing, search, and automated checks in workflows.
  • Serves as a lightweight example for testing resource discovery pipelines and documentation workflows.

Quick Start

Validate the Skill directory by ensuring a properly formed SKILL.md with the required fields is present and report the discovered metadata.

Frequently Asked Questions about valid-skill

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

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

To validate YAML frontmatter, the Skill locates the SKILL.md file at the root and checks for required name and description fields, ensuring your metadata is properly structured for indexing workflows.

What makes a Skill unit discoverable for search and indexing?

A Skill unit is discoverable when its SKILL.md contains valid YAML frontmatter with name and description fields, plus optional metadata like tagline, keywords, category, and components for automated extraction.

How do I check for toxic patterns and forbidden actions in Skill metadata?

You can check for toxic patterns by applying the Skill's built-in safety validation, which scans frontmatter and metadata to identify forbidden actions before a Skill unit is indexed or deployed.

Can I use this Skill for testing resource discovery pipelines?

Yes, you can use this Skill for testing resource discovery pipelines, as it serves as a lightweight, compliant unit to prove parsing workflows and metadata extraction for automated checks.

Do I need dependencies to validate SKILL.md frontmatter?

No dependencies are required to validate SKILL.md frontmatter, as the Skill operates independently to locate files and enforce required YAML fields for resource discovery.

Why does my Skill metadata fail validation during indexing?

Skill metadata fails validation during indexing if the SKILL.md file is missing from the root directory or lacks the required name and description fields in its YAML frontmatter.