valid-skill

Validate SKILL.md frontmatter and markdown body for Skill discovery.

1|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/vh2224/forge-executor --skill valid-skill-vh2224
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: valid-skill
Source: https://github.com/vh2224/forge-executor/tree/main/packages/pi-coding-agent/test/fixtures/skills/valid-skill
Command: npx skills add https://github.com/vh2224/forge-executor --skill valid-skill-vh2224

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It provides a minimal example of a correctly structured Skill unit for validating Skill discovery and metadata parsing.

Core Features & Use Cases

  • Schema compliance: Demonstrates the required Skill.md frontmatter fields and markdown body structure.
  • Discovery testing: Useful for checking that tooling correctly identifies valid skill directories.
  • Metadata validation: Helps verify downstream processing of name, description, and content fields.

Quick Start

Ask the assistant to inspect this skill fixture and confirm that it is a valid Skill unit.

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 metadata frontmatter for a SKILL.md file?

Skill metadata validation checks SKILL.md files for required name and description frontmatter fields to satisfy the Skill unit definition. This ensures repository tooling correctly parses and processes the metadata.

What is a minimal skill unit fixture used for in schema compliance?

A minimal skill unit fixture provides a correctly structured SKILL.md example for testing schema compliance. It verifies directory scanning tools correctly identify and extract required frontmatter and markdown bodies.

How do I test repository tooling for skill discovery and directory scanning?

You test repository tooling by applying it to a valid skill fixture directory. This checks whether the scanning logic correctly identifies SKILL.md files and parses the required name and description frontmatter fields.

Does my SKILL.md file need specific frontmatter fields to pass metadata parsing?

Yes, your SKILL.md file requires correct name and description frontmatter fields along with a markdown body to pass metadata parsing and satisfy the Skill unit definition.

When do I need a valid skill fixture to verify downstream processing?

You need a valid skill fixture when verifying downstream processing of name, description, and content fields. It ensures repository tooling correctly identifies valid skill directories and extracts the expected metadata structure.