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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

//! Select command: interactive skill selection for debugging.

use clap::Args;
use std::path::PathBuf;

use skm_core::SkillRegistry;
use skm_select::{CascadeSelector, SelectionContext, TriggerStrategy};

#[derive(Args)]
pub struct SelectArgs {
    /// Query to select skill for
    query: String,

    /// Skill directories
    #[arg(short, long, default_value = ".")]
    skills: Vec<PathBuf>,

    /// Top K results to return
    #[arg(short = 'k', long, default_value = "5")]
    top_k: usize,

    /// Show detailed breakdown
    #[arg(long)]
    verbose: bool,

    /// Output format
    #[arg(long, default_value = "text")]
    format: String,
}

pub async fn select(args: SelectArgs) -> anyhow::Result<()> {
    let registry = SkillRegistry::new(&args.skills).await?;

    // Build trigger strategy
    let trigger = TriggerStrategy::from_registry(&registry).await?;

    // Build cascade
    let selector = CascadeSelector::builder().with_triggers(trigger).build();

    // Select
    let ctx = SelectionContext::new();
    let outcome = selector.select(&args.query, &registry, &ctx).await?;

    match args.format.as_str() {
        "json" => {
            let results: Vec<serde_json::Value> = outcome
                .selected
                .iter()
                .take(args.top_k)
                .map(|r| {
                    serde_json::json!({
                        "skill": r.skill.as_str(),
                        "score": r.score,
                        "confidence": format!("{:?}", r.confidence),
                        "strategy": r.strategy,
                        "reasoning": r.reasoning
                    })
                })
                .collect();

            let output = serde_json::json!({
                "query": args.query,
                "results": results,
                "latency_ms": outcome.total_latency.as_millis(),
                "strategies_used": outcome.strategies_used,
                "fallback_used": outcome.fallback_used
            });

            println!("{}", serde_json::to_string_pretty(&output)?);
        }
        _ => {
            println!("Query: {}\n", args.query);

            if outcome.selected.is_empty() {
                println!("No matching skills found.");
            } else {
                println!("Results:");
                for (i, r) in outcome.selected.iter().take(args.top_k).enumerate() {
                    println!(
                        "  {}. {} (score: {:.2}, confidence: {:?}, strategy: {})",
                        i + 1,
                        r.skill,
                        r.score,
                        r.confidence,
                        r.strategy
                    );
                    if args.verbose {
                        if let Some(ref reasoning) = r.reasoning {
                            println!("     reasoning: {}", reasoning);
                        }
                    }
                }
            }

            println!("\nLatency: {:?}", outcome.total_latency);
            println!("Strategies: {:?}", outcome.strategies_used);
        }
    }

    Ok(())
}