@haolin-ai/skillman 1.0.7 → 1.0.8

package/README.md

@@ -47,9 +47,22 @@ skillman install git@github.com:org/repo.git
 ### Commands
 
 ```bash
+# Initialize a new skill template
+skillman init [skill-name]
+skillman init my-skill -v 2.0.0 -d "Description" -a "Author"
+
 # List all available agents
 skillman agents
 
+# List installed skills
+skillman list
+
+# Update a skill
+skillman update my-skill
+
+# Uninstall a skill
+skillman uninstall my-skill
+
 # Preview installation without making changes
 skillman --dry-run
 
@@ -63,6 +76,8 @@ skillman --version
 ## Features
 
 - **Multi-Agent Support**: Works with Claude Code, OpenClaw, Qoder, Codex, Cursor, and more
+- **Skill Template Generator**: Quickly create new skills with `skillman init`
+- **Version Management**: Track and manage skill versions with `list`, `update`, and `uninstall` commands
 - **Workspace History**: Remembers previously used workspace paths for quick selection
 - **Bilingual Support**: Automatically switches between English and Chinese based on system language
 - **Dry-Run Mode**: Preview installations before applying changes
@@ -91,7 +106,7 @@ git clone <repo-url>
 cd skillman
 
 # Install dependencies
-pnpm install
+npm install
 
 # Run locally
 node bin/skillman.mjs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haolin-ai/skillman",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "A CLI tool to install AI agent skills across multiple platforms",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -7,7 +7,7 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 import { select, confirm, input, Separator, checkbox } from '@inquirer/prompts';
 import pkg from '../package.json' with { type: 'json' };
-import { scanSkills } from './scanner.js';
+import { scanSkills, parseSkillFile } from './scanner.js';
 import { installSkill } from './installer.js';
 import { loadAgents } from './config.js';
 import { t } from './i18n.js';
@@ -431,7 +431,13 @@ async function continueInstallMultiple(selectedSkills, dryRun) {
     let shouldInstall = true;
     try {
       await fs.access(targetDir);
-      log.warn(t('msg.skill_exists'));
+      // Get existing skill version
+      const existingSkillFile = path.join(targetDir, 'SKILL.md');
+      const existingSkill = await parseSkillFile(existingSkillFile);
+      const currentVer = existingSkill?.version || '?';
+      const newVer = skill.version || '?';
+      log.warn(`${skill.name} ${t('msg.already_exists') || 'already exists'}`);
+      console.log(`  ${c.gray}Current:${c.reset} v${currentVer}  ${c.gray}→${c.reset}  ${c.gray}Installing:${c.reset} v${newVer}`);
       const overwrite = await confirm({ message: t('prompt.overwrite') + '?', default: false });
       if (!overwrite) {
         log.info(t('msg.skipped') || 'Skipped');

package/src/i18n.js

@@ -72,6 +72,7 @@ const translations = {
     'msg.updating': '正在更新',
     'msg.uninstalling': '正在卸载',
     'msg.cancelled': '已取消',
+    'msg.already_exists': '已存在',
     'msg.init_skill': '初始化 Skill 模板',
     'msg.created': '已创建',
     'msg.init_hint': '编辑 SKILL.md 来自定义你的 skill',
@@ -144,6 +145,7 @@ const translations = {
     'msg.preview_summary': 'Preview Summary',
     'msg.dry_run_hint': 'Running with --dry-run, no changes made',
     'msg.skill_exists': 'Skill already exists',
+    'msg.already_exists': 'already exists',
     'msg.install_cancelled': 'Installation cancelled',
     'msg.downloading': 'Downloading...',
     'msg.downloaded': 'Downloaded',
@@ -158,6 +160,7 @@ const translations = {
     'msg.updating': 'Updating',
     'msg.uninstalling': 'Uninstalling',
     'msg.cancelled': 'Cancelled',
+    'msg.already_exists': 'already exists',
     'msg.init_skill': 'Initializing skill template',
     'msg.created': 'Created',
     'msg.init_hint': 'Edit SKILL.md to customize your skill',

package/src/scanner.js

@@ -10,6 +10,42 @@ import path from 'path';
 // Common skill container directories
 const SKILL_CONTAINERS = ['skills', '.agents/skills', '.claude/skills'];
 
+/**
+ * Parse a single SKILL.md file to extract metadata
+ * @param {string} skillFile - Path to SKILL.md
+ * @returns {Promise<Object|null>} Parsed skill info or null if invalid
+ */
+export async function parseSkillFile(skillFile) {
+  try {
+    const content = await fs.readFile(skillFile, 'utf-8');
+    const nameMatch = content.match(/^name:\s*(.+)$/m);
+    const descMatch = content.match(/^description:\s*(.+)$/m);
+    
+    // Parse version from metadata block (supports quoted and unquoted)
+    const metadataMatch = content.match(/metadata:[\s\S]*?(?=\n\w|$)/);
+    let version;
+    if (metadataMatch) {
+      const versionInMeta = metadataMatch[0].match(/^\s+version:\s*(.+)$/m);
+      if (versionInMeta) {
+        // Remove quotes if present (both single and double)
+        version = versionInMeta[1].trim().replace(/^["']|["']$/g, '');
+      }
+    }
+    
+    if (nameMatch) {
+      return {
+        name: nameMatch[1].trim(),
+        description: descMatch ? descMatch[1].trim() : '',
+        version: version
+      };
+    }
+  } catch {
+    // File doesn't exist or can't be read
+  }
+  
+  return null;
+}
+
 /**
  * Scan a single directory for skills
  * @param {string} dir - Directory to scan
@@ -28,30 +64,12 @@ async function scanSingleDir(dir) {
       const skillPath = path.join(dir, entry.name);
       const skillFile = path.join(skillPath, 'SKILL.md');
       
-      try {
-        const content = await fs.readFile(skillFile, 'utf-8');
-        const nameMatch = content.match(/^name:\s*(.+)$/m);
-        const descMatch = content.match(/^description:\s*(.+)$/m);
-        // Parse version from metadata block
-        const metadataMatch = content.match(/metadata:[\s\S]*?(?=\n\w|$)/);
-        let version;
-        if (metadataMatch) {
-          const versionInMeta = metadataMatch[0].match(/^\s+version:\s*(.+)$/m);
-          if (versionInMeta) {
-            version = versionInMeta[1].trim();
-          }
-        }
-        
-        if (nameMatch) {
-          skills.push({
-            name: nameMatch[1].trim(),
-            path: skillPath,
-            description: descMatch ? descMatch[1].trim() : '',
-            version: version
-          });
-        }
-      } catch {
-        // No SKILL.md or parse error, skip
+      const skillInfo = await parseSkillFile(skillFile);
+      if (skillInfo) {
+        skills.push({
+          ...skillInfo,
+          path: skillPath
+        });
       }
     }
   } catch {