reskill 0.14.0 → 0.15.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,37 @@ 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 |
+
+Run `npx reskill@latest <command> --help` for detailed options.
 
 ## Private GitLab Support
 
@@ -163,10 +168,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 +218,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,35 +77,40 @@ 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
 ```
 
 ### 版本规范
@@ -120,37 +125,37 @@ npx reskill install user/skill@v1.0.0
 
 ## 命令
 
-无需全局安装，直接使用 `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 <command> --help` 查看详细选项。
+| `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 <command> --help` 查看详细选项。
 
 ## 私有 GitLab 支持
 
@@ -164,10 +169,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 +219,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
 ```
 
 ## 配置

package/dist/cli/index.js

@@ -4,10 +4,10 @@ import * as __WEBPACK_EXTERNAL_MODULE_node_path__ from "node:path";
 import * as __WEBPACK_EXTERNAL_MODULE_node_url__ from "node:url";
 import * as __WEBPACK_EXTERNAL_MODULE_commander__ from "commander";
 import * as __WEBPACK_EXTERNAL_MODULE_chalk__ from "chalk";
+import * as __WEBPACK_EXTERNAL_MODULE_semver__ from "semver";
 import * as __WEBPACK_EXTERNAL_MODULE_node_os__ from "node:os";
 import * as __WEBPACK_EXTERNAL_MODULE_node_child_process__ from "node:child_process";
 import * as __WEBPACK_EXTERNAL_MODULE_node_util__ from "node:util";
-import * as __WEBPACK_EXTERNAL_MODULE_semver__ from "semver";
 import * as __WEBPACK_EXTERNAL_MODULE__clack_prompts__ from "@clack/prompts";
 import * as __WEBPACK_EXTERNAL_MODULE_ora__ from "ora";
 var __webpack_modules__ = {
@@ -26,6 +26,81 @@ function __webpack_require__(moduleId) {
     return module.exports;
 }
 var external_node_fs_ = __webpack_require__("node:fs");
+const logger_logger = {
+    info (message) {
+        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].blue('ℹ'), message);
+    },
+    success (message) {
+        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].green('✅'), message);
+    },
+    warn (message) {
+        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].yellow('⚠️'), message);
+    },
+    error (message) {
+        console.error(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].red('❌'), message);
+    },
+    debug (message) {
+        if (process.env.DEBUG || process.env.VERBOSE) console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].gray('🔍'), __WEBPACK_EXTERNAL_MODULE_chalk__["default"].gray(message));
+    },
+    package (message) {
+        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('📦'), message);
+    },
+    log (message) {
+        console.log(message);
+    },
+    newline () {
+        console.log();
+    },
+    table (headers, rows) {
+        const widths = headers.map((h, i)=>{
+            const colValues = [
+                h,
+                ...rows.map((r)=>r[i] || '')
+            ];
+            return Math.max(...colValues.map((v)=>v.length));
+        });
+        const headerRow = headers.map((h, i)=>h.padEnd(widths[i])).join('  ');
+        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].bold(headerRow));
+        for (const row of rows){
+            const rowStr = row.map((cell, i)=>(cell || '').padEnd(widths[i])).join('  ');
+            console.log(rowStr);
+        }
+    }
+};
+async function checkForUpdate(packageName, currentVersion, options = {}) {
+    const timeout = options.timeout ?? 3000;
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(()=>controller.abort(), timeout);
+        const response = await fetch(`https://registry.npmjs.org/${packageName}`, {
+            signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) return null;
+        const data = await response.json();
+        const latest = data['dist-tags']?.latest;
+        if (!latest) return null;
+        const hasUpdate = __WEBPACK_EXTERNAL_MODULE_semver__["default"].gt(latest, currentVersion);
+        return {
+            current: currentVersion,
+            latest,
+            hasUpdate
+        };
+    } catch  {
+        return null;
+    }
+}
+function formatUpdateMessage(result) {
+    if (!result.hasUpdate) return '';
+    return `
+┌────────────────────────────────────────────────────┐
+│                                                    │
+│   Update available: ${result.current} → ${result.latest.padEnd(10)}          │
+│   Run: npm install -g reskill@latest               │
+│                                                    │
+└────────────────────────────────────────────────────┘
+`;
+}
 function exists(filePath) {
     return external_node_fs_.existsSync(filePath);
 }
@@ -112,47 +187,6 @@ function shortenPath(fullPath, cwd) {
     if (fullPath.startsWith(currentDir)) return `.${fullPath.slice(currentDir.length)}`;
     return fullPath;
 }
