spec-driven-docs 0.8.1

Spec-driven documentation: current specs, immutable decision records, and executable gates kept coherent for people and coding 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

//! `skill` subcommand: parse-shape.
//!
//! Holds the clap derive structs only. No I/O, no business logic.

use clap::{Subcommand, ValueEnum};

/// Read the embedded skills, or install and remove them for coding agents.
#[derive(Debug, clap::Args)]
pub struct SkillArgs {
    /// The verb to run.
    #[command(subcommand)]
    pub command: SkillCommand,
}

/// Every verb `sdd skill` offers.
#[derive(Debug, Subcommand)]
pub enum SkillCommand {
    /// List every embedded skill.
    List,
    /// Print one skill's `SKILL.md`.
    Show(ShowArgs),
    /// Install the skills into the agent skill directories.
    Install(InstallArgs),
    /// Remove the installed skills from the agent skill directories.
    Uninstall(UninstallArgs),
}

/// Print one skill's `SKILL.md`.
#[derive(Debug, clap::Args)]
pub struct ShowArgs {
    /// The skill's name.
    pub name: String,
}

/// Install the skills into the agent skill directories.
#[derive(Debug, clap::Args)]
pub struct InstallArgs {
    /// Which agent's skill directory to install into.
    #[arg(long, value_enum, default_value_t = Agent::All)]
    pub agent: Agent,

    /// Where the skills land; `user` is the home-directory scope.
    #[arg(long, value_enum, default_value_t = Scope::User)]
    pub scope: Scope,

    /// Write the files; without it the install previews.
    #[arg(long)]
    pub apply: bool,

    /// Overwrite a destination whose bytes differ from the payload.
    #[arg(long, requires = "apply")]
    pub force: bool,
}

/// Remove the installed skills from the agent skill directories.
#[derive(Debug, clap::Args)]
pub struct UninstallArgs {
    /// Which agent's skill directory to remove from.
    #[arg(long, value_enum, default_value_t = Agent::All)]
    pub agent: Agent,

    /// Where the skills live; `user` is the home-directory scope.
    #[arg(long, value_enum, default_value_t = Scope::User)]
    pub scope: Scope,

    /// Remove the files; without it the uninstall previews.
    #[arg(long)]
    pub apply: bool,
}

/// Which skill directory family to install into.
#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
#[value(rename_all = "kebab-case")]
pub enum Agent {
    /// `.claude/skills` — read by Claude Code.
    Claude,
    /// `.agents/skills` — read by Codex, Gemini CLI, and Copilot.
    Codex,
    /// Both directories.
    All,
}

/// Where an install lands.
#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
#[value(rename_all = "kebab-case")]
pub enum Scope {
    /// The home-directory skill roots, shared across projects.
    User,
}