Skip to main content

Module skill

Module skill 

Source
Expand description

Skill definitions: a directory containing a SKILL.md with YAML frontmatter and a Markdown body. This module loads them and validates them, powering the skilltest validate subcommand.

Structs§

Finding
A single validation problem found in a skill definition.
Frontmatter
The YAML frontmatter at the top of a SKILL.md. Only name and description are required; unknown keys are allowed so authors can carry extra metadata.
SkillDefinition
A loaded skill: where it lives, its parsed frontmatter, and its instruction body (everything after the frontmatter), which is what we hand to a provider when running the skill.

Functions§

load_skill
Load a skill definition from a directory containing SKILL.md.
validate_path
Validate either a single skill directory or a folder containing skill directories. A directory is treated as a skill if it directly contains a SKILL.md; otherwise its immediate subdirectories are validated.
validate_skill
Validate a single skill directory, returning any findings. An empty vec means the skill is valid. This never errors on a bad skill — invalidity is reported as findings; it only errors if the directory is unreadable.