agents-skills 0.4.0

A minimal, stable, easy-to-understand skill installer and manager for AI agents
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

//! link: manage agents' skills dirs and their link state relative to the canonical dir.
//!
//! Three modes, selected by flag — mirroring [`LinkRequest`] on the library side:
//! - default: connect agents' skills dirs via directory-level symlinks
//! - `--status`: show which agents are linked ([`Manager::link_status`])
//! - `--unlink`: disconnect agents' skills dirs
//!
//! Renders outcomes; no business logic lives here.

use crate::cli::{BOLD, DIM, GREEN, RESET, YELLOW};
use crate::commands::{fail_agents, render_link_result};
use agents_skills::error::Result;
use agents_skills::{LinkManagerOutcome, LinkOutcome, LinkRequest, Manager};

/// Run the `link` command; `--status` and `--unlink` switch the mode.
pub fn run(manager: &Manager, args: crate::cli::LinkArgs) -> Result<()> {
    if args.status {
        render_status(manager, args.global);
        return Ok(());
    }
    let req = LinkRequest {
        agents: args.agents,
        global: args.global,
        unlink: args.unlink,
        migrate: args.migrate,
    };
    let outcome = match manager.link(&req) {
        Ok(o) => o,
        Err(e) => return fail_agents(e),
    };
    render_link(&outcome, args.unlink);
    Ok(())
}

fn render_status(manager: &Manager, global: bool) {
    let scope = if global { "global" } else { "project" };
    println!("{BOLD}Agent link status ({scope}){RESET}");
    println!();
    let mut statuses = manager.link_status(global);
    // Agents that natively use the canonical dir go first; others keep table order.
    statuses.sort_by_key(|s| !s.canonical);
    for s in statuses {
        if s.canonical {
            println!("  {DIM}•{RESET} {} {DIM}(canonical dir){RESET}", s.display);
        } else if s.linked {
            println!("  {GREEN}✓{RESET} {} {DIM}(linked){RESET}", s.display);
        } else {
            let hint = if global {
                format!("run `agents-skills link {} -g`", s.name)
            } else {
                format!("run `agents-skills link {}`", s.name)
            };
            println!(
                "  {YELLOW}!{RESET} {} {DIM}(not linked) — {hint}{RESET}",
                s.display
            );
        }
    }
    println!();
}

fn render_link(outcome: &LinkManagerOutcome, unlink: bool) {
    let scope = if outcome.global { "global" } else { "project" };
    if unlink {
        println!("{DIM}Unlinking agents from the {scope} canonical skills dir{RESET}");
    } else {
        println!("{DIM}Linking agents to the {scope} canonical skills dir{RESET}");
    }
    println!();
    for r in &outcome.results {
        render_link_result(r);
    }
    if unlink {
        println!();
        println!(
            "{DIM}Skills stay installed in the canonical dir; use `remove` to delete them.{RESET}"
        );
    } else {
        // The --migrate hint only helps when a refused dir actually holds skills;
        // dirs with only non-skill files can't be migrated.
        let needs_migrate = outcome.results.iter().any(|r| match &r.outcome {
            LinkOutcome::Refused { skills, .. } => !skills.is_empty(),
            _ => false,
        });
        if needs_migrate {
            println!();
            println!(
                "{DIM}Rerun with --migrate to move existing skills into the canonical dir.{RESET}"
            );
        }
    }
    println!();
}