Validate a skill directory. Args: skill_dir: Path to the skill directory Returns: List of validation error messages. Empty l

Read skill properties from SKILL.md frontmatter. This function parses the frontmatter and returns properties. It does NOT perform full valida

Parse YAML frontmatter from SKILL.md content. Args: content: Raw content of SKILL.md file Returns: Tuple of (metadata dict,

Find the SKILL.md file in a skill directory. Prefers SKILL.md (uppercase) but accepts skill.md (lowercase). Args: skill_dir: Path to

Generate the <available_skills> XML block for inclusion in agent prompts. This XML format is what Anthropic uses and recommends for Claude models

Check if path points directly to a SKILL.md or skill.md file.

Convert to dictionary, excluding None values.

Validate compatibility format.

Validate description format.

Validate that only allowed fields are present.

Validate skill name format and directory match. Skill names support i18n characters (Unicode letters) plus hyphens. Names must be lowercase a

Reference library for Agent Skills.

Validate parsed skill metadata. This is the core validation function that works on already-parsed metadata, avoiding duplicate file I/O when

Read and print skill properties as JSON. Parses the YAML frontmatter from SKILL.md and outputs the properties as JSON. Exit codes:

allowed-tools is accepted (experimental feature).

Compatibility exceeding 500 chars should fail.

Description exceeding 1024 chars should fail.

skill.md should be accepted when SKILL.md doesn't exist.

SKILL.md should be preferred over skill.md when both exist.

find_skill_md should return None when no skill.md exists.

Chinese characters are allowed in skill names.

Russian lowercase names should be accepted.

Russian names with hyphens are allowed.

Russian uppercase names should be rejected.

Skill names are NFKC normalized before validation. The name 'café' can be represented two ways: - Precomposed: 'café' (4 chars, 'é' is U+00E9

read_properties should work with lowercase skill.md.

allowed-tools should be parsed into SkillProperties.

XML special characters in description are escaped.

Valid compatibility field should be accepted.

Generate <available_skills> XML for agent prompts. Accepts one or more skill directories. Exit codes: 0: Success 1: Error

Validate a skill directory. Checks that the skill has a valid SKILL.md with proper frontmatter, correct naming conventions, and required fiel