Enum SkillError 

pub enum SkillError {
    Io {
        path: PathBuf,
        source: Error,
    },
    MissingFrontmatter {
        path: PathBuf,
    },
    InvalidFrontmatter {
        path: PathBuf,
        message: String,
    },
    MissingRequiredField {
        path: PathBuf,
        field: &'static str,
    },
    SkillTooLarge {
        path: PathBuf,
        bytes: usize,
        limit: usize,
    },
    PathNotFound {
        raw: String,
        resolved: PathBuf,
    },
    BundledSkillInvalid {
        name: &'static str,
        message: String,
    },
    Manifest {
        path: PathBuf,
        message: String,
    },
}

Errors surfaced during skill loading + resolution. Variants are kept distinct so downstream binaries (and the future skills-lint CLI) can report locations and surface fixes precisely.

Variants

Io

Filesystem error reading the skill file.

Fields

path: PathBuf

source: Error

MissingFrontmatter

Missing or malformed frontmatter delimiters.

Fields

path: PathBuf

InvalidFrontmatter

Frontmatter present but invalid YAML.

Fields

path: PathBuf

message: String

MissingRequiredField

Required frontmatter field missing (name or description).

Fields

path: PathBuf

field: &'static str

SkillTooLarge

Skill body exceeds the hard size limit (16 KB by default).

Fields

path: PathBuf

bytes: usize

limit: usize

PathNotFound

Path declared in the manifest’s skills: list doesn’t exist or isn’t a directory.

Fields

raw: String

resolved: PathBuf

BundledSkillInvalid

Compile-time bundled skill (added via add_bundled) failed to parse. This is a framework-author or downstream-binary-author bug — the bundled skill files should round-trip through their own CI tests before shipping.

Fields

name: &'static str

message: String

Manifest

Manifest YAML at path failed to load while resolving skills from a manifest (e.g. via Registry::from_manifest).

Fields

path: PathBuf

message: String

Trait Implementations

impl Debug for SkillError

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

Formats the value using the given formatter.

impl Display for SkillError

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

Formats the value using the given formatter.

impl Error for SkillError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.