zorto 0.20.4

The AI-native static site generator (SSG) with executable code blocks
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

use anyhow::{Context, Result};
use clap::Subcommand;
use std::path::PathBuf;

const SKILL_ZORTO: &str = include_str!("skill-zorto.md");

#[derive(Subcommand)]
pub(crate) enum SkillCommands {
    /// Install zorto skill(s)
    #[command(arg_required_else_help = true)]
    Install {
        /// Target directory
        ///
        /// Examples: ./.claude/skills, ~/.claude/skills, ./.agents/skills
        #[arg(long, required = true)]
        target: String,
        /// Install all skills
        #[arg(long)]
        all: bool,
    },
}

pub(crate) fn handle_skill(cmd: Option<SkillCommands>) -> Result<()> {
    let Some(cmd) = cmd else {
        // No subcommand given — clap's arg_required_else_help on Install
        // means we won't actually reach here in normal usage, but handle it gracefully.
        anyhow::bail!("run `zorto skill install --help` for usage");
    };
    match cmd {
        SkillCommands::Install { target, all: _ } => {
            let target = if target.starts_with("~/") || target == "~" {
                let home = std::env::var("HOME").context("HOME environment variable not set")?;
                PathBuf::from(target.replacen('~', &home, 1))
            } else {
                PathBuf::from(&target)
            };

            let dir_name = "zorto";
            let dir = target.join(dir_name);
            std::fs::create_dir_all(&dir)
                .with_context(|| format!("failed to create directory {}", dir.display()))?;
            let path = dir.join("SKILL.md");
            std::fs::write(&path, SKILL_ZORTO)
                .with_context(|| format!("failed to write {}", path.display()))?;
            let abs = std::fs::canonicalize(&path).unwrap_or(path);
            println!("Installed {dir_name} skill to {}", abs.display());
            Ok(())
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn skill_zorto_content_is_not_empty() {
        assert!(!SKILL_ZORTO.is_empty());
        assert!(SKILL_ZORTO.contains("zorto"));
    }

    #[test]
    fn skill_zorto_has_frontmatter() {
        assert!(SKILL_ZORTO.starts_with("---"));
        assert!(SKILL_ZORTO.contains("name: zorto"));
    }

    #[test]
    fn install_writes_skill_file() {
        let tmp = tempfile::tempdir().unwrap();
        let target = tmp.path().to_str().unwrap().to_string();
        handle_skill(Some(SkillCommands::Install { target, all: false })).unwrap();
        let skill_path = tmp.path().join("zorto").join("SKILL.md");
        assert!(skill_path.exists());
        let content = std::fs::read_to_string(&skill_path).unwrap();
        assert!(content.contains("zorto"));
    }

    #[test]
    fn install_creates_nested_directories() {
        let tmp = tempfile::tempdir().unwrap();
        let target = tmp
            .path()
            .join("deep")
            .join("nested")
            .to_str()
            .unwrap()
            .to_string();
        handle_skill(Some(SkillCommands::Install { target, all: false })).unwrap();
        let skill_path = tmp
            .path()
            .join("deep")
            .join("nested")
            .join("zorto")
            .join("SKILL.md");
        assert!(skill_path.exists());
    }
}