skm-cli 0.1.0

Developer CLI for Agent Skills - validate, test, optimize, and serve
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

use clap::{Parser, Subcommand};
use tracing_subscriber::{fmt, EnvFilter};

mod commands;

/// Agent Skill Engine CLI
#[derive(Parser)]
#[command(name = "skm")]
#[command(about = "Agent Skill Engine - Selection, enforcement, and optimization for SKILL.md")]
#[command(version)]
struct Cli {
    #[command(subcommand)]
    command: Commands,

    /// Enable verbose output
    #[arg(short, long, global = true)]
    verbose: bool,
}

#[derive(Subcommand)]
enum Commands {
    /// Create a new skill from template
    Init(commands::InitArgs),

    /// Validate SKILL.md files
    Validate(commands::ValidateArgs),

    /// List skills in a directory
    List(commands::ListArgs),

    /// Interactive skill selection (for debugging)
    Select(commands::SelectArgs),

    /// Run trigger test suites
    Test(commands::TestArgs),

    /// Benchmark selection performance
    Bench(commands::BenchArgs),

    /// Optimize skill descriptions
    Optimize(commands::OptimizeArgs),

    /// Show usage analytics
    Stats(commands::StatsArgs),

    /// Build/rebuild embedding index
    Index(commands::IndexArgs),

    /// Export metrics (Prometheus/JSON)
    Export(commands::ExportArgs),

    /// Start HTTP API server
    #[cfg(feature = "http-server")]
    Serve(commands::ServeArgs),
}

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let cli = Cli::parse();

    // Initialize tracing
    let filter = if cli.verbose {
        EnvFilter::new("debug")
    } else {
        EnvFilter::new("info")
    };
    fmt().with_env_filter(filter).init();

    match cli.command {
        Commands::Init(args) => commands::init(args).await,
        Commands::Validate(args) => commands::validate(args).await,
        Commands::List(args) => commands::list(args).await,
        Commands::Select(args) => commands::select(args).await,
        Commands::Test(args) => commands::test(args).await,
        Commands::Bench(args) => commands::bench(args).await,
        Commands::Optimize(args) => commands::optimize(args).await,
        Commands::Stats(args) => commands::stats(args).await,
        Commands::Index(args) => commands::index(args).await,
        Commands::Export(args) => commands::export(args).await,
        #[cfg(feature = "http-server")]
        Commands::Serve(args) => commands::serve(args).await,
    }
}