skills-ref-rs

Rust implementation of agentskills for validating, parsing, and managing Agent Skills.

Installation

As a CLI tool

cargo install skills-ref-rs

This installs the skills-ref command.

As a library

cargo add skills-ref-rs

CLI Usage

# Validate a skill directory
skills-ref validate ./my-skill

# Read properties as JSON
skills-ref read-properties ./my-skill

# Generate XML prompt block
skills-ref to-prompt ./skill-a ./skill-b

Library Usage

use skills_ref::{validate, read_properties, to_prompt};
use std::path::Path;

// Validate
let errors = validate(Path::new("my-skill"));
assert!(errors.is_empty());

// Read properties
let props = read_properties(Path::new("my-skill")).unwrap();
println!("{}: {}", props.name, props.description);

// Generate prompt
let xml = to_prompt(&[Path::new("my-skill")]).unwrap();

Validation Rules

• name: required, lowercase kebab-case, max 64 chars, must match directory name
• description: required, max 1024 chars
• compatibility: optional, max 500 chars
• Unicode names supported (NFKC normalized)

License

MIT