reskill 0.11.0 → 0.12.1

package/README.md

@@ -19,13 +19,13 @@ English | [简体中文](./README.zh-CN.md)
 
 ```bash
 # 1. Initialize project
-reskill init
+npx reskill init
 
 # 2. Install a skill
-reskill install github:anthropics/skills/frontend-design@latest
+npx reskill install github:anthropics/skills/frontend-design@latest
 
 # 3. List installed skills
-reskill list
+npx reskill list
 ```
 
 ## What is reskill?
@@ -89,19 +89,19 @@ npx reskill <command>
 
 ```bash
 # GitHub shorthand
-reskill install github:user/skill@v1.0.0
+npx reskill install github:user/skill@v1.0.0
 
 # Full URL
-reskill install https://github.com/user/skill
+npx reskill install https://github.com/user/skill
 
 # GitLab
-reskill install gitlab:group/skill@latest
+npx reskill install gitlab:group/skill@latest
 
 # Private registry
-reskill install gitlab.company.com:team/skill@v1.0.0
+npx reskill install gitlab.company.com:team/skill@v1.0.0
 
 # Default registry (from skills.json)
-reskill install user/skill@v1.0.0
+npx reskill install user/skill@v1.0.0
 ```
 
 ### Version Specification
@@ -116,19 +116,105 @@ reskill install user/skill@v1.0.0
 
 ## Commands
 
+You can use `npx reskill` directly without global installation:
+
+```bash
+# Initialize project
+npx reskill init
+
+# Install a skill from GitHub
+npx reskill install github:anthropics/skills/frontend-design@latest
+
+# Install from private GitLab
+npx reskill install gitlab.company.com:team/internal-skill@v1.0.0
+
+# List installed skills
+npx reskill list
+```
+
+### Command Reference
+
 | Command | Description |
 |---------|-------------|
-| `reskill init` | Initialize `skills.json` in current directory |
-| `reskill install [skill]` | Install skills from `skills.json` or a specific skill |
-| `reskill list` | List installed skills |
-| `reskill info <skill>` | Show skill details |
-| `reskill update [skill]` | Update all or specific skill |
-| `reskill outdated` | Check for outdated skills |
-| `reskill uninstall <skill>` | Remove a skill |
-| `reskill link <path>` | Link local skill for development |
-| `reskill unlink <skill>` | Unlink a local skill |
-
-Run `reskill <command> --help` for detailed options.
+| `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.
+
+## Private GitLab Support
+
+reskill fully supports private GitLab repositories, including self-hosted instances. Authentication is handled transparently through your system's git configuration.
+
+### Authentication Methods
+
+**SSH (Recommended)**
+
+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
+
+# Or with explicit SSH URL
+npx reskill 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.
+
+**HTTPS with Git Credential**
+
+For CI/CD or environments without SSH, configure git credential helper:
+
+```bash
+# Store credentials (will prompt once, then remember)
+git config --global credential.helper store
+
+# Or use environment variable in CI
+git config --global credential.helper '!f() { echo "username=oauth2"; echo "password=${GITLAB_TOKEN}"; }; f'
+```
+
+For GitLab CI/CD, use the built-in `CI_JOB_TOKEN`:
+
+```yaml
+before_script:
+  - git config --global url."https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.company.com/".insteadOf "https://gitlab.company.com/"
+```
+
+### Registry Configuration
+
+Configure private registries in `skills.json`:
+
+```json
+{
+  "registries": {
+    "internal": "https://gitlab.company.com",
+    "private": "git@gitlab.internal.io"
+  },
+  "skills": {
+    "company-standards": "internal:team/standards@latest",
+    "private-utils": "private:utils/helpers@v1.0.0"
+  }
+}
+```
+
+### Self-Hosted GitLab
+
+For self-hosted GitLab instances with custom domains:
+
+```bash
+# Direct installation
+npx reskill 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
+```
 
 ## Configuration
 
@@ -215,7 +301,7 @@ my-project/
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `SKPM_CACHE_DIR` | Global cache directory | `~/.reskill-cache` |
+| `RESKILL_CACHE_DIR` | Global cache directory | `~/.reskill-cache` |
 | `DEBUG` | Enable debug logging | - |
 
 ## Development

package/README.zh-CN.md

@@ -19,13 +19,13 @@
 
 ```bash
 # 1. 初始化项目
