thulp-skill-files

SKILL.md file parsing and loading for the Thulp execution context platform.

Features

• SKILL.md Parsing: Parse skill files with YAML frontmatter and markdown content
• Preprocessor: Handle $ARGUMENTS, !command``, {{variable}}, and `${ENV_VAR}` substitutions
• Skill Loader: Discover skills from multiple directories with scope-based priority
• Tool Restrictions: Support for allowed-tools to sandbox skill execution

Installation

Add to your Cargo.toml:

[dependencies]
thulp-skill-files = { path = "../thulp-skill-files" }

Quick Start

Parsing a Skill File

use thulp_skill_files::SkillFile;

let skill = SkillFile::parse("path/to/SKILL.md")?;
println!("Name: {}", skill.effective_name());
println!("Description: {}", skill.effective_description());

Loading Skills from Directories

use thulp_skill_files::{SkillLoader, SkillLoaderConfig};

let config = SkillLoaderConfig::default();
let loader = SkillLoader::new(config);
let skills = loader.load_all()?;

for skill in &skills {
    println!("{} ({})", skill.qualified_name(), skill.scope);
}

Preprocessing Skill Content

use thulp_skill_files::SkillPreprocessor;
use std::collections::HashMap;

let pp = SkillPreprocessor::new();
let mut context = HashMap::new();
context.insert("project".to_string(), serde_json::json!("myapp"));

let content = "Process $ARGUMENTS for {{project}}";
let processed = pp.preprocess(content, "file.txt", &context)?;
// Result: "Process file.txt for myapp"

SKILL.md Format

---
name: my-skill
description: Does something useful
allowed-tools:
  - Read
  - Write
  - Bash
disable-model-invocation: false
user-invocable: true
context: inline
requires-approval: false
tags:
  - utility
  - files
---
# Instructions

When invoked with $ARGUMENTS, do the following:

1. Read the specified file
2. Process the contents
3. Write the results

Frontmatter Fields

Scope Priority

Skills are loaded from multiple directories with priority resolution:

1. Enterprise (highest) - Organization-wide skills
2. Personal - User's personal skills (~/.claude/skills/)
3. Project (lowest) - Project-specific skills (./.claude/skills/)
4. Plugin - Namespaced, no conflicts

When multiple skills have the same name, higher scope wins.

Preprocessor Substitutions

License

MIT OR Apache-2.0