reskill 0.13.1 → 0.15.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.
Files changed (18) hide show
  1. package/README.md +39 -31
  2. package/README.zh-CN.md +39 -31
  3. package/dist/cli/index.js +207 -134
  4. package/dist/core/git-resolver.d.ts +1 -0
  5. package/dist/core/git-resolver.d.ts.map +1 -1
  6. package/dist/core/lock-manager.d.ts +1 -0
  7. package/dist/core/lock-manager.d.ts.map +1 -1
  8. package/dist/core/skill-manager.d.ts.map +1 -1
  9. package/dist/index.js +74 -39
  10. package/dist/types/index.d.ts +3 -1
  11. package/dist/types/index.d.ts.map +1 -1
  12. package/dist/utils/git.d.ts +3 -0
  13. package/dist/utils/git.d.ts.map +1 -1
  14. package/dist/utils/index.d.ts +1 -0
  15. package/dist/utils/index.d.ts.map +1 -1
  16. package/dist/utils/update-notifier.d.ts +49 -0
  17. package/dist/utils/update-notifier.d.ts.map +1 -0
  18. package/package.json +1 -1
package/README.md CHANGED
@@ -19,13 +19,13 @@ English | [简体中文](./README.zh-CN.md)
19
19
 
20
20
  ```bash
21
21
  # 1. Initialize project
22
- npx reskill init
22
+ npx reskill@latest init
23
23
 
24
24
  # 2. Install a skill
25
- npx reskill install github:anthropics/skills/frontend-design@latest
25
+ npx reskill@latest install github:anthropics/skills/frontend-design@latest
26
26
 
27
27
  # 3. List installed skills
28
- npx reskill list
28
+ npx reskill@latest list
29
29
  ```
30
30
 
31
31
  ## What is reskill?
@@ -76,32 +76,40 @@ When running `reskill update`:
76
76
  ## Installation
77
77
 
78
78
  ```bash
79
- # Global install
79
+ # Global install (recommended for regular use)
80
80
  npm install -g reskill
81
81
 
82
- # Or use npx
82
+ # Or use npx with @latest (recommended for ongoing skill management)
83
+ npx reskill@latest <command>
84
+
85
+ # For one-time use, npx reskill also works
83
86
  npx reskill <command>
84
87
  ```
85
88
 
89
+ > **Note:** When using `npx`, we recommend `npx reskill@latest` to ensure you always get the latest version. Without `@latest`, npx may use a cached older version.
90
+
86
91
  ## Usage
87
92
 
88
93
  ### Source Formats
89
94
 
90
95
  ```bash
91
96
  # GitHub shorthand
92
- npx reskill install github:user/skill@v1.0.0
97
+ npx reskill@latest install github:user/skill@v1.0.0
98
+
99
+ # Full Git URL
100
+ npx reskill@latest install https://github.com/user/skill.git
93
101
 
94
- # Full URL
95
- npx reskill install https://github.com/user/skill
102
+ # GitHub web URL (with branch and subpath)
103
+ npx reskill@latest install https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines
96
104
 
97
105
  # GitLab
98
- npx reskill install gitlab:group/skill@latest
106
+ npx reskill@latest install gitlab:group/skill@latest
99
107
 
100
108
  # Private registry
101
- npx reskill install gitlab.company.com:team/skill@v1.0.0
109
+ npx reskill@latest install gitlab.company.com:team/skill@v1.0.0
102
110
 
103
111
  # Default registry (from skills.json)
104
- npx reskill install user/skill@v1.0.0
112
+ npx reskill@latest install user/skill@v1.0.0
105
113
  ```
106
114
 
107
115
  ### Version Specification
@@ -116,37 +124,37 @@ npx reskill install user/skill@v1.0.0
116
124
 
117
125
  ## Commands
118
126
 
119
- You can use `npx reskill` directly without global installation:
127
+ You can use `npx reskill@latest` directly without global installation:
120
128
 
121
129
  ```bash
122
130
  # Initialize project
123
- npx reskill init
131
+ npx reskill@latest init
124
132
 
125
133
  # Install a skill from GitHub
126
- npx reskill install github:anthropics/skills/frontend-design@latest
134
+ npx reskill@latest install github:anthropics/skills/frontend-design@latest
127
135
 
128
136
  # Install from private GitLab
129
- npx reskill install gitlab.company.com:team/internal-skill@v1.0.0
137
+ npx reskill@latest install gitlab.company.com:team/internal-skill@v1.0.0
130
138
 
131
139
  # List installed skills
132
- npx reskill list
140
+ npx reskill@latest list
133
141
  ```
134
142
 
135
143
  ### Command Reference
136
144
 
137
145
  | Command | Description |
138
146
  |---------|-------------|
