Module skill 

Agent Skills SKILL.md front-matter validation.

This module implements the metadata constraints from the Agent Skills specification plus explicitly modeled, common client extensions. It parses only the YAML front matter; Markdown body content is intentionally left unrestricted.

Structs

SkillAsset

A bundled auxiliary file installed alongside SKILL.md under the skill directory — for example a references/ document a skill points its agent to.

SkillError

A skill admin failure with an operator-facing message and optional hint.

SkillMetadata

Validated Agent Skill metadata.

SkillOptions

Options shared by every skill action.

SkillSpec

Identity of the skill being managed and the tool that manages it.

SkillTargetStatus

Per-target outcome of status / install.

SkillUninstallStatus

Per-target outcome of uninstall.

SkillValidationError

A deterministic SKILL.md validation failure.

Enums

SkillAction

The skill action to perform.

SkillAgent

A concrete agent a skill is installed for (no All).

SkillAgentSelection

Which agent target(s) to manage.

SkillReport

The result of a skill action. Serializes to the protocol shape, carrying a code discriminator (skill_status / skill_install / skill_uninstall).

SkillScope

Where to install the skill.

Functions

run_skill_admin

Install, uninstall, or report status of spec’s skill across the selected agent target(s).

validate_skill

Validate one SKILL.md document and return its typed metadata.

validate_skill_named

Validate one SKILL.md document and require its name to match its directory.