agent-skills-cli 0.4.4

CLI for validating and working with Agent Skills
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
99
100
101
102
103

# agent-skills-cli

Command-line tool for validating and working with [Agent Skills](https://agentskills.io).

## Installation

Install the `agent-skills` binary using any of these methods:

### Shell (macOS/Linux)

```bash
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Govcraft/agent-skills/releases/download/v0.4.4/agent-skills-cli-installer.sh | sh
```

### PowerShell (Windows)

```powershell
irm https://github.com/Govcraft/agent-skills/releases/download/v0.4.4/agent-skills-cli-installer.ps1 | iex
```

### npm

```bash
npm install -g @govcraft/agent-skills
```

### Cargo

```bash
cargo install agent-skills-cli
```

## Commands

### validate

Check that a skill conforms to the specification:

```bash
agent-skills validate ./my-skill
```
```
✓ my-skill (./my-skill)
```

Accepts a skill directory, a path to `SKILL.md`, or `-` to read paths from stdin.

**Note:** The `name` field in SKILL.md must match the parent directory name. A skill in `./my-skill/SKILL.md` must have `name: my-skill`.

### list

Discover skills in a directory:

```bash
agent-skills list ./skills
```
```
data-analysis    Analyze datasets and generate reports...
pdf-processing   Extract text from PDFs, fill forms...
```

Options: `--recursive` to search subdirectories, `--check` to validate each skill, `--long` for full details.

### read-properties

Extract skill metadata as JSON, YAML, or TOML:

```bash
agent-skills read-properties ./my-skill --format json
```
```json
{
  "name": "my-skill",
  "description": "Does something useful."
}
```

### to-prompt

Generate XML for embedding skill metadata in agent prompts:

```bash
agent-skills to-prompt ./skill-one ./skill-two
```

## Scripting and CI

- **Exit codes:** 0 on success, non-zero on failure
- **JSON errors:** `--json` for machine-readable error output
- **Stdin support:** Pass `-` to read paths from stdin
- **Quiet mode:** `-q` suppresses informational output

```bash
agent-skills validate ./my-skill || exit 1
```

## Specification

Skills are validated against the [Agent Skills specification](https://agentskills.io).

## License

MIT