reskill 0.14.0 → 0.16.0

package/README.md

@@ -19,13 +19,13 @@ English | [简体中文](./README.zh-CN.md)
 
 ```bash
 # 1. Initialize project
-npx reskill init
+npx reskill@latest init
 
 # 2. Install a skill
-npx reskill install github:anthropics/skills/frontend-design@latest
+npx reskill@latest install github:anthropics/skills/frontend-design@latest
 
 # 3. List installed skills
-npx reskill list
+npx reskill@latest list
 ```
 
 ## What is reskill?
@@ -76,35 +76,40 @@ When running `reskill update`:
 ## Installation
 
 ```bash
-# Global install
+# Global install (recommended for regular use)
 npm install -g reskill
 
-# Or use npx
+# Or use npx with @latest (recommended for ongoing skill management)
+npx reskill@latest <command>
+
+# For one-time use, npx reskill also works
 npx reskill <command>
 ```
 
+> **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.
+
 ## Usage
 
 ### Source Formats
 
 ```bash
 # GitHub shorthand
-npx reskill install github:user/skill@v1.0.0
+npx reskill@latest install github:user/skill@v1.0.0
 
 # Full Git URL
-npx reskill install https://github.com/user/skill.git
+npx reskill@latest install https://github.com/user/skill.git
 
 # GitHub web URL (with branch and subpath)
-npx reskill install https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines
+npx reskill@latest install https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines
 
 # GitLab
-npx reskill install gitlab:group/skill@latest
+npx reskill@latest install gitlab:group/skill@latest
 
 # Private registry
-npx reskill install gitlab.company.com:team/skill@v1.0.0
+npx reskill@latest install gitlab.company.com:team/skill@v1.0.0
 
 # Default registry (from skills.json)
-npx reskill install user/skill@v1.0.0
+npx reskill@latest install user/skill@v1.0.0
 ```
 
 ### Version Specification
@@ -119,37 +124,63 @@ npx reskill install user/skill@v1.0.0
 
 ## Commands
 
-You can use `npx reskill` directly without global installation:
+You can use `npx reskill@latest` directly without global installation:
 
 ```bash
 # Initialize project
-npx reskill init
+npx reskill@latest init
 
 # Install a skill from GitHub
-npx reskill install github:anthropics/skills/frontend-design@latest
+npx reskill@latest install github:anthropics/skills/frontend-design@latest
 
 # Install from private GitLab
-npx reskill install gitlab.company.com:team/internal-skill@v1.0.0
+npx reskill@latest install gitlab.company.com:team/internal-skill@v1.0.0
 
 # List installed skills
-npx reskill list
+npx reskill@latest list
 ```
 
 ### Command Reference
 
 | Command | Description |
 |---------|-------------|
-| `npx reskill init` | Initialize `skills.json` in current directory |
-| `npx reskill install [skill]` | Install skills from `skills.json` or a specific skill |
-| `npx reskill list` | List installed skills |
-| `npx reskill info <skill>` | Show skill details |
-| `npx reskill update [skill]` | Update all or specific skill |
-| `npx reskill outdated` | Check for outdated skills |
-| `npx reskill uninstall <skill>` | Remove a skill |
-| `npx reskill link <path>` | Link local skill for development |
-| `npx reskill unlink <skill>` | Unlink a local skill |
-
-Run `npx reskill <command> --help` for detailed options.
+| `npx reskill@latest init` | Initialize `skills.json` in current directory |
+| `npx reskill@latest install [skill]` | Install skills from `skills.json` or a specific skill |
+| `npx reskill@latest list` | List installed skills |
+| `npx reskill@latest info <skill>` | Show skill details |
+| `npx reskill@latest update [skill]` | Update all or specific skill |
+| `npx reskill@latest outdated` | Check for outdated skills |
+| `npx reskill@latest uninstall <skill>` | Remove a skill |
+| `npx reskill@latest link <path>` | Link local skill for development |
+| `npx reskill@latest unlink <skill>` | Unlink a local skill |
+| `npx reskill@latest completion install` | Install shell tab completion |
+
+Run `npx reskill@latest <command> --help` for detailed options.
+
+### Shell Completion
+
+reskill supports tab completion for bash, zsh, and fish shells.
+
+```bash
+# Install completion (interactive, one-time setup)
+reskill completion install
+
+# Then restart your shell or run:
+source ~/.zshrc   # for zsh
+source ~/.bashrc  # for bash
+```
+
+After installation, you can use tab completion:
+
+```bash
+reskill <Tab>              # Show all commands
+reskill info <Tab>         # Complete installed skill names
+reskill uninstall <Tab>    # Complete installed skill names
+reskill install -<Tab>     # Complete options (-f, -g, -a, etc.)
+reskill install -a <Tab>   # Complete agent names
+```
+
+To remove completion: `reskill completion uninstall`
 
 ## Private GitLab Support
 
