reskill 0.1.0 → 0.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +161 -104
- package/README.zh-CN.md +257 -0
- package/dist/cli/commands/index.d.ts +3 -3
- package/dist/cli/commands/index.d.ts.map +1 -1
- package/dist/cli/commands/info.d.ts +1 -1
- package/dist/cli/commands/init.d.ts +1 -1
- package/dist/cli/commands/install.d.ts +12 -4
- package/dist/cli/commands/install.d.ts.map +1 -1
- package/dist/cli/commands/list.d.ts +1 -1
- package/dist/cli/commands/list.d.ts.map +1 -1
- package/dist/cli/commands/outdated.d.ts +1 -1
- package/dist/cli/commands/outdated.d.ts.map +1 -1
- package/dist/cli/commands/uninstall.d.ts +1 -1
- package/dist/cli/commands/update.d.ts +1 -1
- package/dist/cli/index.js +999 -353
- package/dist/core/agent-registry.d.ts +54 -0
- package/dist/core/agent-registry.d.ts.map +1 -0
- package/dist/core/cache-manager.d.ts +20 -16
- package/dist/core/cache-manager.d.ts.map +1 -1
- package/dist/core/config-loader.d.ts +18 -18
- package/dist/core/config-loader.d.ts.map +1 -1
- package/dist/core/git-resolver.d.ts +23 -23
- package/dist/core/git-resolver.d.ts.map +1 -1
- package/dist/core/index.d.ts +8 -2
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/installer.d.ts +96 -0
- package/dist/core/installer.d.ts.map +1 -0
- package/dist/core/lock-manager.d.ts +17 -17
- package/dist/core/lock-manager.d.ts.map +1 -1
- package/dist/core/skill-manager.d.ts +83 -24
- package/dist/core/skill-manager.d.ts.map +1 -1
- package/dist/core/skill-parser.d.ts +116 -0
- package/dist/core/skill-parser.d.ts.map +1 -0
- package/dist/index.d.ts +4 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +951 -323
- package/dist/types/index.d.ts +96 -74
- package/dist/types/index.d.ts.map +1 -1
- package/dist/utils/fs.d.ts +30 -0
- package/dist/utils/fs.d.ts.map +1 -1
- package/package.json +29 -13
package/README.md
CHANGED
|
@@ -1,87 +1,136 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
1
3
|
# reskill
|
|
2
4
|
|
|
3
|
-
**
|
|
5
|
+
**Git-based Skills Package Manager for AI Agents**
|
|
6
|
+
|
|
7
|
+
*Declarative skill management like npm/Go modules — install, version, sync, and share AI agent skills*
|
|
4
8
|
|
|
5
9
|
[](https://www.npmjs.com/package/reskill)
|
|
6
10
|
[](https://opensource.org/licenses/MIT)
|
|
7
11
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
reskill 是一个基于 Git 的 AI Skills 包管理系统,类似 npm/Go modules 的架构,实现 AI Skills 的版本化管理、共享和复用。
|
|
12
|
+
English | [简体中文](./README.zh-CN.md)
|
|
11
13
|
|
|
12
|
-
|
|
14
|
+
</div>
|
|
13
15
|
|
|
14
|
-
|
|
15
|
-
- 📦 **声明式配置** - skills.json 清晰表达项目依赖
|
|
16
|
-
- 🔒 **版本锁定** - 支持精确版本、范围版本、latest
|
|
17
|
-
- 🔗 **本地开发** - 支持 link 本地 skill 进行开发调试
|
|
18
|
-
- ⚡ **全局缓存** - 避免重复下载,加速安装
|
|
16
|
+
---
|
|
19
17
|
|
|
20
|
-
##
|
|
18
|
+
## Quick Start
|
|
21
19
|
|
|
22
20
|
```bash
|
|
23
|
-
#
|
|
24
|
-
|
|
21
|
+
# 1. Initialize project
|
|
22
|
+
reskill init
|
|
25
23
|
|
|
26
|
-
#
|
|
27
|
-
|
|
24
|
+
# 2. Install a skill
|
|
25
|
+
reskill install github:anthropics/skills/frontend-design@latest
|
|
26
|
+
|
|
27
|
+
# 3. List installed skills
|
|
28
|
+
reskill list
|
|
28
29
|
```
|
|
29
30
|
|
|
30
|
-
##
|
|
31
|
+
## What is reskill?
|
|
31
32
|
|
|
32
|
-
|
|
33
|
-
# 1. 初始化项目
|
|
34
|
-
reskill init
|
|
33
|
+
reskill is a **Git-based package manager** for AI agent skills, similar to npm or Go modules. It provides declarative configuration, version locking, and seamless synchronization for managing skills across projects and teams.
|
|
35
34
|
|
|
36
|
-
|
|
37
|
-
reskill install github:user/my-skill@v1.0.0
|
|
35
|
+
**Supports:** Cursor, Claude Code, Codex, OpenCode, Windsurf, GitHub Copilot, and more.
|
|
38
36
|
|
|
39
|
-
|
|
40
|
-
reskill list
|
|
41
|
-
```
|
|
37
|
+
## Why reskill?
|
|
42
38
|
|
|
43
|
-
|
|
39
|
+
reskill offers **fine-grained skill management and synchronization**:
|
|
44
40
|
|
|
45
|
-
###
|
|
41
|
+
### Local Experience
|
|
46
42
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
reskill init --registry gitlab # 使用 gitlab 作为默认 registry
|
|
51
|
-
```
|
|
43
|
+
- **Declarative config** — `skills.json` clearly expresses project dependencies
|
|
44
|
+
- **Global cache** — Avoid redundant downloads, speed up installation
|
|
45
|
+
- **Local development** — Use `link` to develop and debug skills locally
|
|
52
46
|
|
|
53
|
-
###
|
|
47
|
+
### Engineering-Grade Management
|
|
54
48
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
49
|
+
- **Version locking** — `skills.lock` ensures team consistency
|
|
50
|
+
- **Flexible versioning** — Support exact versions, semver ranges, branches, and commits
|
|
51
|
+
- **Git as Registry** — No additional services needed, any Git repo is a skill source
|
|
52
|
+
|
|
53
|
+
### Cross-Project Sync
|
|
54
|
+
|
|
55
|
+
- **Version controlled** — Commit `skills.json` and `skills.lock` to your repo
|
|
56
|
+
- **CI integration** — Run `reskill install` in CI to verify dependencies
|
|
57
|
+
- **Multi-registry** — Support GitHub, GitLab, and private repositories
|
|
58
|
+
|
|
59
|
+
### Flexible Version Strategy
|
|
60
|
+
|
|
61
|
+
```json
|
|
62
|
+
{
|
|
63
|
+
"skills": {
|
|
64
|
+
"frontend-design": "github:anthropics/skills/frontend-design@latest",
|
|
65
|
+
"code-review": "github:team/code-review@v2.1.0",
|
|
66
|
+
"testing": "github:team/testing@^1.0.0"
|
|
67
|
+
}
|
|
68
|
+
}
|
|
62
69
|
```
|
|
63
70
|
|
|
64
|
-
|
|
71
|
+
When running `reskill update`:
|
|
72
|
+
- `@latest` skills automatically update to the newest tag
|
|
73
|
+
- `@v2.1.0` stays locked
|
|
74
|
+
- `@^1.0.0` updates to the latest 1.x.x version
|
|
75
|
+
|
|
76
|
+
## Installation
|
|
65
77
|
|
|
66
78
|
```bash
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
reskill
|
|
72
|
-
reskill outdated # 检查过期 skills
|
|
73
|
-
reskill uninstall <skill> # 卸载 skill
|
|
79
|
+
# Global install
|
|
80
|
+
npm install -g reskill
|
|
81
|
+
|
|
82
|
+
# Or use npx
|
|
83
|
+
npx reskill <command>
|
|
74
84
|
```
|
|
75
85
|
|
|
76
|
-
|
|
86
|
+
## Usage
|
|
87
|
+
|
|
88
|
+
### Source Formats
|
|
77
89
|
|
|
78
90
|
```bash
|
|
79
|
-
|
|
80
|
-
reskill
|
|
81
|
-
|
|
91
|
+
# GitHub shorthand
|
|
92
|
+
reskill install github:user/skill@v1.0.0
|
|
93
|
+
|
|
94
|
+
# Full URL
|
|
95
|
+
reskill install https://github.com/user/skill
|
|
96
|
+
|
|
97
|
+
# GitLab
|
|
98
|
+
reskill install gitlab:group/skill@latest
|
|
99
|
+
|
|
100
|
+
# Private registry
|
|
101
|
+
reskill install gitlab.company.com:team/skill@v1.0.0
|
|
102
|
+
|
|
103
|
+
# Default registry (from skills.json)
|
|
104
|
+
reskill install user/skill@v1.0.0
|
|
82
105
|
```
|
|
83
106
|
|
|
84
|
-
|
|
107
|
+
### Version Specification
|
|
108
|
+
|
|
109
|
+
| Format | Example | Description |
|
|
110
|
+
|--------|---------|-------------|
|
|
111
|
+
| Exact | `@v1.0.0` | Lock to specific tag |
|
|
112
|
+
| Latest | `@latest` | Get the latest tag |
|
|
113
|
+
| Range | `@^2.0.0` | Semver compatible (>=2.0.0 <3.0.0) |
|
|
114
|
+
| Branch | `@branch:develop` | Specific branch |
|
|
115
|
+
| Commit | `@commit:abc1234` | Specific commit hash |
|
|
116
|
+
|
|
117
|
+
## Commands
|
|
118
|
+
|
|
119
|
+
| Command | Description |
|
|
120
|
+
|---------|-------------|
|
|
121
|
+
| `reskill init` | Initialize `skills.json` in current directory |
|
|
122
|
+
| `reskill install [skill]` | Install skills from `skills.json` or a specific skill |
|
|
123
|
+
| `reskill list` | List installed skills |
|
|
124
|
+
| `reskill info <skill>` | Show skill details |
|
|
125
|
+
| `reskill update [skill]` | Update all or specific skill |
|
|
126
|
+
| `reskill outdated` | Check for outdated skills |
|
|
127
|
+
| `reskill uninstall <skill>` | Remove a skill |
|
|
128
|
+
| `reskill link <path>` | Link local skill for development |
|
|
129
|
+
| `reskill unlink <skill>` | Unlink a local skill |
|
|
130
|
+
|
|
131
|
+
Run `reskill <command> --help` for detailed options.
|
|
132
|
+
|
|
133
|
+
## Configuration
|
|
85
134
|
|
|
86
135
|
### skills.json
|
|
87
136
|
|
|
@@ -102,56 +151,33 @@ reskill unlink <skill> # 取消链接
|
|
|
102
151
|
}
|
|
103
152
|
```
|
|
104
153
|
|
|
105
|
-
###
|
|
154
|
+
### skills.lock
|
|
106
155
|
|
|
107
|
-
|
|
108
|
-
|-----|------|------|
|
|
109
|
-
| 精确版本 | `@v1.0.0` | 锁定到指定 tag |
|
|
110
|
-
| 最新版本 | `@latest` | 获取最新 tag |
|
|
111
|
-
| 范围版本 | `@^2.0.0` | semver 兼容(>=2.0.0 <3.0.0) |
|
|
112
|
-
| 分支 | `@branch:develop` | 指定分支 |
|
|
113
|
-
| Commit | `@commit:abc1234` | 指定 commit hash |
|
|
156
|
+
The lock file records exact versions and commit hashes to ensure reproducible installations across your team.
|
|
114
157
|
|
|
115
|
-
|
|
158
|
+
## Multi-Agent Support
|
|
116
159
|
|
|
117
|
-
|
|
118
|
-
完整格式: <registry>:<owner>/<repo>@<version>
|
|
119
|
-
简写格式: <owner>/<repo>@<version> (使用默认 registry)
|
|
120
|
-
|
|
121
|
-
示例:
|
|
122
|
-
github:user/skill@v1.0.0
|
|
123
|
-
gitlab:group/skill@latest
|
|
124
|
-
gitlab.company.com:team/skill@v1.0.0
|
|
125
|
-
user/skill@v1.0.0 → 使用 defaults.registry
|
|
126
|
-
```
|
|
160
|
+
reskill works with all major AI coding agents. Skills are installed to the `.skills/` directory by default and can be integrated with any agent.
|
|
127
161
|
|
|
128
|
-
|
|
162
|
+
| Agent | Integration Path |
|
|
163
|
+
|-------|------------------|
|
|
164
|
+
| Cursor | `.cursor/rules/` or `.cursor/skills/` |
|
|
165
|
+
| Claude Code | `.claude/skills/` |
|
|
166
|
+
| Codex | `.codex/skills/` |
|
|
167
|
+
| OpenCode | `.opencode/skills/` |
|
|
168
|
+
| Windsurf | `.windsurf/skills/` |
|
|
169
|
+
| GitHub Copilot | `.github/skills/` |
|
|
129
170
|
|
|
130
|
-
|
|
171
|
+
## Skill Repository Structure
|
|
131
172
|
|
|
132
|
-
|
|
133
|
-
my-project/
|
|
134
|
-
├── skills.json # 依赖声明
|
|
135
|
-
├── skills.lock # 版本锁定
|
|
136
|
-
└── .skills/ # 安装目录
|
|
137
|
-
├── planning/
|
|
138
|
-
│ ├── skill.json
|
|
139
|
-
│ └── SKILL.md
|
|
140
|
-
└── code-review/
|
|
141
|
-
├── skill.json
|
|
142
|
-
└── SKILL.md
|
|
143
|
-
```
|
|
144
|
-
|
|
145
|
-
## Skill 仓库结构
|
|
146
|
-
|
|
147
|
-
每个 Skill 仓库应遵循以下结构:
|
|
173
|
+
Each skill repository should follow this structure:
|
|
148
174
|
|
|
149
175
|
```
|
|
150
176
|
my-skill/
|
|
151
|
-
├── skill.json #
|
|
152
|
-
├── SKILL.md #
|
|
153
|
-
├── README.md #
|
|
154
|
-
└── templates/ #
|
|
177
|
+
├── skill.json # Metadata (required)
|
|
178
|
+
├── SKILL.md # Main entry document (required)
|
|
179
|
+
├── README.md # Repository description
|
|
180
|
+
└── templates/ # Template files (optional)
|
|
155
181
|
```
|
|
156
182
|
|
|
157
183
|
### skill.json
|
|
@@ -168,32 +194,63 @@ my-skill/
|
|
|
168
194
|
}
|
|
169
195
|
```
|
|
170
196
|
|
|
171
|
-
##
|
|
197
|
+
## Project Structure
|
|
198
|
+
|
|
199
|
+
After installation:
|
|
200
|
+
|
|
201
|
+
```
|
|
202
|
+
my-project/
|
|
203
|
+
├── skills.json # Dependency declaration
|
|
204
|
+
├── skills.lock # Version lock file
|
|
205
|
+
└── .skills/ # Installation directory
|
|
206
|
+
├── planning/
|
|
207
|
+
│ ├── skill.json
|
|
208
|
+
│ └── SKILL.md
|
|
209
|
+
└── code-review/
|
|
210
|
+
├── skill.json
|
|
211
|
+
└── SKILL.md
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
## Environment Variables
|
|
172
215
|
|
|
173
|
-
|
|
|
174
|
-
|
|
175
|
-
| `SKPM_CACHE_DIR` |
|
|
176
|
-
| `DEBUG` |
|
|
216
|
+
| Variable | Description | Default |
|
|
217
|
+
|----------|-------------|---------|
|
|
218
|
+
| `SKPM_CACHE_DIR` | Global cache directory | `~/.reskill-cache` |
|
|
219
|
+
| `DEBUG` | Enable debug logging | - |
|
|
177
220
|
|
|
178
|
-
##
|
|
221
|
+
## Development
|
|
179
222
|
|
|
180
223
|
```bash
|
|
181
|
-
#
|
|
224
|
+
# Install dependencies
|
|
182
225
|
pnpm install
|
|
183
226
|
|
|
184
|
-
#
|
|
227
|
+
# Development mode
|
|
185
228
|
pnpm dev
|
|
186
229
|
|
|
187
|
-
#
|
|
230
|
+
# Build
|
|
188
231
|
pnpm build
|
|
189
232
|
|
|
190
|
-
#
|
|
233
|
+
# Run tests
|
|
191
234
|
pnpm test
|
|
192
235
|
|
|
193
|
-
#
|
|
236
|
+
# Type check
|
|
194
237
|
pnpm typecheck
|
|
195
238
|
```
|
|
196
239
|
|
|
240
|
+
## Acknowledgements
|
|
241
|
+
|
|
242
|
+
reskill was inspired by and references the implementations of these excellent projects:
|
|
243
|
+
|
|
244
|
+
- [add-skill](https://github.com/vercel-labs/add-skill) by Vercel Labs
|
|
245
|
+
- [skild](https://github.com/Peiiii/skild) by Peiiii
|
|
246
|
+
- [openskills](https://github.com/numman-ali/openskills) by Numman Ali
|
|
247
|
+
|
|
248
|
+
Thanks to these projects for pioneering the AI agent skills ecosystem!
|
|
249
|
+
|
|
250
|
+
## Related Links
|
|
251
|
+
|
|
252
|
+
- [Agent Skills Specification](https://agentskills.io)
|
|
253
|
+
|
|
197
254
|
## License
|
|
198
255
|
|
|
199
256
|
MIT
|
package/README.zh-CN.md
ADDED
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# reskill
|
|
4
|
+
|
|
5
|
+
**基于 Git 的 AI Agent Skills 包管理器**
|
|
6
|
+
|
|
7
|
+
*类似 npm/Go modules 的声明式 skill 管理 — 安装、版本控制、同步和共享 AI agent skills*
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/reskill)
|
|
10
|
+
[](https://opensource.org/licenses/MIT)
|
|
11
|
+
|
|
12
|
+
[English](./README.md) | 简体中文
|
|
13
|
+
|
|
14
|
+
</div>
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 快速开始
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# 1. 初始化项目
|
|
22
|
+
reskill init
|
|
23
|
+
|
|
24
|
+
# 2. 安装 skill
|
|
25
|
+
reskill install github:anthropics/skills/frontend-design@latest
|
|
26
|
+
|
|
27
|
+
# 3. 列出已安装的 skills
|
|
28
|
+
reskill list
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## 什么是 reskill?
|
|
32
|
+
|
|
33
|
+
reskill 是一个**基于 Git 的包管理器**,用于管理 AI agent skills,类似 npm 或 Go modules。它提供声明式配置、版本锁定和无缝同步,帮助你在项目和团队间管理 skills。
|
|
34
|
+
|
|
35
|
+
**支持:** Cursor、Claude Code、Codex、OpenCode、Windsurf、GitHub Copilot 等。
|
|
36
|
+
|
|
37
|
+
## 为什么选择 reskill?
|
|
38
|
+
|
|
39
|
+
reskill 提供**精细化的 skill 管理和同步方案**:
|
|
40
|
+
|
|
41
|
+
### 本地体验优化
|
|
42
|
+
|
|
43
|
+
- **声明式配置** — `skills.json` 清晰表达项目依赖
|
|
44
|
+
- **全局缓存** — 避免重复下载,加速安装
|
|
45
|
+
- **本地开发** — 使用 `link` 链接本地 skill 进行开发调试
|
|
46
|
+
|
|
47
|
+
### 工程化项目管理
|
|
48
|
+
|
|
49
|
+
- **版本锁定** — `skills.lock` 确保团队一致性
|
|
50
|
+
- **灵活版本** — 支持精确版本、semver 范围、分支和 commit
|
|
51
|
+
- **Git 即 Registry** — 无需额外服务,任何 Git 仓库都可作为 skill 源
|
|
52
|
+
|
|
53
|
+
### 跨项目同步
|
|
54
|
+
|
|
55
|
+
- **版本控制** — 将 `skills.json` 和 `skills.lock` 提交到仓库
|
|
56
|
+
- **CI 集成** — 在 CI 中运行 `reskill install` 验证依赖
|
|
57
|
+
- **多 Registry** — 支持 GitHub、GitLab 和私有仓库
|
|
58
|
+
|
|
59
|
+
### 灵活的版本策略
|
|
60
|
+
|
|
61
|
+
```json
|
|
62
|
+
{
|
|
63
|
+
"skills": {
|
|
64
|
+
"frontend-design": "github:anthropics/skills/frontend-design@latest",
|
|
65
|
+
"code-review": "github:team/code-review@v2.1.0",
|
|
66
|
+
"testing": "github:team/testing@^1.0.0"
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
运行 `reskill update` 时:
|
|
72
|
+
|
|
73
|
+
- `@latest` 的 skill 会自动更新到最新 tag
|
|
74
|
+
- `@v2.1.0` 保持不变
|
|
75
|
+
- `@^1.0.0` 会更新到 1.x.x 的最新版本
|
|
76
|
+
|
|
77
|
+
## 安装
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
# 全局安装
|
|
81
|
+
npm install -g reskill
|
|
82
|
+
|
|
83
|
+
# 或使用 npx
|
|
84
|
+
npx reskill <command>
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## 使用方式
|
|
88
|
+
|
|
89
|
+
### 源格式
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
# GitHub 简写
|
|
93
|
+
reskill install github:user/skill@v1.0.0
|
|
94
|
+
|
|
95
|
+
# 完整 URL
|
|
96
|
+
reskill install https://github.com/user/skill
|
|
97
|
+
|
|
98
|
+
# GitLab
|
|
99
|
+
reskill install gitlab:group/skill@latest
|
|
100
|
+
|
|
101
|
+
# 私有 Registry
|
|
102
|
+
reskill install gitlab.company.com:team/skill@v1.0.0
|
|
103
|
+
|
|
104
|
+
# 默认 Registry(来自 skills.json)
|
|
105
|
+
reskill install user/skill@v1.0.0
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### 版本规范
|
|
109
|
+
|
|
110
|
+
| 格式 | 示例 | 说明 |
|
|
111
|
+
|------|------|------|
|
|
112
|
+
| 精确版本 | `@v1.0.0` | 锁定到指定 tag |
|
|
113
|
+
| 最新版本 | `@latest` | 获取最新 tag |
|
|
114
|
+
| 范围版本 | `@^2.0.0` | semver 兼容(>=2.0.0 <3.0.0) |
|
|
115
|
+
| 分支 | `@branch:develop` | 指定分支 |
|
|
116
|
+
| Commit | `@commit:abc1234` | 指定 commit hash |
|
|
117
|
+
|
|
118
|
+
## 命令
|
|
119
|
+
|
|
120
|
+
| 命令 | 说明 |
|
|
121
|
+
|------|------|
|
|
122
|
+
| `reskill init` | 在当前目录初始化 `skills.json` |
|
|
123
|
+
| `reskill install [skill]` | 安装 `skills.json` 中的所有 skills 或指定 skill |
|
|
124
|
+
| `reskill list` | 列出已安装的 skills |
|
|
125
|
+
| `reskill info <skill>` | 查看 skill 详情 |
|
|
126
|
+
| `reskill update [skill]` | 更新所有或指定 skill |
|
|
127
|
+
| `reskill outdated` | 检查过期的 skills |
|
|
128
|
+
| `reskill uninstall <skill>` | 卸载 skill |
|
|
129
|
+
| `reskill link <path>` | 链接本地 skill(开发用) |
|
|
130
|
+
| `reskill unlink <skill>` | 取消链接本地 skill |
|
|
131
|
+
|
|
132
|
+
运行 `reskill <command> --help` 查看详细选项。
|
|
133
|
+
|
|
134
|
+
## 配置
|
|
135
|
+
|
|
136
|
+
### skills.json
|
|
137
|
+
|
|
138
|
+
```json
|
|
139
|
+
{
|
|
140
|
+
"name": "my-project",
|
|
141
|
+
"skills": {
|
|
142
|
+
"planning": "github:user/planning-skill@v1.0.0",
|
|
143
|
+
"code-review": "gitlab:team/code-review@latest"
|
|
144
|
+
},
|
|
145
|
+
"defaults": {
|
|
146
|
+
"registry": "github",
|
|
147
|
+
"installDir": ".skills"
|
|
148
|
+
},
|
|
149
|
+
"registries": {
|
|
150
|
+
"internal": "https://gitlab.company.com"
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
### skills.lock
|
|
156
|
+
|
|
157
|
+
锁定文件记录精确版本和 commit hash,确保团队间可复现的安装结果。
|
|
158
|
+
|
|
159
|
+
## 多 Agent 支持
|
|
160
|
+
|
|
161
|
+
reskill 支持所有主流 AI 编程 Agent。Skills 默认安装到 `.skills/` 目录,可与任何 Agent 集成。
|
|
162
|
+
|
|
163
|
+
| Agent | 集成路径 |
|
|
164
|
+
|-------|----------|
|
|
165
|
+
| Cursor | `.cursor/rules/` 或 `.cursor/skills/` |
|
|
166
|
+
| Claude Code | `.claude/skills/` |
|
|
167
|
+
| Codex | `.codex/skills/` |
|
|
168
|
+
| OpenCode | `.opencode/skills/` |
|
|
169
|
+
| Windsurf | `.windsurf/skills/` |
|
|
170
|
+
| GitHub Copilot | `.github/skills/` |
|
|
171
|
+
|
|
172
|
+
## Skill 仓库结构
|
|
173
|
+
|
|
174
|
+
每个 Skill 仓库应遵循以下结构:
|
|
175
|
+
|
|
176
|
+
```
|
|
177
|
+
my-skill/
|
|
178
|
+
├── skill.json # 元数据(必需)
|
|
179
|
+
├── SKILL.md # 主入口文档(必需)
|
|
180
|
+
├── README.md # 仓库说明
|
|
181
|
+
└── templates/ # 模板文件(可选)
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
### skill.json
|
|
185
|
+
|
|
186
|
+
```json
|
|
187
|
+
{
|
|
188
|
+
"name": "my-skill",
|
|
189
|
+
"version": "1.0.0",
|
|
190
|
+
"description": "A skill for ...",
|
|
191
|
+
"author": "Your Name",
|
|
192
|
+
"license": "MIT",
|
|
193
|
+
"entry": "SKILL.md",
|
|
194
|
+
"keywords": ["ai", "skill"]
|
|
195
|
+
}
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
## 项目结构
|
|
199
|
+
|
|
200
|
+
安装后的目录结构:
|
|
201
|
+
|
|
202
|
+
```
|
|
203
|
+
my-project/
|
|
204
|
+
├── skills.json # 依赖声明
|
|
205
|
+
├── skills.lock # 版本锁定文件
|
|
206
|
+
└── .skills/ # 安装目录
|
|
207
|
+
├── planning/
|
|
208
|
+
│ ├── skill.json
|
|
209
|
+
│ └── SKILL.md
|
|
210
|
+
└── code-review/
|
|
211
|
+
├── skill.json
|
|
212
|
+
└── SKILL.md
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
## 环境变量
|
|
216
|
+
|
|
217
|
+
| 变量 | 说明 | 默认值 |
|
|
218
|
+
|------|------|--------|
|
|
219
|
+
| `SKPM_CACHE_DIR` | 全局缓存目录 | `~/.reskill-cache` |
|
|
220
|
+
| `DEBUG` | 启用调试日志 | - |
|
|
221
|
+
|
|
222
|
+
## 开发
|
|
223
|
+
|
|
224
|
+
```bash
|
|
225
|
+
# 安装依赖
|
|
226
|
+
pnpm install
|
|
227
|
+
|
|
228
|
+
# 开发模式
|
|
229
|
+
pnpm dev
|
|
230
|
+
|
|
231
|
+
# 构建
|
|
232
|
+
pnpm build
|
|
233
|
+
|
|
234
|
+
# 运行测试
|
|
235
|
+
pnpm test
|
|
236
|
+
|
|
237
|
+
# 类型检查
|
|
238
|
+
pnpm typecheck
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
## 致谢
|
|
242
|
+
|
|
243
|
+
reskill 的实现参考了以下优秀项目:
|
|
244
|
+
|
|
245
|
+
- [add-skill](https://github.com/vercel-labs/add-skill) by Vercel Labs
|
|
246
|
+
- [skild](https://github.com/Peiiii/skild) by Peiiii
|
|
247
|
+
- [openskills](https://github.com/numman-ali/openskills) by Numman Ali
|
|
248
|
+
|
|
249
|
+
感谢这些项目为 AI agent skills 生态系统做出的开创性贡献!
|
|
250
|
+
|
|
251
|
+
## 相关链接
|
|
252
|
+
|
|
253
|
+
- [Agent Skills 规范](https://agentskills.io)
|
|
254
|
+
|
|
255
|
+
## 许可证
|
|
256
|
+
|
|
257
|
+
MIT
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
+
export { infoCommand } from './info.js';
|
|
1
2
|
export { initCommand } from './init.js';
|
|
2
3
|
export { installCommand } from './install.js';
|
|
4
|
+
export { linkCommand, unlinkCommand } from './link.js';
|
|
3
5
|
export { listCommand } from './list.js';
|
|
4
|
-
export { infoCommand } from './info.js';
|
|
5
|
-
export { updateCommand } from './update.js';
|
|
6
6
|
export { outdatedCommand } from './outdated.js';
|
|
7
7
|
export { uninstallCommand } from './uninstall.js';
|
|
8
|
-
export {
|
|
8
|
+
export { updateCommand } from './update.js';
|
|
9
9
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
|
|
@@ -1,10 +1,18 @@
|
|
|
1
1
|
import { Command } from 'commander';
|
|
2
2
|
/**
|
|
3
|
-
* install
|
|
3
|
+
* install command - Install a skill
|
|
4
4
|
*
|
|
5
|
-
*
|
|
6
|
-
* -
|
|
7
|
-
* -
|
|
5
|
+
* Supports multiple installation modes:
|
|
6
|
+
* - Project install (default): Install to project directory
|
|
7
|
+
* - Global install (-g): Install to user home directory
|
|
8
|
+
* - Multi-Agent install (-a): Install to specified agents
|
|
9
|
+
*
|
|
10
|
+
* Interactive flow:
|
|
11
|
+
* 1. Detect installed agents
|
|
12
|
+
* 2. Select target agents (multi-select)
|
|
13
|
+
* 3. Select installation scope (project/global)
|
|
14
|
+
* 4. Select installation method (symlink/copy)
|
|
15
|
+
* 5. Confirm and execute
|
|
8
16
|
*/
|
|
9
17
|
export declare const installCommand: Command;
|
|
10
18
|
export default installCommand;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,SA4XvB,CAAC;AAEL,eAAe,cAAc,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;GAEG;AACH,eAAO,MAAM,WAAW,SAmCpB,CAAC;AAEL,eAAe,WAAW,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"outdated.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/outdated.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"outdated.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/outdated.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AACH,eAAO,MAAM,eAAe,SA2DxB,CAAC;AAEL,eAAe,eAAe,CAAC"}
|