Crate turboclaude_skills 

TurboClaude Skills

Skills support for TurboClaude - modular, self-describing capability packages for Claude agents.

Overview

Skills are directories containing a SKILL.md file that provides:

• Metadata (name, description, license, etc.)
• Knowledge and instructions (Markdown body)
• Optional references (additional documentation)
• Optional scripts (Python/Bash utilities)
• Optional assets (templates, fonts, etc.)

Quick Start

use turboclaude_skills::{Skill, SkillRegistry};
use std::path::PathBuf;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Load a single skill
    let skill = Skill::from_file("skills/my-skill/SKILL.md").await?;
    println!("Loaded: {} - {}", skill.metadata.name, skill.metadata.description);

    // Or use a registry for discovery
    let mut registry = SkillRegistry::builder()
        .skill_dir(PathBuf::from("./skills"))
        .build()?;

    registry.discover().await?;
    let skills = registry.list().await;
    println!("Discovered {} skills", skills.len());

    Ok(())
}

Features

• Local Skills: Load skills from filesystem directories
• Discovery: Automatic skill discovery via directory scanning
• Validation: Strict validation of SKILL.md format and metadata
• Lazy Loading: References and scripts loaded on-demand
• Semantic Matching: Find skills by description keywords
• Agent Integration: Easy integration with turboclaudeagent

SKILL.md Format

---
name: skill-name
description: What the skill does and when to use it
license: MIT
allowed-tools:
  - bash
  - read
metadata:
  custom: value
---

# Markdown Body

Instructions and documentation here...

Re-exports

pub use executor::BashExecutor;

pub use executor::CompositeExecutor;

pub use executor::PythonExecutor;

pub use executor::ScriptExecutor;

pub use executor::ScriptOutput;

pub use matcher::KeywordMatcher;

pub use matcher::SkillMatcher;

pub use registry::SkillRegistry;

pub use registry::SkillRegistryBuilder;

Modules

executor

Script execution for skills

matcher

Semantic matching for skill discovery

prelude

Prelude module for convenient imports

registry

Skill registry for discovery and management

Structs

Reference

A reference document within a skill

Skill

A skill loaded from a SKILL.md file

SkillMetadata

Metadata from the YAML frontmatter of a SKILL.md file

Enums

SkillError

Errors that can occur when working with skills

Type Aliases

Result

Result type for skill operations