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
use clap::{Args, Subcommand, ValueEnum};
#[derive(Subcommand, Debug, Clone)]
pub enum SkillAction {
/// Show whether the Agent-First Mail skill is installed and valid.
Status(SkillTargetArgs),
/// Install the Agent-First Mail skill.
Install(SkillWriteArgs),
/// Remove an afmail-managed Agent-First Mail skill.
Uninstall(SkillWriteArgs),
}
#[derive(Args, Debug, Clone)]
pub struct SkillTargetArgs {
/// Agent to manage. Defaults to all personal skill targets.
#[arg(long = "agent", value_enum, default_value_t = SkillAgentSelection::All)]
pub agent: SkillAgentSelection,
/// Skill scope. Workspace scope installs under the current workspace's skill directory.
#[arg(long = "scope", value_enum, default_value_t = SkillScope::Personal)]
pub scope: SkillScope,
/// Directory that contains skill folders. Requires an explicit single --agent.
#[arg(long = "skills-dir")]
pub skills_dir: Option<String>,
}
#[derive(Args, Debug, Clone)]
pub struct SkillWriteArgs {
#[command(flatten)]
pub target: SkillTargetArgs,
/// Overwrite or remove an unmanaged Agent-First Mail skill at the target path.
#[arg(long)]
pub force: bool,
}
#[derive(Clone, Copy, Debug, PartialEq, Eq, ValueEnum)]
pub enum SkillAgentSelection {
/// Manage every agent that supports the requested scope.
All,
/// Manage the Codex skill under $CODEX_HOME/skills or .codex/skills.
Codex,
/// Manage the Claude Code skill under ~/.claude/skills or .claude/skills.
#[value(name = "claude-code", alias = "claude")]
ClaudeCode,
/// Manage the opencode skill under ~/.config/opencode/skills or .opencode/skills.
Opencode,
/// Manage the Hermes skill under $HERMES_HOME/skills or ~/.hermes/skills.
Hermes,
}
#[derive(Clone, Copy, Debug, PartialEq, Eq, ValueEnum)]
pub enum SkillScope {
/// Install under the user-level skills directory.
Personal,
/// Install under the current workspace's skills directory.
Workspace,
}