Function parse_skill_file 

pub fn parse_skill_file(content: &str) -> Result<Skill>

Parse a skill file content into frontmatter and body.

The file format is:

---
name: skill-name
description: Optional description
tools: [tool1, tool2]
---

# Markdown content here

This becomes the system prompt.

Compatibility

This parser supports multiple skill file formats:

• Claude Code: Standard YAML frontmatter + markdown body
• Cursor: Similar format, may use title instead of name
• Amp: May include system_prompt or instructions in frontmatter
• Codex: May use id instead of name

Errors

Returns an error if:

• The file doesn’t start with ---
• The YAML frontmatter is invalid
• Required fields are missing (must have name, id, or title)