agentskills 0.1.1

Agent skills package manager — install, manage, and discover AI agent skills from GitHub.
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

# agentskills

Agent skills package manager — install, manage, and discover AI agent skills from GitHub.

[![crates.io](https://img.shields.io/crates/v/agentskills.svg)](https://crates.io/crates/agentskills)
[![license](https://img.shields.io/crates/l/agentskills.svg)](LICENSE)

## Install

```bash
cargo install agentskills
```

## Commands

### `agentskills add <source>`

Install a skill from GitHub or a local path.

```bash
# Install a specific skill from a repo
agentskills add kayaman/skills@semver

# Install all skills from a repo
agentskills add kayaman/skills

# Install globally (to ~/.agents/skills/)
agentskills add kayaman/skills@semver --global

# Install from a local directory
agentskills add ./my-local-skill

# Skip confirmation
agentskills add kayaman/skills@semver --yes
```

### `agentskills list`

Show installed skills (project + global).

```bash
agentskills list           # Table output
agentskills list --json    # JSON output
agentskills list --global  # Global only
agentskills ls             # Alias
```

### `agentskills remove <name>`

Uninstall a skill and clean the lockfile.

```bash
agentskills remove semver
agentskills rm semver --global  # Remove from global
```

### `agentskills update [name]`

Check for upstream changes and re-fetch updated skills.

```bash
agentskills update          # Update all skills
agentskills update semver   # Update a specific skill
```

### `agentskills init [name]`

Scaffold a new `SKILL.md` template.

```bash
agentskills init my-skill
agentskills init my-skill --dir ./skills
```

### `agentskills find <query>`

Search GitHub for repos containing agent skills.

```bash
agentskills find "react testing"
agentskills find deploy --limit 5
```

## Skill format

A skill is a directory containing a `SKILL.md` file with YAML frontmatter:

```markdown
---
name: my-skill
description: What this skill does and when to use it.
---

# My Skill

Instructions for the AI agent...
```

Skills are typically organized in a GitHub repo under a `skills/` directory:

```
my-repo/
└── skills/
    ├── skill-a/
    │   └── SKILL.md
    └── skill-b/
        ├── SKILL.md
        └── references/
            └── extra-context.md
```

## Lockfile

Installed skills are tracked in `.skill-lock.json` (v3 format). Skills installed
by compatible tools sharing this format are visible to each other.

## Supported agents

agentskills detects and works with: Cursor, Claude Code, Codex, GitHub Copilot,
Amp, Cline, Continue, and Kiro.

## Development

```bash
cargo build          # Build
cargo test           # Run tests
cargo run -- --help  # Run locally
```

## License

Apache-2.0