@@ -163,10 +194,10 @@ reskill uses your existing SSH configuration automatically:
 
 ```bash
 # Uses your ~/.ssh/id_rsa or ~/.ssh/id_ed25519 automatically
-npx reskill install gitlab.company.com:team/private-skill@v1.0.0
+npx reskill@latest install gitlab.company.com:team/private-skill@v1.0.0
 
 # Or with explicit SSH URL
-npx reskill install git@gitlab.company.com:team/private-skill.git@v1.0.0
+npx reskill@latest install git@gitlab.company.com:team/private-skill.git@v1.0.0
 ```
 
 Ensure your SSH key is added to GitLab and ssh-agent is running.
@@ -213,10 +244,10 @@ For self-hosted GitLab instances with custom domains:
 
 ```bash
 # Direct installation
-npx reskill install git.mycompany.io:team/skill@v1.0.0
+npx reskill@latest install git.mycompany.io:team/skill@v1.0.0
 
 # With explicit SSH URL
-npx reskill install git@git.mycompany.io:team/skill.git@v1.0.0
+npx reskill@latest install git@git.mycompany.io:team/skill.git@v1.0.0
 ```
 
 ## Configuration

package/README.zh-CN.md

@@ -19,13 +19,13 @@
 
 ```bash
 # 1. 初始化项目
-npx reskill init
+npx reskill@latest init
 
 # 2. 安装 skill
-npx reskill install github:anthropics/skills/frontend-design@latest
+npx reskill@latest install github:anthropics/skills/frontend-design@latest
 
 # 3. 列出已安装的 skills
-npx reskill list
+npx reskill@latest list
 ```
 
 ## 什么是 reskill？
@@ -77,80 +77,111 @@ reskill 提供**精细化的 skill 管理和同步方案**：
 ## 安装
 
 ```bash
-# 全局安装
+# 全局安装（推荐常态化使用）
 npm install -g reskill
 
-# 或使用 npx
+# 或使用 npx（推荐加 @latest 确保最新版本）
+npx reskill@latest <command>
+
+# 单次使用也可以直接 npx reskill
 npx reskill <command>
 ```
 
+> **注意：** 使用 `npx` 时，建议使用 `npx reskill@latest` 以确保使用最新版本。不加 `@latest` 时，npx 可能会使用缓存的旧版本。
+
 ## 使用方式
 
 ### 源格式
 
 ```bash
 # GitHub 简写
-npx reskill install github:user/skill@v1.0.0
+npx reskill@latest install github:user/skill@v1.0.0
 
 # 完整 Git URL
-npx reskill install https://github.com/user/skill.git
+npx reskill@latest install https://github.com/user/skill.git
 
 # GitHub 网页 URL（支持分支和子路径）
-npx reskill install https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines
+npx reskill@latest install https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines
 
 # GitLab
-npx reskill install gitlab:group/skill@latest
+npx reskill@latest install gitlab:group/skill@latest
 
 # 私有 Registry
-npx reskill install gitlab.company.com:team/skill@v1.0.0
+npx reskill@latest install gitlab.company.com:team/skill@v1.0.0
 
 # 默认 Registry（来自 skills.json）
-npx reskill install user/skill@v1.0.0
+npx reskill@latest install user/skill@v1.0.0
 ```
 
 ### 版本规范
 
