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

//! Init command: create a new skill from template.

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

const SKILL_TEMPLATE: &str = r#"---
name: {{name}}
description: {{description}}
license: MIT
metadata:
  triggers: "{{triggers}}"
  tags: "{{tags}}"
---

# {{name}}

## Overview

{{description}}

## Usage

<!-- Add usage instructions here -->

## Examples

<!-- Add examples here -->
"#;

#[derive(Args)]
pub struct InitArgs {
    /// Skill name (will create a directory with this name)
    name: String,

    /// Skill description
    #[arg(short, long, default_value = "A new skill")]
    description: String,

    /// Trigger patterns (comma-separated)
    #[arg(short, long, default_value = "")]
    triggers: String,

    /// Tags (comma-separated)
    #[arg(long, default_value = "")]
    tags: String,

    /// Directory to create skill in
    #[arg(short, long, default_value = ".")]
    output: PathBuf,

    /// Force overwrite if exists
    #[arg(short, long)]
    force: bool,
}

pub async fn init(args: InitArgs) -> anyhow::Result<()> {
    let skill_dir = args.output.join(&args.name);

    if skill_dir.exists() && !args.force {
        anyhow::bail!(
            "Directory {:?} already exists. Use --force to overwrite.",
            skill_dir
        );
    }

    // Create directory
    std::fs::create_dir_all(&skill_dir)?;

    // Generate content
    let content = SKILL_TEMPLATE
        .replace("{{name}}", &args.name)
        .replace("{{description}}", &args.description)
        .replace("{{triggers}}", &args.triggers)
        .replace("{{tags}}", &args.tags);

    // Write SKILL.md
    let skill_file = skill_dir.join("SKILL.md");
    std::fs::write(&skill_file, content)?;

    println!("✓ Created skill at {:?}", skill_file);

    // Create optional directories
    std::fs::create_dir_all(skill_dir.join("references"))?;
    std::fs::create_dir_all(skill_dir.join("scripts"))?;

    println!("✓ Created references/ and scripts/ directories");
    println!("\nNext steps:");
    println!("  1. Edit {:?} to add instructions", skill_file);
    println!("  2. Run `skm validate {:?}` to check the skill", skill_dir);

    Ok(())
}