139
- | `npx reskill init` | Initialize `skills.json` in current directory |
140
- | `npx reskill install [skill]` | Install skills from `skills.json` or a specific skill |
141
- | `npx reskill list` | List installed skills |
142
- | `npx reskill info <skill>` | Show skill details |
143
- | `npx reskill update [skill]` | Update all or specific skill |
144
- | `npx reskill outdated` | Check for outdated skills |
145
- | `npx reskill uninstall <skill>` | Remove a skill |
146
- | `npx reskill link <path>` | Link local skill for development |
147
- | `npx reskill unlink <skill>` | Unlink a local skill |
148
-
149
- Run `npx reskill <command> --help` for detailed options.
147
+ | `npx reskill@latest init` | Initialize `skills.json` in current directory |
148
+ | `npx reskill@latest install [skill]` | Install skills from `skills.json` or a specific skill |
149
+ | `npx reskill@latest list` | List installed skills |
150
+ | `npx reskill@latest info <skill>` | Show skill details |
151
+ | `npx reskill@latest update [skill]` | Update all or specific skill |
152
+ | `npx reskill@latest outdated` | Check for outdated skills |
153
+ | `npx reskill@latest uninstall <skill>` | Remove a skill |
154
+ | `npx reskill@latest link <path>` | Link local skill for development |
155
+ | `npx reskill@latest unlink <skill>` | Unlink a local skill |
156
+
157
+ Run `npx reskill@latest <command> --help` for detailed options.
150
158
 
151
159
  ## Private GitLab Support
152
160
 
@@ -160,10 +168,10 @@ reskill uses your existing SSH configuration automatically:
160
168
 
161
169
  ```bash
162
170
  # Uses your ~/.ssh/id_rsa or ~/.ssh/id_ed25519 automatically
163
- npx reskill install gitlab.company.com:team/private-skill@v1.0.0
171
+ npx reskill@latest install gitlab.company.com:team/private-skill@v1.0.0
164
172
 
165
173
  # Or with explicit SSH URL
166
- npx reskill install git@gitlab.company.com:team/private-skill.git@v1.0.0
174
+ npx reskill@latest install git@gitlab.company.com:team/private-skill.git@v1.0.0
167
175
  ```
168
176
 
169
177
  Ensure your SSH key is added to GitLab and ssh-agent is running.
@@ -210,10 +218,10 @@ For self-hosted GitLab instances with custom domains:
210
218
 
211
219
  ```bash
212
220
  # Direct installation
213
- npx reskill install git.mycompany.io:team/skill@v1.0.0
221
+ npx reskill@latest install git.mycompany.io:team/skill@v1.0.0
214
222
 
215
223
  # With explicit SSH URL
216
- npx reskill install git@git.mycompany.io:team/skill.git@v1.0.0
224
+ npx reskill@latest install git@git.mycompany.io:team/skill.git@v1.0.0
217
225
  ```
218
226
 
219
227
  ## Configuration
package/README.zh-CN.md CHANGED
@@ -19,13 +19,13 @@
19
19
 
20
20
  ```bash
21
21
  # 1. 初始化项目
22
- npx reskill init
22
+ npx reskill@latest init
23
23
 
24
24
  # 2. 安装 skill
25
- npx reskill install github:anthropics/skills/frontend-design@latest
25
+ npx reskill@latest install github:anthropics/skills/frontend-design@latest
26
26
 
27
27
  # 3. 列出已安装的 skills
28
- npx reskill list
28
+ npx reskill@latest list
29
29
  ```
30
30
 
31
31
  ## 什么是 reskill？
@@ -77,32 +77,40 @@ reskill 提供**精细化的 skill 管理和同步方案**：
77
77
  ## 安装
78
78
 
79
79
  ```bash
80
- # 全局安装
80
+ # 全局安装（推荐常态化使用）
81
81
  npm install -g reskill
82
82
 
83
- # 或使用 npx
83
+ # 或使用 npx（推荐加 @latest 确保最新版本）
84
+ npx reskill@latest <command>
85
+
86
+ # 单次使用也可以直接 npx reskill
84
87
  npx reskill <command>
85
88
  ```
86
89
 
90
+ > **注意：** 使用 `npx` 时，建议使用 `npx reskill@latest` 以确保使用最新版本。不加 `@latest` 时，npx 可能会使用缓存的旧版本。
91
+
87
92
  ## 使用方式
88
93
 
89
94
  ### 源格式
90
95
 
91
96
  ```bash
92
97
  # GitHub 简写
93
- npx reskill install github:user/skill@v1.0.0
98
+ npx reskill@latest install github:user/skill@v1.0.0
99
+
100
+ # 完整 Git URL
101
+ npx reskill@latest install https://github.com/user/skill.git
94
102
 
95
- # 完整 URL
96
- npx reskill install https://github.com/user/skill
103
+ # GitHub 网页 URL（支持分支和子路径）
104
+ npx reskill@latest install https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines
97
105
 
98
106
  # GitLab
99
- npx reskill install gitlab:group/skill@latest
107
+ npx reskill@latest install gitlab:group/skill@latest
100
108
 
101
109
  # 私有 Registry
102
- npx reskill install gitlab.company.com:team/skill@v1.0.0
110
+ npx reskill@latest install gitlab.company.com:team/skill@v1.0.0
103
111
 
104
112
  # 默认 Registry（来自 skills.json）
105
- npx reskill install user/skill@v1.0.0
113
+ npx reskill@latest install user/skill@v1.0.0
106
114
  ```