-| 格式 | 示例 | 说明 |
-|------|------|------|
-| 精确版本 | `@v1.0.0` | 锁定到指定 tag |
-| 最新版本 | `@latest` | 获取最新 tag |
-| 范围版本 | `@^2.0.0` | semver 兼容（>=2.0.0 <3.0.0） |
-| 分支 | `@branch:develop` | 指定分支 |
-| Commit | `@commit:abc1234` | 指定 commit hash |
+| 格式     | 示例              | 说明                          |
+| -------- | ----------------- | ----------------------------- |
+| 精确版本 | `@v1.0.0`         | 锁定到指定 tag                |
+| 最新版本 | `@latest`         | 获取最新 tag                  |
+| 范围版本 | `@^2.0.0`         | semver 兼容（>=2.0.0 <3.0.0） |
+| 分支     | `@branch:develop` | 指定分支                      |
+| Commit   | `@commit:abc1234` | 指定 commit hash              |
 
 ## 命令
 
-无需全局安装，直接使用 `npx reskill`：
+无需全局安装，直接使用 `npx reskill@latest`：
 
 ```bash
 # 初始化项目
-npx reskill init
+npx reskill@latest init
 
 # 从 GitHub 安装 skill
-npx reskill install github:anthropics/skills/frontend-design@latest
+npx reskill@latest install github:anthropics/skills/frontend-design@latest
 
 # 从私有 GitLab 安装
-npx reskill install gitlab.company.com:team/internal-skill@v1.0.0
+npx reskill@latest install gitlab.company.com:team/internal-skill@v1.0.0
 
 # 列出已安装的 skills
-npx reskill list
+npx reskill@latest list
 ```
 
 ### 命令参考
 
-| 命令 | 说明 |
-|------|------|
-| `npx reskill init` | 在当前目录初始化 `skills.json` |
-| `npx reskill install [skill]` | 安装 `skills.json` 中的所有 skills 或指定 skill |
-| `npx reskill list` | 列出已安装的 skills |
-| `npx reskill info <skill>` | 查看 skill 详情 |
-| `npx reskill update [skill]` | 更新所有或指定 skill |
-| `npx reskill outdated` | 检查过期的 skills |
-| `npx reskill uninstall <skill>` | 卸载 skill |
-| `npx reskill link <path>` | 链接本地 skill（开发用） |
-| `npx reskill unlink <skill>` | 取消链接本地 skill |
+| 命令                                    | 说明                                            |
+| --------------------------------------- | ----------------------------------------------- |
+| `npx reskill@latest init`               | 在当前目录初始化 `skills.json`                  |
+| `npx reskill@latest install [skill]`    | 安装 `skills.json` 中的所有 skills 或指定 skill |
+| `npx reskill@latest list`               | 列出已安装的 skills                             |
+| `npx reskill@latest info <skill>`       | 查看 skill 详情                                 |
+| `npx reskill@latest update [skill]`     | 更新所有或指定 skill                            |
+| `npx reskill@latest outdated`           | 检查过期的 skills                               |
+| `npx reskill@latest uninstall <skill>`  | 卸载 skill                                      |
+| `npx reskill@latest link <path>`        | 链接本地 skill（开发用）                        |
+| `npx reskill@latest unlink <skill>`     | 取消链接本地 skill                              |
+| `npx reskill@latest completion install` | 安装 Shell Tab 补全                             |
+
+运行 `npx reskill@latest <command> --help` 查看详细选项。
+
+### Shell 补全
+
+reskill 支持 bash、zsh 和 fish 的 Tab 补全。
+
+```bash
+# 安装补全（交互式，一次性设置）
+reskill completion install
+
+# 然后重启 shell 或执行：
+source ~/.zshrc   # zsh
+source ~/.bashrc  # bash
+```
+
+安装后即可使用 Tab 补全：
+
+```bash
+reskill <Tab>              # 显示所有命令
+reskill info <Tab>         # 补全已安装的 skill 名称
+reskill uninstall <Tab>    # 补全已安装的 skill 名称
+reskill install -<Tab>     # 补全选项 (-f, -g, -a 等)
+reskill install -a <Tab>   # 补全 agent 名称
+```
 
-运行 `npx reskill <command> --help` 查看详细选项。
+卸载补全：`reskill completion uninstall`
 
 ## 私有 GitLab 支持
 
