skillset 0.1.0

A package manager for coding agent skills
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
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

# Skillset

![Crates.io](https://img.shields.io/crates/v/skillset)
![License](https://img.shields.io/github/license/climax-tools/skillset)
![Rust](https://img.shields.io/badge/rust-2021+-blue.svg)

A CLI package manager for AI agent skills. Install, manage, and organize skills across multiple agent frameworks with simple npm-like commands.

## Quick Start

### Installation
```bash
cargo install skillset
```

### Basic Usage
```bash
# Install React best practices skill
skillset add react-best-practices@1.0.0

# Install from a specific source
skillset add my-skill --source git:https://github.com/user/repo

# List installed skills
skillset list

# Remove a skill
skillset remove react-best-practices
```

### Configuration
Create `skillset.json` in your project:

```json
{
  "skills": {
    "react-best-practices": "1.0.0",
    "@user/web-scraper": "2.1.0",
    "custom-skill": {
      "version": "3.0.0",
      "source": "git:https://github.com/vercel-labs/agent-skills",
      "convention": "agent-skills"
    }
  },
  "registry": "ghcr.io/skillset",
  "conventions": ["autogpt", "langchain", "agent-skills"]
}
```

## Features

- **Multi-Framework Support**: Works with Auto-GPT, LangChain, Vercel Agent Skills, and custom agent frameworks
- **Smart Organization**: Automatically organizes skills by framework conventions
- **Multiple Sources**: Install from Git repositories, OCI registries, or local paths
- **Version Management**: Pin specific versions or use `latest`
- **Scoped Namespaces**: Use `@user/skill` format for community skills
- **Zero-Configuration Caching**: Automatic cross-project skill sharing
- **Production-Ready Skills**: Access Vercel's React best practices and other production-grade skills

## CLI Reference

### Skill Management
```bash
skillset add <skill>[@<version>] [--source <source>] [--convention <convention>]
skillset remove <skill>
skillset list [--verbose]
skillset update [skill]
skillset info <skill>
```

### Conventions
```bash
skillset convention list
skillset convention enable <name>
skillset convention disable <name>
```

### Publishing
```bash
skillset publish <path> <reference>
```

## Supported Sources

- **Git**: `git:https://github.com/user/repo` or direct GitHub URLs
- **OCI**: `oci:ghcr.io/user/skill:v1.0.0` (default for simple names)
- **Local**: `./local-skill` or absolute paths

## Framework Support

- **Auto-GPT**: Automatically detected and organized as `skills/autogpt/{name}/`
- **LangChain**: Automatically detected and organized as `skills/langchain/{name}/`
- **Vercel Agent Skills**: Automatically detected and organized as `skills/agent-skills/{name}/`
- **Custom**: User-defined conventions for any framework

## Reference Resolution

Simple skill names automatically resolve to OCI registries:

- `file-analyzer` → `oci:ghcr.io/skillset/file-analyzer:v1.0.0`
- `@user/skill` → `oci:ghcr.io/user/skill:v1.0.0`

## Project Structure

Skills are organized by framework:

```
project/
├── skillset.json
├── skills/
│   ├── autogpt/
│   │   └── file-analyzer/
│   ├── langchain/
│   │   └── llm-tool/
│   └── agent-skills/
│       └── react-best-practices/
└── .skillset/
    └── cache/
```

## Development

For architecture details and integration guidelines, see [AGENTS.md](./AGENTS.md).