aigent

A Rust library, CLI, and Claude Code plugin for managing AI agent skill definitions (SKILL.md files). Implements the Anthropic agent skill specification with validation, prompt generation, and skill building.

Installation

# From crates.io
cargo install aigent

# From source
cargo install --path .

Quick Start

# Initialize a new skill
aigent init my-skill/

# Build a skill from a description
aigent build "Process PDF files and extract text" --no-llm

# Validate a skill directory
aigent validate my-skill/

# Read skill properties as JSON
aigent read-properties my-skill/

# Generate XML prompt for LLM injection
aigent to-prompt my-skill/ other-skill/

Library Usage

use std::path::Path;

// Validate a skill directory
let errors = aigent::validate(Path::new("my-skill"));

// Read skill properties
let props = aigent::read_properties(Path::new("my-skill")).unwrap();

// Generate prompt XML
let xml = aigent::to_prompt(&[Path::new("skill-a"), Path::new("skill-b")]);

// Build a skill
let spec = aigent::SkillSpec {
    purpose: "Process PDF files".to_string(),
    no_llm: true,
    ..Default::default()
};
let result = aigent::build_skill(&spec).unwrap();

Builder Modes

The skill builder operates in two modes:

Deterministic — Always available, zero configuration. Uses heuristic rules to derive skill names (gerund form, kebab-case), descriptions, and markdown bodies. Output is formulaic but valid.

LLM-enhanced — Auto-detected via environment variables. Produces richer, more natural output. Each generation step (name, description, body) independently falls back to deterministic on LLM failure.

Provider detection order:

Model overrides: ANTHROPIC_MODEL, OPENAI_MODEL, GOOGLE_MODEL, OLLAMA_MODEL.

Use --no-llm to force deterministic mode regardless of available providers.

Spec Compliance

Three-way comparison of the Anthropic agent skill specification, aigent, and the Python reference implementation.

Table shows key validation rules from the Anthropic spec. Additional checks (frontmatter structure, metadata keys, YAML syntax) are implemented but not listed as they are standard parser behavior.

CLI Reference

Build Flags

Global Flags

License

MIT — see LICENSE for details.