Module skill 

Skills manager extension.

This module provides:

• Loading skills from a directory tree of SKILL.md files into SubAgent instances.
• Reading loaded skill files via the SkillManager tool.

Each SKILL.md follows the Agent Skills specification: YAML frontmatter (--- delimiters) with name, description, and optional license, compatibility, metadata, allowed-tools fields. The Markdown body becomes the agent’s instructions.

Skill names use kebab-case on disk (e.g. my-skill); they are normalised to snake_case (my_skill) when loaded as SubAgent instances.

Structs

Skill

A fully-parsed skill: frontmatter + body + derived fields.

SkillArgs

Arguments for reading a skill via the SkillManager tool.

SkillContentOutput

Content returned by the SkillManager tool.

SkillFrontmatter

YAML frontmatter of a SKILL.md file, following the Agent Skills spec.

SkillManager

Manages skills loaded from SKILL.md files on disk.

Functions

find_skill_files

Recursively find all SKILL.md files under dir.

format_skill_md

Format a Skill back into SKILL.md content.

load_skills_from_dir

Load all skills from a directory tree.

normalise_skill_agent_name

Normalise a kebab-case skill name to snake_case for the SubAgent registry.

parse_skill_md

Parse a SKILL.md file content into a Skill.

validate_skill_name

Validate a skill name per the Agent Skills specification.