skillrt 0.1.0

A runtime and spec for executable markdown skills consumed by AI agents.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

//! The top-level Skill type.

use crate::frontmatter::Frontmatter;

/// What kind of content this skill carries.
///
/// The runtime can consume both; prose skills are shown to the agent as
/// reference material (Soapstones-style), structured skills are invoked
/// with inputs and return a typed output.
#[derive(Debug, Clone)]
pub enum SkillKind {
    /// Free-form markdown, no frontmatter. Interpreted by the agent.
    /// Compatible with Cal Paterson's Soapstones format.
    Prose,

    /// Typed, executable skill with frontmatter metadata.
    Structured,
}

#[derive(Debug, Clone)]
pub struct Skill {
    pub kind: SkillKind,
    pub frontmatter: Option<Frontmatter>,
    pub body: SkillBody,
    pub source_path: Option<std::path::PathBuf>,
}

#[derive(Debug, Clone)]
pub struct SkillBody {
    /// The raw markdown body (everything after frontmatter).
    pub markdown: String,
}