Struct Skill 

pub struct Skill { /* private fields */ }

A complete Agent Skill, combining frontmatter and markdown body.

This is the main type for working with skills. It can be loaded from a SKILL.md file or constructed programmatically.

Examples

use agent_skills::Skill;

// Parse from SKILL.md content
let content = r#"---
name: my-skill
description: Does something useful.
---

Follow these steps...
"#;

let skill = Skill::parse(content).unwrap();
assert_eq!(skill.name().as_str(), "my-skill");
assert!(skill.body().contains("# Instructions"));

Implementations

impl Skill

pub fn new(frontmatter: Frontmatter, body: impl Into<String>) -> Self

Creates a new skill with frontmatter and body.

Examples

use agent_skills::{Skill, Frontmatter, SkillName, SkillDescription};

let name = SkillName::new("my-skill").unwrap();
let desc = SkillDescription::new("Does something.").unwrap();
let frontmatter = Frontmatter::new(name, desc);

let skill = Skill::new(frontmatter, "# Instructions\n\nDo this.");

pub fn parse(content: &str) -> Result<Self, ParseError>

Parses a skill from SKILL.md content.

The content must start with --- (the YAML frontmatter delimiter), followed by valid YAML, another --- delimiter, and then the markdown body.

Errors

Returns ParseError if:

• The content doesn’t start with ---
• The YAML frontmatter is invalid
• Required fields are missing or invalid

Examples

use agent_skills::Skill;

let content = r#"---
name: my-skill
description: Does something useful.
---

Follow these steps...
"#;

let skill = Skill::parse(content).unwrap();
assert_eq!(skill.name().as_str(), "my-skill");

pub const fn name(&self) -> &SkillName

Returns the skill name.

pub const fn description(&self) -> &SkillDescription

Returns the skill description.

pub const fn frontmatter(&self) -> &Frontmatter

Returns the frontmatter.

pub fn body(&self) -> &str

Returns the markdown body (instructions).

pub fn body_trimmed(&self) -> &str

Returns the body trimmed of leading/trailing whitespace.

Trait Implementations

impl Clone for Skill

fn clone(&self) -> Skill

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Skill

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Skill

fn eq(&self, other: &Skill) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Skill

impl StructuralPartialEq for Skill