107
115
 
108
116
  ### 版本规范
@@ -117,37 +125,37 @@ npx reskill install user/skill@v1.0.0
117
125
 
118
126
  ## 命令
119
127
 
120
- 无需全局安装，直接使用 `npx reskill`：
128
+ 无需全局安装，直接使用 `npx reskill@latest`：
121
129
 
122
130
  ```bash
123
131
  # 初始化项目
124
- npx reskill init
132
+ npx reskill@latest init
125
133
 
126
134
  # 从 GitHub 安装 skill
127
- npx reskill install github:anthropics/skills/frontend-design@latest
135
+ npx reskill@latest install github:anthropics/skills/frontend-design@latest
128
136
 
129
137
  # 从私有 GitLab 安装
130
- npx reskill install gitlab.company.com:team/internal-skill@v1.0.0
138
+ npx reskill@latest install gitlab.company.com:team/internal-skill@v1.0.0
131
139
 
132
140
  # 列出已安装的 skills
133
- npx reskill list
141
+ npx reskill@latest list
134
142
  ```
135
143
 
136
144
  ### 命令参考
137
145
 
138
146
  | 命令 | 说明 |
139
147
  |------|------|
140
- | `npx reskill init` | 在当前目录初始化 `skills.json` |
141
- | `npx reskill install [skill]` | 安装 `skills.json` 中的所有 skills 或指定 skill |
142
- | `npx reskill list` | 列出已安装的 skills |
143
- | `npx reskill info <skill>` | 查看 skill 详情 |
144
- | `npx reskill update [skill]` | 更新所有或指定 skill |
145
- | `npx reskill outdated` | 检查过期的 skills |
146
- | `npx reskill uninstall <skill>` | 卸载 skill |
147
- | `npx reskill link <path>` | 链接本地 skill（开发用） |
148
- | `npx reskill unlink <skill>` | 取消链接本地 skill |
149
-
150
- 运行 `npx reskill <command> --help` 查看详细选项。
148
+ | `npx reskill@latest init` | 在当前目录初始化 `skills.json` |
149
+ | `npx reskill@latest install [skill]` | 安装 `skills.json` 中的所有 skills 或指定 skill |
150
+ | `npx reskill@latest list` | 列出已安装的 skills |
151
+ | `npx reskill@latest info <skill>` | 查看 skill 详情 |
152
+ | `npx reskill@latest update [skill]` | 更新所有或指定 skill |
153
+ | `npx reskill@latest outdated` | 检查过期的 skills |
154
+ | `npx reskill@latest uninstall <skill>` | 卸载 skill |
155
+ | `npx reskill@latest link <path>` | 链接本地 skill（开发用） |
156
+ | `npx reskill@latest unlink <skill>` | 取消链接本地 skill |
157
+
158
+ 运行 `npx reskill@latest <command> --help` 查看详细选项。
151
159
 
152
160
  ## 私有 GitLab 支持
153
161
 
@@ -161,10 +169,10 @@ reskill 自动使用你已有的 SSH 配置：
161
169
 
162
170
  ```bash
163
171
  # 自动使用 ~/.ssh/id_rsa 或 ~/.ssh/id_ed25519
164
- npx reskill install gitlab.company.com:team/private-skill@v1.0.0
172
+ npx reskill@latest install gitlab.company.com:team/private-skill@v1.0.0
165
173
 
166
174
  # 或使用显式的 SSH URL
167
- npx reskill install git@gitlab.company.com:team/private-skill.git@v1.0.0
175
+ npx reskill@latest install git@gitlab.company.com:team/private-skill.git@v1.0.0
168
176
  ```
169
177
 
170
178
  确保你的 SSH key 已添加到 GitLab，并且 ssh-agent 正在运行。
@@ -211,10 +219,10 @@ before_script:
211
219
 
212
220
  ```bash
213
221
  # 直接安装
214
- npx reskill install git.mycompany.io:team/skill@v1.0.0
222
+ npx reskill@latest install git.mycompany.io:team/skill@v1.0.0
215
223
 
216
224
  # 使用显式的 SSH URL
217
- npx reskill install git@git.mycompany.io:team/skill.git@v1.0.0
225
+ npx reskill@latest install git@git.mycompany.io:team/skill.git@v1.0.0
218
226
  ```
219
227
 
220
228
  ## 配置