skills-ref-rs 0.1.0

Rust implementation of agentskills library for validating, parsing, and managing Agent Skills
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

//! Skill-related error types.

/// Base error type for all skill-related errors.
#[derive(Debug, thiserror::Error)]
pub enum SkillError {
    /// Raised when SKILL.md parsing fails.
    #[error("{0}")]
    Parse(String),

    /// Raised when skill properties are invalid.
    #[error("{message}")]
    Validation {
        message: String,
        errors: Vec<String>,
    },

    /// Raised when an I/O operation fails.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),
}

impl SkillError {
    /// Create a new parse error.
    pub fn parse(message: impl Into<String>) -> Self {
        Self::Parse(message.into())
    }

    /// Create a new validation error with a single message.
    pub fn validation(message: impl Into<String>) -> Self {
        let msg = message.into();
        Self::Validation {
            message: msg.clone(),
            errors: vec![msg],
        }
    }

    /// Create a new validation error with multiple error messages.
    pub fn validation_multiple(message: impl Into<String>, errors: Vec<String>) -> Self {
        Self::Validation {
            message: message.into(),
            errors,
        }
    }

    /// Get the list of validation errors, if this is a validation error.
    pub fn errors(&self) -> Option<&[String]> {
        match self {
            Self::Validation { errors, .. } => Some(errors),
            _ => None,
        }
    }
}

/// Result type alias for skill operations.
pub type Result<T> = std::result::Result<T, SkillError>;