valid-minimal

Validate SKILL.md files for required name and description frontmatter.

1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/charleshall888/cortex-command --skill valid-minimal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: valid-minimal
Source: https://github.com/charleshall888/cortex-command/tree/main/tests/fixtures/contracts/valid-minimal
Command: npx skills add https://github.com/charleshall888/cortex-command --skill valid-minimal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Verifies that a Skill Unit can be discovered using only the required frontmatter fields (name and description) by providing a minimal example.

Core Features & Use Cases

  • Validates presence of required fields in SKILL.md.
  • Serves as baseline for discovery pipelines and tests.
  • Demonstrates that a body is optional for the Skill Unit to be considered valid.

Quick Start

Add this skill to your catalog and verify that the required fields check passes.

Frequently Asked Questions about valid-minimal

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

FAQPage Schema
How do I validate required frontmatter fields in SKILL.md for discovery?

To validate required frontmatter fields in SKILL.md, check that the name and description fields are present in the YAML frontmatter. This minimal validation ensures the Skill Unit can be discovered by automated pipelines.

What is the minimal requirement for a SKILL.md file to be considered valid?

The minimal requirement for a SKILL.md file to be valid is having a YAML frontmatter block containing non-empty name and description fields, plus a Markdown body with basic informational purpose, without enforcing inputs or outputs.

Does a Skill Unit require inputs and outputs defined in frontmatter to be discovered?

No, a Skill Unit does not require inputs or outputs defined in frontmatter for discovery. The minimal validation only checks for the presence of a name and description in the YAML frontmatter of the SKILL.md file.

How do I test a discovery pipeline for Skill Units using a minimal example?

You can test a discovery pipeline using a minimal Skill Unit that contains only the required YAML frontmatter fields, name and description, serving as a baseline to verify that your pipeline correctly identifies valid directories.

Is a Markdown body required in SKILL.md for the Skill Unit to pass minimal validation?

A Markdown body is not strictly required for the Skill Unit to be considered valid, but if present, it should contain non-empty informational content describing the basic purpose of the skill.