Expand description
SKILL.md parser and loader for Talos agent skills.
This crate discovers and parses SKILL.md files from configured search paths.
Each skill consists of YAML frontmatter (between --- delimiters) followed by
a Markdown body containing instructions.
§Discovery Paths
Skills are discovered from three locations (in priority order):
.talos/skills/— project-local skills~/.talos/skills/— user-global skills- Parent directories up to git root — inherited skills
Directory-link following is controlled by SkillDiscoveryPolicy.
By default links are not followed; external targets are denied.
Discovery is bounded by the configured maximum depth and entry budget.
§SKILL.md Format
---
name: my-skill
description: A skill that does something useful
triggers:
- keyword1
- keyword2
---
# Instructions
Detailed markdown instructions go here...Structs§
- Skill
- A fully parsed skill with frontmatter metadata and Markdown body.
- Skill
Discovery Policy - Skill
Discovery Warning - Skill
Frontmatter - YAML frontmatter extracted from a SKILL.md file.
- Skill
Index - Lightweight skill index entry for Level 0 progressive disclosure.
- Skill
Loader - Skill
Manager - Manages progressive disclosure of skills across three levels.
Enums§
- External
Target Policy - Skill
Disclosure - Disclosure level for progressive skill loading.
- Skill
Discovery Warning Kind - Skill
Error - Errors that can occur during skill loading.
- Skill
Source - Identifies where a skill was discovered.
Functions§
- estimate_
tokens - Estimates the token count for a given text.
Type Aliases§
- Result
- Result type alias for skill operations.