aigent 0.7.1

A library, CLI, and Claude plugin for managing agent skill definitions
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

//! # aigent
//!
//! A Rust library for managing AI agent skill definitions (SKILL.md files).
//!
//! Implements the [Anthropic agent skill specification](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)
//! with validation, prompt generation, and skill building capabilities.
//!
//! ## Quick Start
//!
//! ```rust,no_run
//! use std::path::Path;
//!
//! // Validate a skill directory
//! let diags = aigent::validate(Path::new("my-skill"));
//! let has_errors = diags.iter().any(|d| d.is_error());
//!
//! // Read skill properties
//! let props = aigent::read_properties(Path::new("my-skill")).unwrap();
//! println!("{}", props.name);
//! ```

#![warn(missing_docs)]

/// Skill-to-plugin assembly: packages skills into Claude Code plugins.
pub mod assembler;
/// Skill builder: deterministic and LLM-enhanced skill generation.
pub mod builder;
/// Cross-skill conflict detection for skill collections.
pub mod conflict;
/// Structured diagnostics for validation, linting, and error reporting.
pub mod diagnostics;
/// Error types for skill operations.
pub mod errors;
/// Auto-fix application for fixable diagnostics.
pub mod fixer;
/// SKILL.md formatting: canonical key ordering and markdown cleanup.
pub mod formatter;
/// Symlink-safe filesystem helpers.
pub(crate) mod fs_util;
/// Semantic lint checks for skill quality improvement.
pub mod linter;
/// Data model for SKILL.md frontmatter properties.
pub mod models;
/// SKILL.md frontmatter parser.
pub mod parser;
/// Plugin ecosystem validation: manifest, hooks, agents, commands.
pub mod plugin;
/// Multi-format prompt generation for LLM injection.
pub mod prompt;
/// Quality scoring for skill best-practices compliance.
pub mod scorer;
/// Directory structure validation for skill packages.
pub mod structure;
/// Fixture-based skill testing: run test suites defined in `tests.yml`.
pub mod test_runner;
/// Skill tester and previewer for evaluation-driven development.
pub mod tester;
/// Skill directory and metadata validator.
pub mod validator;

// Re-export key types at crate root for convenience.
pub use assembler::{assemble_plugin, AssembleOptions, AssembleResult, AssembleWarning};
pub use conflict::{detect_conflicts, detect_conflicts_with_threshold};
#[doc(inline)]
pub use diagnostics::{Diagnostic, Severity, ValidationTarget};
#[doc(inline)]
pub use errors::{AigentError, Result};
pub use fixer::apply_fixes;
pub use formatter::{diff_skill, format_content, format_skill, FormatResult};
pub use fs_util::is_regular_file;
pub use linter::lint;
#[doc(inline)]
pub use models::SkillProperties;
pub use parser::{
    find_skill_md, parse_frontmatter, parse_optional_frontmatter, read_body, read_properties,
    CLAUDE_CODE_KEYS, KNOWN_KEYS,
};
pub use plugin::{
    validate_agent, validate_command, validate_cross_component, validate_hooks, validate_manifest,
    PluginManifest,
};
pub use prompt::{
    collect_skills, collect_skills_verbose, estimate_tokens, format_budget, format_entries,
    to_prompt, to_prompt_format, PromptFormat, SkillEntry,
};
pub use scorer::{score, ScoreResult};
pub use structure::validate_structure;
pub use test_runner::{
    format_text as format_test_suite, generate_fixture, run_test_suite, MatchStrength,
    TestSuiteResult,
};
pub use tester::{test_skill, TestResult};
pub use validator::{
    discover_skills, discover_skills_verbose, known_keys_for, validate, validate_metadata,
    validate_metadata_with_target, validate_with_target, DiscoveryWarning,
};

#[doc(inline)]
pub use builder::{
    assess_clarity, build_skill, derive_name, init_skill, interactive_build, BuildResult,
    ClarityAssessment, LlmProvider, SkillSpec, SkillTemplate,
};