Struct Frontmatter 

pub struct Frontmatter {
    pub name: String,
    pub description: String,
    pub category: Category,
    pub version: u32,
    pub compatibility: Option<String>,
    pub activation: Vec<String>,
    pub tools: Vec<String>,
    pub extra: BTreeMap<String, Value>,
}

Metadata extracted from the YAML frontmatter of a SKILL.md file.

Required fields are modelled as strongly-typed values; unknown fields are preserved in Self::extra so agent-specific extensions (custom activation rules, capability declarations, …) are not silently dropped.

Fields

name: String

Skill name. Must match the containing directory.

description: String

One-line description used by devboy skills list.

category: Category

Category that drives filtering and the install-layout path.

version: u32

Integer version bumped on every change.

compatibility: Option<String>

Optional semver range against the tool bundle (e.g. "devboy-tools >= 0.18").

activation: Vec<String>

Optional list of trigger phrases for agents that support activation-based skill invocation.

tools: Vec<String>

Optional list of tools the skill calls. Used by the future compatibility checker described in ADR-014.

extra: BTreeMap<String, Value>

Any frontmatter fields we did not explicitly model. Preserved so agent-specific keys survive a round-trip.

Trait Implementations

impl Clone for Frontmatter

fn clone(&self) -> Frontmatter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Frontmatter

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Frontmatter

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Frontmatter

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.