reskill 0.12.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/index.js

@@ -290,20 +290,32 @@ class GitCloneError extends Error {
     repoUrl;
     originalError;
     isAuthError;
+    urlType;
     constructor(repoUrl, originalError){
         const isAuthError = GitCloneError.isAuthenticationError(originalError.message);
+        const urlType = GitCloneError.detectUrlType(repoUrl);
         let message = `Failed to clone repository: ${repoUrl}`;
         if (isAuthError) {
-            message += '\n\nTip: For private repos, ensure git SSH keys or credentials are configured:';
-            message += '\n  - SSH: Check ~/.ssh/id_rsa or ~/.ssh/id_ed25519';
-            message += "\n  - HTTPS: Run 'git config --global credential.helper store'";
-            message += '\n  - Or use a personal access token in the URL';
+            message += '\n\nTip: For private repos, ensure git credentials are configured:';
+            if ('ssh' === urlType) {
+                message += '\n  - Check ~/.ssh/id_rsa or ~/.ssh/id_ed25519';
+                message += '\n  - Ensure SSH key is added to your Git hosting service';
+            } else {
+                message += "\n  - Run 'git config --global credential.helper store'";
+                message += '\n  - Or use a personal access token in the URL';
+            }
         }
         super(message);
         this.name = 'GitCloneError';
         this.repoUrl = repoUrl;
         this.originalError = originalError;
         this.isAuthError = isAuthError;
+        this.urlType = urlType;
+    }
+    static detectUrlType(url) {
+        if (url.startsWith('git@') || url.startsWith('ssh://')) return 'ssh';
+        if (url.startsWith('http://') || url.startsWith('https://')) return 'https';
+        return 'unknown';
     }
     static isAuthenticationError(message) {
         const authPatterns = [
@@ -614,6 +626,11 @@ class ConfigLoader {
         writeJson(this.configPath, toSave);
         this.config = toSave;
     }
+    ensureExists() {
+        if (this.exists()) return false;
+        this.create();
+        return true;
+    }
     create(options) {
         const config = {
             ...DEFAULT_SKILLS_JSON,
@@ -883,7 +900,8 @@ function installer_remove(targetPath) {
 function copyDirectory(src, dest, options) {
     const exclude = new Set(options?.exclude || [
         'README.md',
-        'metadata.json'
+        'metadata.json',
+        '.reskill-commit'
     ]);
     installer_ensureDir(dest);
     const entries = external_node_fs_.readdirSync(src, {
@@ -1217,7 +1235,10 @@ class SkillManager {
             resolved: repoUrl,
             commit: cacheResult.commit
         });
-        if (!this.isGlobal && save && this.config.exists()) this.config.addSkill(skillName, ref);
+        if (!this.isGlobal && save) {
+            this.config.ensureExists();
+            this.config.addSkill(skillName, ref);
+        }
         const locationHint = this.isGlobal ? '(global)' : '';
         logger.success(`Installed ${skillName}@${version} to ${skillPath} ${locationHint}`.trim());
         const installed = this.getInstalledSkill(skillName);
@@ -1435,7 +1456,10 @@ class SkillManager {
             resolved: repoUrl,
             commit: cacheResult.commit
         });
-        if (!this.isGlobal && save && this.config.exists()) this.config.addSkill(skillName, ref);
+        if (!this.isGlobal && save) {
+            this.config.ensureExists();
+            this.config.addSkill(skillName, ref);
+        }
         const successCount = Array.from(results.values()).filter((r)=>r.success).length;
         const failCount = results.size - successCount;
         if (0 === failCount) logger.success(`Installed ${skillName}@${version} to ${successCount} agent(s)`);
@@ -1598,7 +1622,7 @@ const installCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('instal
                             label: config.displayName
                         }));
                     const selected = await __WEBPACK_EXTERNAL_MODULE__clack_prompts__.multiselect({
-                        message: 'Select agents to install skills to',
+                        message: `Select agents to install skills to ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim('(Space to toggle, Enter to confirm)')}`,
                         options: allAgentChoices,
                         required: true,
                         initialValues: allAgentTypes
@@ -1620,7 +1644,7 @@ const installCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('instal
                         hint: agents[a].skillsDir
                     }));
                 const selected = await __WEBPACK_EXTERNAL_MODULE__clack_prompts__.multiselect({
-                    message: 'Select agents to install skills to',
+                    message: `Select agents to install skills to ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim('(Space to toggle, Enter to confirm)')}`,
                     options: agentChoices,
                     required: true,
                     initialValues: installedAgents

package/dist/core/config-loader.d.ts

@@ -35,6 +35,12 @@ export declare class ConfigLoader {
      * Save configuration
      */
     save(config?: SkillsJson): void;
+    /**
+     * Ensure skills.json exists, create with defaults if not
+     *
+     * @returns true if file was created, false if it already existed
+     */
+    ensureExists(): boolean;
     /**
      * Create default configuration
      */

package/dist/core/config-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/core/config-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAcpE;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAEF;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAA2B;gBAE7B,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,IAAI,IAAI,UAAU;IAiBlB;;OAEG;IACH,MAAM,IAAI,UAAU;IAKpB;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IAS/B;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU;IAejD;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,cAAc,CAAC;IAUvC;;OAEG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAiB5C;;OAEG;IACH,aAAa,IAAI,MAAM;IAKvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAUzC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAYlC;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAUnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK/B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAI9C;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/core/config-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAcpE;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAEF;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAA2B;gBAE7B,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,IAAI,IAAI,UAAU;IAiBlB;;OAEG;IACH,MAAM,IAAI,UAAU;IAKpB;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IAS/B;;;;OAIG;IACH,YAAY,IAAI,OAAO;IAQvB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU;IAejD;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,cAAc,CAAC;IAUvC;;OAEG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAiB5C;;OAEG;IACH,aAAa,IAAI,MAAM;IAKvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAUzC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAYlC;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAUnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK/B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAI9C;AAED,eAAe,YAAY,CAAC"}

package/dist/core/skill-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manager.d.ts","sourceRoot":"","sources":["../../src/core/skill-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-manager.d.ts","sourceRoot":"","sources":["../../src/core/skill-manager.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -277,20 +277,32 @@ class GitCloneError extends Error {
     repoUrl;
     originalError;
     isAuthError;
+    urlType;
     constructor(repoUrl, originalError){
         const isAuthError = GitCloneError.isAuthenticationError(originalError.message);
+        const urlType = GitCloneError.detectUrlType(repoUrl);
         let message = `Failed to clone repository: ${repoUrl}`;
         if (isAuthError) {
-            message += '\n\nTip: For private repos, ensure git SSH keys or credentials are configured:';
-            message += '\n  - SSH: Check ~/.ssh/id_rsa or ~/.ssh/id_ed25519';
-            message += "\n  - HTTPS: Run 'git config --global credential.helper store'";
-            message += '\n  - Or use a personal access token in the URL';
+            message += '\n\nTip: For private repos, ensure git credentials are configured:';
+            if ('ssh' === urlType) {
+                message += '\n  - Check ~/.ssh/id_rsa or ~/.ssh/id_ed25519';
+                message += '\n  - Ensure SSH key is added to your Git hosting service';
+            } else {
+                message += "\n  - Run 'git config --global credential.helper store'";
+                message += '\n  - Or use a personal access token in the URL';
+            }
         }
         super(message);
         this.name = 'GitCloneError';
         this.repoUrl = repoUrl;
         this.originalError = originalError;
         this.isAuthError = isAuthError;
+        this.urlType = urlType;
+    }
+    static detectUrlType(url) {
+        if (url.startsWith('git@') || url.startsWith('ssh://')) return 'ssh';
+        if (url.startsWith('http://') || url.startsWith('https://')) return 'https';
+        return 'unknown';
     }
     static isAuthenticationError(message) {
         const authPatterns = [
@@ -601,6 +613,11 @@ class ConfigLoader {
         writeJson(this.configPath, toSave);
         this.config = toSave;
     }
+    ensureExists() {
+        if (this.exists()) return false;
+        this.create();
+        return true;
+    }
     create(options) {
         const config = {
             ...DEFAULT_SKILLS_JSON,
@@ -870,7 +887,8 @@ function installer_remove(targetPath) {
 function copyDirectory(src, dest, options) {
     const exclude = new Set(options?.exclude || [
         'README.md',
-        'metadata.json'
+        'metadata.json',
+        '.reskill-commit'
     ]);
     installer_ensureDir(dest);
     const entries = external_node_fs_.readdirSync(src, {
@@ -1245,7 +1263,10 @@ class SkillManager {
             resolved: repoUrl,
             commit: cacheResult.commit
         });
-        if (!this.isGlobal && save && this.config.exists()) this.config.addSkill(skillName, ref);
+        if (!this.isGlobal && save) {
+            this.config.ensureExists();
+            this.config.addSkill(skillName, ref);
+        }
         const locationHint = this.isGlobal ? '(global)' : '';
         logger.success(`Installed ${skillName}@${version} to ${skillPath} ${locationHint}`.trim());
         const installed = this.getInstalledSkill(skillName);
@@ -1463,7 +1484,10 @@ class SkillManager {
             resolved: repoUrl,
             commit: cacheResult.commit
         });
-        if (!this.isGlobal && save && this.config.exists()) this.config.addSkill(skillName, ref);
+        if (!this.isGlobal && save) {
+            this.config.ensureExists();
+            this.config.addSkill(skillName, ref);
+        }
         const successCount = Array.from(results.values()).filter((r)=>r.success).length;
         const failCount = results.size - successCount;
         if (0 === failCount) logger.success(`Installed ${skillName}@${version} to ${successCount} agent(s)`);

package/dist/utils/git.d.ts

@@ -13,7 +13,12 @@ export declare class GitCloneError extends Error {
     readonly repoUrl: string;
     readonly originalError: Error;
     readonly isAuthError: boolean;
+    readonly urlType: 'ssh' | 'https' | 'unknown';
     constructor(repoUrl: string, originalError: Error);
+    /**
+     * Detect URL type from repository URL
+     */
+    static detectUrlType(url: string): 'ssh' | 'https' | 'unknown';
     /**
      * Check if an error message indicates an authentication problem
      */

package/dist/utils/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,aAAa,EAAE,KAAK,CAAC;IACrC,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAEzB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK;IAkBjD;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAevD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5D;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMvE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBtE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAe1E;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQvE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9E;AAsBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CASxE;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAQhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA0C5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reskill",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "AI Skills Package Manager - Git-based skills management for AI agents",
   "type": "module",
   "main": "./dist/index.js",