-const logger = {
-    info (message) {
-        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].blue('ℹ'), message);
-    },
-    success (message) {
-        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].green('✅'), message);
-    },
-    warn (message) {
-        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].yellow('⚠️'), message);
-    },
-    error (message) {
-        console.error(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].red('❌'), message);
-    },
-    debug (message) {
-        if (process.env.DEBUG || process.env.VERBOSE) console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].gray('🔍'), __WEBPACK_EXTERNAL_MODULE_chalk__["default"].gray(message));
-    },
-    package (message) {
-        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('📦'), message);
-    },
-    log (message) {
-        console.log(message);
-    },
-    newline () {
-        console.log();
-    },
-    table (headers, rows) {
-        const widths = headers.map((h, i)=>{
-            const colValues = [
-                h,
-                ...rows.map((r)=>r[i] || '')
-            ];
-            return Math.max(...colValues.map((v)=>v.length));
-        });
-        const headerRow = headers.map((h, i)=>h.padEnd(widths[i])).join('  ');
-        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].bold(headerRow));
-        for (const row of rows){
-            const rowStr = row.map((cell, i)=>(cell || '').padEnd(widths[i])).join('  ');
-            console.log(rowStr);
-        }
-    }
-};
 const agent_registry_home = (0, __WEBPACK_EXTERNAL_MODULE_node_os__.homedir)();
 const agents = {
     amp: {
@@ -1141,6 +1175,7 @@ class LockManager {
         const lockedSkill = {
             source: options.source,
             version: options.version,
+            ref: options.ref,
             resolved: options.resolved,
             commit: options.commit,
             installedAt: new Date().toISOString()
@@ -1220,35 +1255,43 @@ class SkillManager {
         const { force = false, save = true } = options;
         const resolved = await this.resolver.resolve(ref);
         const { parsed, repoUrl } = resolved;
-        const version = resolved.ref;
+        const gitRef = resolved.ref;
         const skillName = parsed.subPath ? __WEBPACK_EXTERNAL_MODULE_node_path__.basename(parsed.subPath) : parsed.repo;
         const skillPath = this.getSkillPath(skillName);
         if (exists(skillPath) && !force) {
             const locked = this.lockManager.get(skillName);
-            if (locked && locked.version === version) {
-                logger.info(`${skillName}@${version} is already installed`);
+            const lockedRef = locked?.ref || locked?.version;
+            if (locked && lockedRef === gitRef) {
+                logger_logger.info(`${skillName}@${gitRef} is already installed`);
                 const installed = this.getInstalledSkill(skillName);
                 if (installed) return installed;
             }
             if (!force) {
-                logger.warn(`${skillName} is already installed. Use --force to reinstall.`);
+                logger_logger.warn(`${skillName} is already installed. Use --force to reinstall.`);
                 const installed = this.getInstalledSkill(skillName);
                 if (installed) return installed;
             }
         }
-        logger["package"](`Installing ${skillName}@${version}...`);
-        let cacheResult = await this.cache.get(parsed, version);
-        if (cacheResult) logger.debug(`Using cached ${skillName}@${version}`);
+        logger_logger["package"](`Installing ${skillName}@${gitRef}...`);
+        let cacheResult = await this.cache.get(parsed, gitRef);
+        if (cacheResult) logger_logger.debug(`Using cached ${skillName}@${gitRef}`);
         else {
-            logger.debug(`Caching ${skillName}@${version} from ${repoUrl}`);
-            cacheResult = await this.cache.cache(repoUrl, parsed, version, version);
+            logger_logger.debug(`Caching ${skillName}@${gitRef} from ${repoUrl}`);
+            cacheResult = await this.cache.cache(repoUrl, parsed, gitRef, gitRef);
         }
         ensureDir(this.getInstallDir());
         if (exists(skillPath)) remove(skillPath);
-        await this.cache.copyTo(parsed, version, skillPath);
+        await this.cache.copyTo(parsed, gitRef, skillPath);
+        let semanticVersion = gitRef;
+        const skillJsonPath = __WEBPACK_EXTERNAL_MODULE_node_path__.join(skillPath, 'skill.json');
+        if (exists(skillJsonPath)) try {
+            const skillJson = readJson(skillJsonPath);
+            if (skillJson.version) semanticVersion = skillJson.version;
+        } catch  {}
         if (!this.isGlobal) this.lockManager.lockSkill(skillName, {
             source: `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`,
-            version,
+            version: semanticVersion,
+            ref: gitRef,
             resolved: repoUrl,
             commit: cacheResult.commit
         });
@@ -1256,8 +1299,9 @@ class SkillManager {
             this.config.ensureExists();
             this.config.addSkill(skillName, ref);
         }
+        const displayVersion = semanticVersion !== gitRef ? `${semanticVersion} (${gitRef})` : gitRef;
         const locationHint = this.isGlobal ? '(global)' : '';
-        logger.success(`Installed ${skillName}@${version} to ${skillPath} ${locationHint}`.trim());
+        logger_logger.success(`Installed ${skillName}@${displayVersion} to ${skillPath} ${locationHint}`.trim());
         const installed = this.getInstalledSkill(skillName);
         if (!installed) throw new Error(`Failed to get installed skill info for ${skillName}`);
         return installed;
@@ -1272,7 +1316,7 @@ class SkillManager {
             });
             installed.push(skill);
         } catch (error) {
-            logger.error(`Failed to install ${name}: ${error.message}`);
+            logger_logger.error(`Failed to install ${name}: ${error.message}`);
         }
         return installed;
     }
@@ -1280,14 +1324,14 @@ class SkillManager {
         const skillPath = this.getSkillPath(name);
         if (!exists(skillPath)) {
             const location = this.isGlobal ? '(global)' : '';
-            logger.warn(`Skill ${name} is not installed ${location}`.trim());
+            logger_logger.warn(`Skill ${name} is not installed ${location}`.trim());
             return false;
         }
         remove(skillPath);
         if (!this.isGlobal) this.lockManager.remove(name);
         if (!this.isGlobal && this.config.exists()) this.config.removeSkill(name);
         const locationHint = this.isGlobal ? '(global)' : '';
-        logger.success(`Uninstalled ${name} ${locationHint}`.trim());
+        logger_logger.success(`Uninstalled ${name} ${locationHint}`.trim());
         return true;
     }
     async update(name) {
@@ -1295,7 +1339,7 @@ class SkillManager {
         if (name) {
             const ref = this.config.getSkillRef(name);
             if (!ref) {
-                logger.error(`Skill ${name} not found in skills.json`);
+                logger_logger.error(`Skill ${name} not found in skills.json`);
                 return [];
             }
             const skill = await this.install(ref, {
@@ -1312,7 +1356,7 @@ class SkillManager {
                 });
                 updated.push(skill);
             } catch (error) {
-                logger.error(`Failed to update ${skillName}: ${error.message}`);
+                logger_logger.error(`Failed to update ${skillName}: ${error.message}`);
             }
         }
         return updated;
@@ -1329,7 +1373,7 @@ class SkillManager {
         const linkPath = this.getSkillPath(skillName);
         ensureDir(__WEBPACK_EXTERNAL_MODULE_node_path__.dirname(linkPath));
         createSymlink(absolutePath, linkPath);
-        logger.success(`Linked ${skillName} → ${absolutePath}`);
+        logger_logger.success(`Linked ${skillName} → ${absolutePath}`);
         return {
             name: skillName,
             path: linkPath,
@@ -1341,15 +1385,15 @@ class SkillManager {
     unlink(name) {
         const skillPath = this.getSkillPath(name);
         if (!exists(skillPath)) {
-            logger.warn(`Skill ${name} is not installed`);
+            logger_logger.warn(`Skill ${name} is not installed`);
             return false;
         }
         if (!isSymlink(skillPath)) {
-            logger.warn(`Skill ${name} is not a linked skill`);
+            logger_logger.warn(`Skill ${name} is not a linked skill`);
             return false;
         }
         remove(skillPath);
-        logger.success(`Unlinked ${name}`);
+        logger_logger.success(`Unlinked ${name}`);
         return true;
     }
     list() {
@@ -1419,7 +1463,8 @@ class SkillManager {
         const skills = this.config.getSkills();
         for (const [name, ref] of Object.entries(skills))try {
             const locked = this.lockManager.get(name);
-            const current = locked?.version || 'unknown';
+            const currentRef = locked?.ref || locked?.version || 'unknown';
+            const currentVersion = locked?.version || 'unknown';
             const parsed = this.resolver.parseRef(ref);
             const repoUrl = this.resolver.buildRepoUrl(parsed);
             const latestResolved = await this.resolver.resolveVersion(repoUrl, {
@@ -1428,15 +1473,15 @@ class SkillManager {
                 raw: 'latest'
             });
             const latest = latestResolved.ref;
-            const updateAvailable = current !== latest && 'unknown' !== current;
+            const updateAvailable = currentRef !== latest && 'unknown' !== currentRef;
             results.push({
                 name,
-                current,
+                current: currentVersion !== currentRef ? `${currentVersion} (${currentRef})` : currentRef,
                 latest,
                 updateAvailable
             });
         } catch (error) {
-            logger.debug(`Failed to check ${name}: ${error.message}`);
+            logger_logger.debug(`Failed to check ${name}: ${error.message}`);
             results.push({
                 name,
                 current: 'unknown',
@@ -1450,16 +1495,22 @@ class SkillManager {
         const { save = true, mode = 'symlink' } = options;
         const resolved = await this.resolver.resolve(ref);
         const { parsed, repoUrl } = resolved;
-        const version = resolved.ref;
+        const gitRef = resolved.ref;
         const skillName = parsed.subPath ? __WEBPACK_EXTERNAL_MODULE_node_path__.basename(parsed.subPath) : parsed.repo;
-        logger["package"](`Installing ${skillName}@${version} to ${targetAgents.length} agent(s)...`);
-        let cacheResult = await this.cache.get(parsed, version);
-        if (cacheResult) logger.debug(`Using cached ${skillName}@${version}`);
+        logger_logger["package"](`Installing ${skillName}@${gitRef} to ${targetAgents.length} agent(s)...`);
+        let cacheResult = await this.cache.get(parsed, gitRef);
+        if (cacheResult) logger_logger.debug(`Using cached ${skillName}@${gitRef}`);
         else {
-            logger.debug(`Caching ${skillName}@${version} from ${repoUrl}`);
-            cacheResult = await this.cache.cache(repoUrl, parsed, version, version);
+            logger_logger.debug(`Caching ${skillName}@${gitRef} from ${repoUrl}`);
+            cacheResult = await this.cache.cache(repoUrl, parsed, gitRef, gitRef);
         }
-        const sourcePath = this.cache.getCachePath(parsed, version);
+        const sourcePath = this.cache.getCachePath(parsed, gitRef);
+        let semanticVersion = gitRef;
+        const skillJsonPath = __WEBPACK_EXTERNAL_MODULE_node_path__.join(sourcePath, 'skill.json');
+        if (exists(skillJsonPath)) try {
+            const skillJson = readJson(skillJsonPath);
+            if (skillJson.version) semanticVersion = skillJson.version;
+        } catch  {}
         const installer = new Installer({
             cwd: this.projectRoot,
             global: this.isGlobal
@@ -1469,7 +1520,8 @@ class SkillManager {
         });
         if (!this.isGlobal) this.lockManager.lockSkill(skillName, {
             source: `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`,
-            version,
+            version: semanticVersion,
+            ref: gitRef,
             resolved: repoUrl,
             commit: cacheResult.commit
         });
@@ -1479,12 +1531,13 @@ class SkillManager {
         }
         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)`);
-        else logger.warn(`Installed ${skillName}@${version} to ${successCount} agent(s), ${failCount} failed`);
+        const displayVersion = semanticVersion !== gitRef ? `${semanticVersion} (${gitRef})` : gitRef;
+        if (0 === failCount) logger_logger.success(`Installed ${skillName}@${displayVersion} to ${successCount} agent(s)`);
+        else logger_logger.warn(`Installed ${skillName}@${displayVersion} to ${successCount} agent(s), ${failCount} failed`);
         const skill = {
             name: skillName,
             path: sourcePath,
-            version,
+            version: semanticVersion,
             source: `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`
         };
         return {
@@ -1524,7 +1577,7 @@ class SkillManager {
         if (!this.isGlobal) this.lockManager.remove(name);
         if (!this.isGlobal && this.config.exists()) this.config.removeSkill(name);
         const successCount = Array.from(results.values()).filter((r)=>r).length;
-        logger.success(`Uninstalled ${name} from ${successCount} agent(s)`);
+        logger_logger.success(`Uninstalled ${name} from ${successCount} agent(s)`);
         return results;
     }
 }
@@ -1536,41 +1589,41 @@ const infoCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('info').de
         return;
     }
     if (!info.installed && !info.config) {
-        logger.error(`Skill ${skillName} not found`);
+        logger_logger.error(`Skill ${skillName} not found`);
         process.exit(1);
     }
-    logger.log(`Skill: ${skillName}`);
-    logger.newline();
+    logger_logger.log(`Skill: ${skillName}`);
+    logger_logger.newline();
     if (info.config) {
-        logger.log("Configuration (skills.json):");
-        logger.log(`  Reference: ${info.config}`);
+        logger_logger.log("Configuration (skills.json):");
+        logger_logger.log(`  Reference: ${info.config}`);
     }
     if (info.locked) {
-        logger.log("Locked Version (skills.lock):");
-        logger.log(`  Version: ${info.locked.version}`);
-        logger.log(`  Source: ${info.locked.source}`);
-        logger.log(`  Commit: ${info.locked.commit}`);
-        logger.log(`  Installed: ${info.locked.installedAt}`);
+        logger_logger.log("Locked Version (skills.lock):");
+        logger_logger.log(`  Version: ${info.locked.version}`);
+        logger_logger.log(`  Source: ${info.locked.source}`);
+        logger_logger.log(`  Commit: ${info.locked.commit}`);
+        logger_logger.log(`  Installed: ${info.locked.installedAt}`);
     }
     if (info.installed) {
-        logger.log("Installed:");
-        logger.log(`  Path: ${info.installed.path}`);
-        logger.log(`  Version: ${info.installed.version}`);
-        logger.log(`  Linked: ${info.installed.isLinked ? 'Yes' : 'No'}`);
+        logger_logger.log("Installed:");
+        logger_logger.log(`  Path: ${info.installed.path}`);
+        logger_logger.log(`  Version: ${info.installed.version}`);
+        logger_logger.log(`  Linked: ${info.installed.isLinked ? 'Yes' : 'No'}`);
         if (info.installed.metadata) {
             const meta = info.installed.metadata;
-            logger.log("Metadata (skill.json):");
-            if (meta.description) logger.log(`  Description: ${meta.description}`);
-            if (meta.author) logger.log(`  Author: ${meta.author}`);
-            if (meta.license) logger.log(`  License: ${meta.license}`);
-            if (meta.keywords?.length) logger.log(`  Keywords: ${meta.keywords.join(', ')}`);
+            logger_logger.log("Metadata (skill.json):");
+            if (meta.description) logger_logger.log(`  Description: ${meta.description}`);
+            if (meta.author) logger_logger.log(`  Author: ${meta.author}`);
+            if (meta.license) logger_logger.log(`  License: ${meta.license}`);
+            if (meta.keywords?.length) logger_logger.log(`  Keywords: ${meta.keywords.join(', ')}`);
         }
-    } else logger.warn(`Skill ${skillName} is not installed`);
+    } else logger_logger.warn(`Skill ${skillName} is not installed`);
 });
 const initCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('init').description('Initialize a new skills.json configuration').option('-n, --name <name>', 'Project name').option('-r, --registry <registry>', 'Default registry', 'github').option('-d, --install-dir <dir>', 'Skills installation directory', '.skills').option('-y, --yes', 'Skip prompts and use defaults').action(async (options)=>{
     const configLoader = new ConfigLoader();
     if (configLoader.exists()) {
-        logger.warn('skills.json already exists');
+        logger_logger.warn('skills.json already exists');
         return;
     }
     const config = configLoader.create({
@@ -1580,16 +1633,16 @@ const initCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('init').de
             installDir: options.installDir
         }
     });
-    logger.success('Created skills.json');
-    logger.newline();
-    logger.log('Configuration:');
-    logger.log(`  Name: ${config.name || '(not set)'}`);
-    logger.log(`  Default registry: ${config.defaults?.registry}`);
-    logger.log(`  Install directory: ${config.defaults?.installDir}`);
-    logger.newline();
-    logger.log('Next steps:');
-    logger.log('  reskill install <skill>  Install a skill');
-    logger.log('  reskill list             List installed skills');
+    logger_logger.success('Created skills.json');
+    logger_logger.newline();
+    logger_logger.log('Configuration:');
+    logger_logger.log(`  Name: ${config.name || '(not set)'}`);
+    logger_logger.log(`  Default registry: ${config.defaults?.registry}`);
+    logger_logger.log(`  Install directory: ${config.defaults?.installDir}`);
+    logger_logger.newline();
+    logger_logger.log('Next steps:');
+    logger_logger.log('  reskill install <skill>  Install a skill');
+    logger_logger.log('  reskill list             List installed skills');
 });
 function formatAgentNames(agentTypes, maxShow = 5) {
     const names = agentTypes.map((a)=>agents[a].displayName);
@@ -1842,9 +1895,9 @@ const linkCmd = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('link').descri
     const skillManager = new SkillManager();
     try {
         const linked = skillManager.link(localPath, options.name);
-        logger.log(`Linked skill available at: ${linked.path}`);
+        logger_logger.log(`Linked skill available at: ${linked.path}`);
     } catch (error) {
-        logger.error(error.message);
+        logger_logger.error(error.message);
         process.exit(1);
     }
 });
@@ -1863,7 +1916,7 @@ const listCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('list').al
     const skills = skillManager.list();
     if (0 === skills.length) {
         const location = isGlobal ? 'globally' : 'in this project';
-        logger.info(`No skills installed ${location}`);
+        logger_logger.info(`No skills installed ${location}`);
         return;
     }
     if (options.json) {
@@ -1871,8 +1924,8 @@ const listCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('list').al
         return;
     }
     const locationLabel = isGlobal ? __WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim(' (global)') : '';
-    logger.log(`Installed Skills (${skillManager.getInstallDir()})${locationLabel}:`);
-    logger.newline();
+    logger_logger.log(`Installed Skills (${skillManager.getInstallDir()})${locationLabel}:`);
+    logger_logger.newline();
     const headers = [
         'Name',
         'Version',
@@ -1883,19 +1936,19 @@ const listCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('list').al
             skill.isLinked ? `${skill.version} (linked)` : skill.version,
             skill.source || '-'
         ]);
-    logger.table(headers, rows);
-    logger.newline();
-    logger.log(`Total: ${skills.length} skill(s)`);
+    logger_logger.table(headers, rows);
+    logger_logger.newline();
+    logger_logger.log(`Total: ${skills.length} skill(s)`);
 });
 const outdatedCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('outdated').description('Check for outdated skills').option('-j, --json', 'Output as JSON').action(async (options)=>{
     const configLoader = new ConfigLoader();
     if (!configLoader.exists()) {
-        logger.error("skills.json not found. Run 'reskill init' first.");
+        logger_logger.error("skills.json not found. Run 'reskill init' first.");
         process.exit(1);
     }
     const skills = configLoader.getSkills();
     if (0 === Object.keys(skills).length) {
-        logger.info('No skills defined in skills.json');
+        logger_logger.info('No skills defined in skills.json');
         return;
     }
     const skillManager = new SkillManager();
@@ -1909,11 +1962,11 @@ const outdatedCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('outda
         }
         const outdated = results.filter((r)=>r.updateAvailable);
         if (0 === outdated.length) {
-            logger.success('All skills are up to date!');
+            logger_logger.success('All skills are up to date!');
             return;
         }
-        logger["package"]('Checking for updates...');
-        logger.newline();
+        logger_logger["package"]('Checking for updates...');
+        logger_logger.newline();
         const headers = [
             'Skill',
             'Current',
@@ -1926,15 +1979,15 @@ const outdatedCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('outda
                 r.latest,
                 r.updateAvailable ? __WEBPACK_EXTERNAL_MODULE_chalk__["default"].yellow('⬆️ Update available') : __WEBPACK_EXTERNAL_MODULE_chalk__["default"].green('✅ Up to date')
             ]);
-        logger.table(headers, rows);
-        logger.newline();
+        logger_logger.table(headers, rows);
+        logger_logger.newline();
         if (outdated.length > 0) {
-            logger.log(`Run ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('reskill update')} to update all skills`);
-            logger.log(`Or ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('reskill update <skill>')} to update a specific skill`);
+            logger_logger.log(`Run ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('reskill update')} to update all skills`);
+            logger_logger.log(`Or ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('reskill update <skill>')} to update a specific skill`);
         }
     } catch (error) {
         spinner.fail('Check failed');
-        logger.error(error.message);
+        logger_logger.error(error.message);
         process.exit(1);
     }
 });
@@ -1949,7 +2002,7 @@ const uninstallCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('unin
 const updateCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('update').alias('up').description('Update installed skills').argument('[skill]', 'Skill name to update (updates all if not specified)').action(async (skill)=>{
     const configLoader = new ConfigLoader();
     if (!configLoader.exists()) {
-        logger.error("skills.json not found. Run 'reskill init' first.");
+        logger_logger.error("skills.json not found. Run 'reskill init' first.");
         process.exit(1);
     }
     const skillManager = new SkillManager();
@@ -1958,14 +2011,14 @@ const updateCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('update'
         const updated = await skillManager.update(skill);
         spinner.stop();
         if (0 === updated.length) {
-            logger.info('No skills to update');
+            logger_logger.info('No skills to update');
             return;
         }
-        logger.success(`Updated ${updated.length} skill(s):`);
-        for (const s of updated)logger.log(`  - ${s.name}@${s.version}`);
+        logger_logger.success(`Updated ${updated.length} skill(s):`);
+        for (const s of updated)logger_logger.log(`  - ${s.name}@${s.version}`);
     } catch (error) {
         spinner.fail('Update failed');
-        logger.error(error.message);
+        logger_logger.error(error.message);
         process.exit(1);
     }
 });
@@ -1982,4 +2035,8 @@ program.addCommand(outdatedCommand);
 program.addCommand(uninstallCommand);
 program.addCommand(linkCommand);
 program.addCommand(unlinkCommand);
-program.parse();
+const updateCheckPromise = checkForUpdate(packageJson.name, packageJson.version);
+program.parseAsync().then(async ()=>{
+    const result = await updateCheckPromise;
+    if (result?.hasUpdate) logger_logger.log(formatUpdateMessage(result));
+});

package/dist/core/lock-manager.d.ts

@@ -47,6 +47,7 @@ export declare class LockManager {
     lockSkill(name: string, options: {
         source: string;
         version: string;
+        ref: string;
         resolved: string;
         commit: string;
     }): LockedSkill;

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

@@ -1 +1 @@
-{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../src/core/lock-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQjE;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA2B;gBAE/B,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,IAAI,IAAI,UAAU;IAsBlB;;OAEG;IACH,MAAM,IAAI,UAAU;IAKpB;;OAEG;IACH,IAAI,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IASnC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAK1C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAM3C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU7B;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,WAAW;IAad;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAKrC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK1B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAQtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,MAAM,IAAI,IAAI;CAOf;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../src/core/lock-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQjE;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA2B;gBAE/B,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,IAAI,IAAI,UAAU;IAsBlB;;OAEG;IACH,MAAM,IAAI,UAAU;IAKpB;;OAEG;IACH,IAAI,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IASnC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAK1C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAM3C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU7B;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,WAAW;IAcd;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAKrC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK1B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAQtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,MAAM,IAAI,IAAI;CAOf;AAED,eAAe,WAAW,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

@@ -1127,6 +1127,7 @@ class LockManager {
         const lockedSkill = {
             source: options.source,
             version: options.version,
+            ref: options.ref,
             resolved: options.resolved,
             commit: options.commit,
             installedAt: new Date().toISOString()
@@ -1164,7 +1165,7 @@ class LockManager {
         this.lockData = null;
     }
 }
-const logger = {
+const logger_logger = {
     info (message) {
         console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].blue('ℹ'), message);
     },
@@ -1247,35 +1248,43 @@ class SkillManager {
         const { force = false, save = true } = options;
         const resolved = await this.resolver.resolve(ref);
         const { parsed, repoUrl } = resolved;
-        const version = resolved.ref;
+        const gitRef = resolved.ref;
         const skillName = parsed.subPath ? __WEBPACK_EXTERNAL_MODULE_node_path__.basename(parsed.subPath) : parsed.repo;
         const skillPath = this.getSkillPath(skillName);
         if (exists(skillPath) && !force) {
             const locked = this.lockManager.get(skillName);
-            if (locked && locked.version === version) {
-                logger.info(`${skillName}@${version} is already installed`);
+            const lockedRef = locked?.ref || locked?.version;
+            if (locked && lockedRef === gitRef) {
+                logger_logger.info(`${skillName}@${gitRef} is already installed`);
                 const installed = this.getInstalledSkill(skillName);
                 if (installed) return installed;
             }
             if (!force) {
-                logger.warn(`${skillName} is already installed. Use --force to reinstall.`);
+                logger_logger.warn(`${skillName} is already installed. Use --force to reinstall.`);
                 const installed = this.getInstalledSkill(skillName);
                 if (installed) return installed;
             }
         }
-        logger["package"](`Installing ${skillName}@${version}...`);
-        let cacheResult = await this.cache.get(parsed, version);
-        if (cacheResult) logger.debug(`Using cached ${skillName}@${version}`);
+        logger_logger["package"](`Installing ${skillName}@${gitRef}...`);
+        let cacheResult = await this.cache.get(parsed, gitRef);
+        if (cacheResult) logger_logger.debug(`Using cached ${skillName}@${gitRef}`);
         else {
-            logger.debug(`Caching ${skillName}@${version} from ${repoUrl}`);
-            cacheResult = await this.cache.cache(repoUrl, parsed, version, version);
+            logger_logger.debug(`Caching ${skillName}@${gitRef} from ${repoUrl}`);
+            cacheResult = await this.cache.cache(repoUrl, parsed, gitRef, gitRef);
         }
         ensureDir(this.getInstallDir());
         if (exists(skillPath)) remove(skillPath);
-        await this.cache.copyTo(parsed, version, skillPath);
+        await this.cache.copyTo(parsed, gitRef, skillPath);
+        let semanticVersion = gitRef;
+        const skillJsonPath = __WEBPACK_EXTERNAL_MODULE_node_path__.join(skillPath, 'skill.json');
+        if (exists(skillJsonPath)) try {
+            const skillJson = readJson(skillJsonPath);
+            if (skillJson.version) semanticVersion = skillJson.version;
+        } catch  {}
         if (!this.isGlobal) this.lockManager.lockSkill(skillName, {
             source: `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`,
-            version,
+            version: semanticVersion,
+            ref: gitRef,
             resolved: repoUrl,
             commit: cacheResult.commit
         });
@@ -1283,8 +1292,9 @@ class SkillManager {
             this.config.ensureExists();
             this.config.addSkill(skillName, ref);
         }
+        const displayVersion = semanticVersion !== gitRef ? `${semanticVersion} (${gitRef})` : gitRef;
         const locationHint = this.isGlobal ? '(global)' : '';
-        logger.success(`Installed ${skillName}@${version} to ${skillPath} ${locationHint}`.trim());
+        logger_logger.success(`Installed ${skillName}@${displayVersion} to ${skillPath} ${locationHint}`.trim());
         const installed = this.getInstalledSkill(skillName);
         if (!installed) throw new Error(`Failed to get installed skill info for ${skillName}`);
         return installed;
@@ -1299,7 +1309,7 @@ class SkillManager {
             });
             installed.push(skill);
         } catch (error) {
-            logger.error(`Failed to install ${name}: ${error.message}`);
+            logger_logger.error(`Failed to install ${name}: ${error.message}`);
         }
         return installed;
     }
@@ -1307,14 +1317,14 @@ class SkillManager {
         const skillPath = this.getSkillPath(name);
         if (!exists(skillPath)) {
             const location = this.isGlobal ? '(global)' : '';
-            logger.warn(`Skill ${name} is not installed ${location}`.trim());
+            logger_logger.warn(`Skill ${name} is not installed ${location}`.trim());
             return false;
         }
         remove(skillPath);
         if (!this.isGlobal) this.lockManager.remove(name);
         if (!this.isGlobal && this.config.exists()) this.config.removeSkill(name);
         const locationHint = this.isGlobal ? '(global)' : '';
-        logger.success(`Uninstalled ${name} ${locationHint}`.trim());
+        logger_logger.success(`Uninstalled ${name} ${locationHint}`.trim());
         return true;
     }
     async update(name) {
@@ -1322,7 +1332,7 @@ class SkillManager {
         if (name) {
             const ref = this.config.getSkillRef(name);
             if (!ref) {
-                logger.error(`Skill ${name} not found in skills.json`);
+                logger_logger.error(`Skill ${name} not found in skills.json`);
                 return [];
             }
             const skill = await this.install(ref, {
@@ -1339,7 +1349,7 @@ class SkillManager {
                 });
                 updated.push(skill);
             } catch (error) {
-                logger.error(`Failed to update ${skillName}: ${error.message}`);
+                logger_logger.error(`Failed to update ${skillName}: ${error.message}`);
             }
         }
         return updated;
@@ -1356,7 +1366,7 @@ class SkillManager {
         const linkPath = this.getSkillPath(skillName);
         ensureDir(__WEBPACK_EXTERNAL_MODULE_node_path__.dirname(linkPath));
         createSymlink(absolutePath, linkPath);
-        logger.success(`Linked ${skillName} → ${absolutePath}`);
+        logger_logger.success(`Linked ${skillName} → ${absolutePath}`);
         return {
             name: skillName,
             path: linkPath,
@@ -1368,15 +1378,15 @@ class SkillManager {
     unlink(name) {
         const skillPath = this.getSkillPath(name);
         if (!exists(skillPath)) {
-            logger.warn(`Skill ${name} is not installed`);
+            logger_logger.warn(`Skill ${name} is not installed`);
             return false;
         }
         if (!isSymlink(skillPath)) {
-            logger.warn(`Skill ${name} is not a linked skill`);
+            logger_logger.warn(`Skill ${name} is not a linked skill`);
             return false;
         }
         remove(skillPath);
-        logger.success(`Unlinked ${name}`);
+        logger_logger.success(`Unlinked ${name}`);
         return true;
     }
     list() {
@@ -1446,7 +1456,8 @@ class SkillManager {
         const skills = this.config.getSkills();
         for (const [name, ref] of Object.entries(skills))try {
             const locked = this.lockManager.get(name);
-            const current = locked?.version || 'unknown';
+            const currentRef = locked?.ref || locked?.version || 'unknown';
+            const currentVersion = locked?.version || 'unknown';
             const parsed = this.resolver.parseRef(ref);
             const repoUrl = this.resolver.buildRepoUrl(parsed);
             const latestResolved = await this.resolver.resolveVersion(repoUrl, {
@@ -1455,15 +1466,15 @@ class SkillManager {
                 raw: 'latest'
             });
             const latest = latestResolved.ref;
-            const updateAvailable = current !== latest && 'unknown' !== current;
+            const updateAvailable = currentRef !== latest && 'unknown' !== currentRef;
             results.push({
                 name,
-                current,
+                current: currentVersion !== currentRef ? `${currentVersion} (${currentRef})` : currentRef,
                 latest,
                 updateAvailable
             });
         } catch (error) {
-            logger.debug(`Failed to check ${name}: ${error.message}`);
+            logger_logger.debug(`Failed to check ${name}: ${error.message}`);
             results.push({
                 name,
                 current: 'unknown',
@@ -1477,16 +1488,22 @@ class SkillManager {
         const { save = true, mode = 'symlink' } = options;
         const resolved = await this.resolver.resolve(ref);
         const { parsed, repoUrl } = resolved;
-        const version = resolved.ref;
+        const gitRef = resolved.ref;
         const skillName = parsed.subPath ? __WEBPACK_EXTERNAL_MODULE_node_path__.basename(parsed.subPath) : parsed.repo;
-        logger["package"](`Installing ${skillName}@${version} to ${targetAgents.length} agent(s)...`);
-        let cacheResult = await this.cache.get(parsed, version);
-        if (cacheResult) logger.debug(`Using cached ${skillName}@${version}`);
+        logger_logger["package"](`Installing ${skillName}@${gitRef} to ${targetAgents.length} agent(s)...`);
+        let cacheResult = await this.cache.get(parsed, gitRef);
+        if (cacheResult) logger_logger.debug(`Using cached ${skillName}@${gitRef}`);
         else {
-            logger.debug(`Caching ${skillName}@${version} from ${repoUrl}`);
-            cacheResult = await this.cache.cache(repoUrl, parsed, version, version);
+            logger_logger.debug(`Caching ${skillName}@${gitRef} from ${repoUrl}`);
+            cacheResult = await this.cache.cache(repoUrl, parsed, gitRef, gitRef);
         }
-        const sourcePath = this.cache.getCachePath(parsed, version);
+        const sourcePath = this.cache.getCachePath(parsed, gitRef);
+        let semanticVersion = gitRef;
+        const skillJsonPath = __WEBPACK_EXTERNAL_MODULE_node_path__.join(sourcePath, 'skill.json');
+        if (exists(skillJsonPath)) try {
+            const skillJson = readJson(skillJsonPath);
+            if (skillJson.version) semanticVersion = skillJson.version;
+        } catch  {}
         const installer = new Installer({
             cwd: this.projectRoot,
             global: this.isGlobal
@@ -1496,7 +1513,8 @@ class SkillManager {
         });
         if (!this.isGlobal) this.lockManager.lockSkill(skillName, {
             source: `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`,
-            version,
+            version: semanticVersion,
+            ref: gitRef,
             resolved: repoUrl,
             commit: cacheResult.commit
         });
@@ -1506,12 +1524,13 @@ class SkillManager {
         }
         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)`);
-        else logger.warn(`Installed ${skillName}@${version} to ${successCount} agent(s), ${failCount} failed`);
+        const displayVersion = semanticVersion !== gitRef ? `${semanticVersion} (${gitRef})` : gitRef;
+        if (0 === failCount) logger_logger.success(`Installed ${skillName}@${displayVersion} to ${successCount} agent(s)`);
+        else logger_logger.warn(`Installed ${skillName}@${displayVersion} to ${successCount} agent(s), ${failCount} failed`);
         const skill = {
             name: skillName,
             path: sourcePath,
-            version,
+            version: semanticVersion,
             source: `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`
         };
         return {
@@ -1551,7 +1570,7 @@ class SkillManager {
         if (!this.isGlobal) this.lockManager.remove(name);
         if (!this.isGlobal && this.config.exists()) this.config.removeSkill(name);
         const successCount = Array.from(results.values()).filter((r)=>r).length;
-        logger.success(`Uninstalled ${name} from ${successCount} agent(s)`);
+        logger_logger.success(`Uninstalled ${name} from ${successCount} agent(s)`);
         return results;
     }
 }
@@ -1698,4 +1717,4 @@ function generateSkillMd(skill) {
     frontmatter.push('');
     return frontmatter.join('\n') + skill.content;
 }
-export { CacheManager, ConfigLoader, DEFAULT_REGISTRIES, GitResolver, Installer, LockManager, SkillManager, SkillValidationError, agents, detectInstalledAgents, generateSkillMd, getAgentConfig, getAgentSkillsDir, getAllAgentTypes, getCanonicalSkillPath, getCanonicalSkillsDir, hasValidSkillMd, isPathSafe, isValidAgentType, logger, parseSkillFromDir, parseSkillMd, parseSkillMdFile, sanitizeName, shortenPath, validateSkillDescription, validateSkillName };
+export { CacheManager, ConfigLoader, DEFAULT_REGISTRIES, GitResolver, Installer, LockManager, SkillManager, SkillValidationError, agents, detectInstalledAgents, generateSkillMd, getAgentConfig, getAgentSkillsDir, getAllAgentTypes, getCanonicalSkillPath, getCanonicalSkillsDir, hasValidSkillMd, isPathSafe, isValidAgentType, logger_logger as logger, parseSkillFromDir, parseSkillMd, parseSkillMdFile, sanitizeName, shortenPath, validateSkillDescription, validateSkillName };

package/dist/types/index.d.ts

@@ -85,8 +85,10 @@ export interface SkillsJson {
 export interface LockedSkill {
     /** Source, e.g., github:user/repo */
     source: string;
-    /** Version number */
+    /** Semantic version from skill.json */
     version: string;
+    /** Git reference (tag, branch, commit) used for installation */
+    ref: string;
     /** Resolved full URL */
     resolved: string;
     /** Exact commit hash */

package/dist/types/index.d.ts.map

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

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 export * from './fs.js';
 export * from './git.js';
 export { logger } from './logger.js';
+export * from './update-notifier.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/utils/update-notifier.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Update Notifier - Check for CLI updates from npm registry
+ *
+ * Provides non-blocking update notifications to users when a newer version is available.
+ */
+/**
+ * Update check result
+ */
+export interface UpdateCheckResult {
+    /** Current installed version */
+    current: string;
+    /** Latest version on npm */
+    latest: string;
+    /** Whether an update is available */
+    hasUpdate: boolean;
+}
+/**
+ * Options for update check
+ */
+export interface CheckOptions {
+    /** Timeout in milliseconds (default: 3000) */
+    timeout?: number;
+}
+/**
+ * Check for updates from npm registry
+ *
+ * @param packageName - Name of the package to check
+ * @param currentVersion - Current installed version
+ * @param options - Check options
+ * @returns Update check result, or null if check failed
+ */
+export declare function checkForUpdate(packageName: string, currentVersion: string, options?: CheckOptions): Promise<UpdateCheckResult | null>;
+/**
+ * Format update message for display
+ *
+ * @param result - Update check result
+ * @returns Formatted message string, or empty string if no update
+ */
+export declare function formatUpdateMessage(result: UpdateCheckResult): string;
+/**
+ * Check for updates and notify user if available
+ *
+ * This function is designed to be non-blocking and silent on errors.
+ *
+ * @param packageName - Name of the package to check
+ * @param currentVersion - Current installed version
+ */
+export declare function notifyUpdate(packageName: string, currentVersion: string): Promise<void>;
+//# sourceMappingURL=update-notifier.d.ts.map

package/dist/utils/update-notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-notifier.d.ts","sourceRoot":"","sources":["../../src/utils/update-notifier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAmCnC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAarE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW7F"}

package/package.json

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