-reskill init
+npx reskill init
 
 # 2. 安装 skill
-reskill install github:anthropics/skills/frontend-design@latest
+npx reskill install github:anthropics/skills/frontend-design@latest
 
 # 3. 列出已安装的 skills
-reskill list
+npx reskill list
 ```
 
 ## 什么是 reskill？
@@ -90,19 +90,19 @@ npx reskill <command>
 
 ```bash
 # GitHub 简写
-reskill install github:user/skill@v1.0.0
+npx reskill install github:user/skill@v1.0.0
 
 # 完整 URL
-reskill install https://github.com/user/skill
+npx reskill install https://github.com/user/skill
 
 # GitLab
-reskill install gitlab:group/skill@latest
+npx reskill install gitlab:group/skill@latest
 
 # 私有 Registry
-reskill install gitlab.company.com:team/skill@v1.0.0
+npx reskill install gitlab.company.com:team/skill@v1.0.0
 
 # 默认 Registry（来自 skills.json）
-reskill install user/skill@v1.0.0
+npx reskill install user/skill@v1.0.0
 ```
 
 ### 版本规范
@@ -117,19 +117,105 @@ reskill install user/skill@v1.0.0
 
 ## 命令
 
+无需全局安装，直接使用 `npx reskill`：
+
+```bash
+# 初始化项目
+npx reskill init
+
+# 从 GitHub 安装 skill
+npx reskill install github:anthropics/skills/frontend-design@latest
+
+# 从私有 GitLab 安装
+npx reskill install gitlab.company.com:team/internal-skill@v1.0.0
+
+# 列出已安装的 skills
+npx reskill list
+```
+
+### 命令参考
+
 | 命令 | 说明 |
 |------|------|
-| `reskill init` | 在当前目录初始化 `skills.json` |
-| `reskill install [skill]` | 安装 `skills.json` 中的所有 skills 或指定 skill |
-| `reskill list` | 列出已安装的 skills |
-| `reskill info <skill>` | 查看 skill 详情 |
-| `reskill update [skill]` | 更新所有或指定 skill |
-| `reskill outdated` | 检查过期的 skills |
-| `reskill uninstall <skill>` | 卸载 skill |
-| `reskill link <path>` | 链接本地 skill（开发用） |
-| `reskill unlink <skill>` | 取消链接本地 skill |
-
-运行 `reskill <command> --help` 查看详细选项。
+| `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 <command> --help` 查看详细选项。
+
+## 私有 GitLab 支持
+
+reskill 完整支持私有 GitLab 仓库，包括自建实例。认证通过系统的 git 配置透明处理。
+
+### 认证方式
+
+**SSH（推荐）**
+
+reskill 自动使用你已有的 SSH 配置：
+
+```bash
+# 自动使用 ~/.ssh/id_rsa 或 ~/.ssh/id_ed25519
+npx reskill 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
+```
+
+确保你的 SSH key 已添加到 GitLab，并且 ssh-agent 正在运行。
+
+**HTTPS + Git Credential**
+
+适用于 CI/CD 或无 SSH 的环境，配置 git credential helper：
+
+```bash
+# 存储凭证（首次会提示输入，之后自动记住）
+git config --global credential.helper store
+
+# 或在 CI 中使用环境变量
+git config --global credential.helper '!f() { echo "username=oauth2"; echo "password=${GITLAB_TOKEN}"; }; f'
+```
+
+GitLab CI/CD 可使用内置的 `CI_JOB_TOKEN`：
+
+```yaml
+before_script:
+  - git config --global url."https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.company.com/".insteadOf "https://gitlab.company.com/"
+```
+
+### Registry 配置
+
+在 `skills.json` 中配置私有 registry：
+
+```json
+{
+  "registries": {
+    "internal": "https://gitlab.company.com",
+    "private": "git@gitlab.internal.io"
+  },
+  "skills": {
+    "company-standards": "internal:team/standards@latest",
+    "private-utils": "private:utils/helpers@v1.0.0"
+  }
+}
+```
+
+### 自建 GitLab
+
+对于使用自定义域名的自建 GitLab 实例：
+
+```bash
+# 直接安装
+npx reskill install git.mycompany.io:team/skill@v1.0.0
+
+# 使用显式的 SSH URL
+npx reskill install git@git.mycompany.io:team/skill.git@v1.0.0
+```
 
 ## 配置
 
@@ -216,7 +302,7 @@ my-project/
 
 | 变量 | 说明 | 默认值 |
 |------|------|--------|
-| `SKPM_CACHE_DIR` | 全局缓存目录 | `~/.reskill-cache` |
+| `RESKILL_CACHE_DIR` | 全局缓存目录 | `~/.reskill-cache` |
 | `DEBUG` | 启用调试日志 | - |
 
 ## 开发

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

@@ -1,9 +1,9 @@
+export { infoCommand } from './info.js';
 export { initCommand } from './init.js';
 export { installCommand } from './install.js';
+export { linkCommand, unlinkCommand } from './link.js';
 export { listCommand } from './list.js';
-export { infoCommand } from './info.js';
-export { updateCommand } from './update.js';
 export { outdatedCommand } from './outdated.js';
 export { uninstallCommand } from './uninstall.js';
-export { linkCommand, unlinkCommand } from './link.js';
+export { updateCommand } from './update.js';
 //# sourceMappingURL=index.d.ts.map

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,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}
+{"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"}

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

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 /**
- * info 命令 - 查看 skill 详情
+ * info command - Show skill details
  */
 export declare const infoCommand: Command;
 export default infoCommand;

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

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 /**
- * init 命令 - 初始化 skills.json
+ * init command - Initialize skills.json configuration
  */
 export declare const initCommand: Command;
 export default initCommand;

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

@@ -1,18 +1,18 @@
 import { Command } from 'commander';
 /**
- * install 命令 - 安装 skill
+ * install command - Install a skill
  *
- * 支持多种安装模式:
- * - 项目安装 (默认): 安装到项目目录
- * - 全局安装 (-g): 安装到用户目录
- * - 多 Agent 安装 (-a): 安装到指定 agents
+ * Supports multiple installation modes:
+ * - Project install (default): Install to project directory
+ * - Global install (-g): Install to user home directory
+ * - Multi-Agent install (-a): Install to specified agents
  *
- * 交互式流程:
- * 1. 检测已安装的 agents
- * 2. 选择目标 agents（多选）
- * 3. 选择安装范围 (项目/全局)
- * 4. 选择安装方式 (symlink/copy)
- * 5. 确认并执行
+ * Interactive flow:
+ * 1. Detect installed agents
+ * 2. Select target agents (multi-select)
+ * 3. Select installation scope (project/global)
+ * 4. Select installation method (symlink/copy)
+ * 5. Confirm and execute
  */
 export declare const installCommand: Command;
 export default installCommand;

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

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,SAiavB,CAAC;AAEL,eAAe,cAAc,CAAC"}
+{"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"}

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

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 /**
- * list 命令 - 列出已安装的 skills
+ * list command - List installed skills
  */
 export declare const listCommand: Command;
 export default listCommand;

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

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;GAEG;AACH,eAAO,MAAM,WAAW,SAmCpB,CAAC;AAEL,eAAe,WAAW,CAAC"}
+{"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"}

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

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 /**
- * outdated 命令 - 检查过期的 skills
+ * outdated command - Check for outdated skills
  */
 export declare const outdatedCommand: Command;
 export default outdatedCommand;

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

@@ -1 +1 @@
-{"version":3,"file":"outdated.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/outdated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;GAEG;AACH,eAAO,MAAM,eAAe,SA6DxB,CAAC;AAEL,eAAe,eAAe,CAAC"}
+{"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"}

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

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 /**
- * uninstall 命令 - 卸载 skill
+ * uninstall command - Uninstall a skill
  */
 export declare const uninstallCommand: Command;
 export default uninstallCommand;

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

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 /**
- * update 命令 - 更新 skill
+ * update command - Update installed skills
  */
 export declare const updateCommand: Command;
 export default updateCommand;