@@ -164,10 +195,10 @@ reskill 自动使用你已有的 SSH 配置：
 
 ```bash
 # 自动使用 ~/.ssh/id_rsa 或 ~/.ssh/id_ed25519
-npx reskill install gitlab.company.com:team/private-skill@v1.0.0
+npx reskill@latest install gitlab.company.com:team/private-skill@v1.0.0
 
 # 或使用显式的 SSH URL
-npx reskill install git@gitlab.company.com:team/private-skill.git@v1.0.0
+npx reskill@latest install git@gitlab.company.com:team/private-skill.git@v1.0.0
 ```
 
 确保你的 SSH key 已添加到 GitLab，并且 ssh-agent 正在运行。
@@ -214,10 +245,10 @@ before_script:
 
 ```bash
 # 直接安装
-npx reskill install git.mycompany.io:team/skill@v1.0.0
+npx reskill@latest install git.mycompany.io:team/skill@v1.0.0
 
 # 使用显式的 SSH URL
-npx reskill install git@git.mycompany.io:team/skill.git@v1.0.0
+npx reskill@latest install git@git.mycompany.io:team/skill.git@v1.0.0
 ```
 
 ## 配置
@@ -249,14 +280,14 @@ npx reskill install git@git.mycompany.io:team/skill.git@v1.0.0
 
 reskill 支持所有主流 AI 编程 Agent。Skills 默认安装到 `.skills/` 目录，可与任何 Agent 集成。
 
-| Agent | 集成路径 |
-|-------|----------|
-| Cursor | `.cursor/rules/` 或 `.cursor/skills/` |
-| Claude Code | `.claude/skills/` |
-| Codex | `.codex/skills/` |
-| OpenCode | `.opencode/skills/` |
-| Windsurf | `.windsurf/skills/` |
-| GitHub Copilot | `.github/skills/` |
+| Agent          | 集成路径                              |
+| -------------- | ------------------------------------- |
+| Cursor         | `.cursor/rules/` 或 `.cursor/skills/` |
+| Claude Code    | `.claude/skills/`                     |
+| Codex          | `.codex/skills/`                      |
+| OpenCode       | `.opencode/skills/`                   |
+| Windsurf       | `.windsurf/skills/`                   |
+| GitHub Copilot | `.github/skills/`                     |
 
 ## Skill 仓库结构
 
@@ -303,10 +334,10 @@ my-project/
 
 ## 环境变量
 
-| 变量 | 说明 | 默认值 |
-|------|------|--------|
+| 变量                | 说明         | 默认值             |
+| ------------------- | ------------ | ------------------ |
 | `RESKILL_CACHE_DIR` | 全局缓存目录 | `~/.reskill-cache` |
-| `DEBUG` | 启用调试日志 | - |
+| `DEBUG`             | 启用调试日志 | -                  |
 
 ## 开发
 

package/dist/cli/commands/completion.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+/**
+ * completion command - Setup shell completion
+ */
+export declare const completionCommand: Command;
+/**
+ * Check if completion is being requested and handle it
+ *
+ * This should be called at the start of CLI execution
+ */
+export declare function maybeHandleCompletion(): boolean;
+export default completionCommand;
+//# sourceMappingURL=completion.d.ts.map

package/dist/cli/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6KpC;;GAEG;AACH,eAAO,MAAM,iBAAiB,SA2D1B,CAAC;AAEL;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAO/C;AAED,eAAe,iBAAiB,CAAC"}

package/dist/cli/commands/index.d.ts

@@ -1,3 +1,4 @@
+export { completionCommand, maybeHandleCompletion } from './completion.js';
 export { infoCommand } from './info.js';
 export { initCommand } from './init.js';
 export { installCommand } from './install.js';

package/dist/cli/commands/index.d.ts.map

@@ -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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,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"}

package/dist/cli/commands/uninstall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/uninstall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;GAEG;AACH,eAAO,MAAM,gBAAgB,SAezB,CAAC;AAEL,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/uninstall.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;GAEG;AACH,eAAO,MAAM,gBAAgB,SAoEzB,CAAC;AAEL,eAAe,gBAAgB,CAAC"}