devskill 2.0.2 → 2.0.3

package/README.md

@@ -48,10 +48,17 @@ npx skills add vuluu2k/skills --skill='pinia-options'
 ```
 
 ### Options 3: Interactive CLI
-We've also built an elegant, interactive CLI for advanced management (requires cloning this repo):
+We've also built an elegant, interactive CLI for advanced management:
 
 ```bash
+# Open interactive menu
+npx devskill
+
+# Option 1: Install entire collections of skills
 npx devskill install
+
+# Option 2: Add specific individual skills (use Space to select)
+npx devskill add
 ```
 
 ---

package/README.vn.md

@@ -27,9 +27,17 @@ Bằng cách cung cấp cho AI các tài liệu `SKILL.md` chuyên dụng, bạn
 
 ## 📦 Cài đặt & Bắt đầu nhanh
 
-Quên việc copy thủ công đi. Chúng tôi đã xây dựng một CLI tương tác thanh lịch để đưa kiến thức trực tiếpChạy CLI trong dự án của bạn:
+Quên việc copy thủ công đi. Chúng tôi đã xây dựng một CLI tương tác thanh lịch để đưa kiến thức trực tiếp vào repo của bạn.
+
 ```bash
+# Mở menu tương tác chính
+npx devskill
+
+# Tuỳ chọn 1: Cài đặt toàn bộ một nhóm (collection) skills
 npx devskill install
+
+# Tuỳ chọn 2: Thêm các skills đơn lẻ (chọn bằng phím Space)
+npx devskill add
 ```
 
 > **Mẹo:** Bạn cũng có thể cài đặt mọi skill trên toàn hệ thống bằng công cụ chính thức:  

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devskill",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "type": "module",
   "bin": {
     "devskill": "bin/devskill.js"

package/scripts/cli.ts

@@ -97,9 +97,9 @@ async function initSubmodules(skipPrompt = false) {
     const shouldRemove = skipPrompt
       ? true
       : await p.confirm({
-          message: 'Remove these extra submodules?',
-          initialValue: true,
-        })
+        message: 'Remove these extra submodules?',
+        initialValue: true,
+      })
 
     if (p.isCancel(shouldRemove)) {
       p.cancel('Cancelled')
@@ -130,14 +130,14 @@ async function initSubmodules(skipPrompt = false) {
   const selected = skipPrompt
     ? newProjects
     : await p.multiselect({
-        message: 'Select projects to initialize',
-        options: newProjects.map(project => ({
-          value: project,
-          label: `${project.name} (${project.type})`,
-          hint: project.url,
-        })),
-        initialValues: newProjects,
-      })
+      message: 'Select projects to initialize',
+      options: newProjects.map(project => ({
+        value: project,
+        label: `${project.name} (${project.type})`,
+        hint: project.url,
+      })),
+      initialValues: newProjects,
+    })
 
   if (p.isCancel(selected)) {
     p.cancel('Cancelled')
@@ -332,9 +332,9 @@ async function cleanup(skipPrompt = false) {
     const shouldRemove = skipPrompt
       ? true
       : await p.confirm({
-          message: 'Remove these extra skills?',
-          initialValue: false,
-        })
+        message: 'Remove these extra skills?',
+        initialValue: false,
+      })
 
     if (p.isCancel(shouldRemove)) {
       p.cancel('Cancelled')
@@ -366,7 +366,7 @@ async function cleanup(skipPrompt = false) {
 
 async function installSkills() {
   const spinner = p.spinner()
-  
+
   const allCollections: Record<string, string[]> = { ...collections }
   for (const [vendorName, config] of Object.entries(vendors)) {
     const vendorConfig = config as VendorConfig
@@ -379,7 +379,7 @@ async function installSkills() {
   }
 
   const selectedCollectionNames = await p.multiselect({
-    message: 'Select collections to install',
+    message: 'Select collections to install (Space to select, Enter to confirm)',
     options: Object.keys(allCollections).map(name => ({
       value: name,
       label: name,
@@ -412,21 +412,45 @@ async function installSkills() {
     return
   }
 
-  const skillsDirName = await p.text({
-    message: 'Name of the skills directory inside target project?',
-    initialValue: 'skills',
-    placeholder: 'skills'
+  const toolChoice = await p.select({
+    message: 'Which AI tool are you installing these skills for?',
+    options: [
+      { value: 'skills', label: 'Generic (skills/)', hint: 'Default skills directory' },
+      { value: '.cursor/skills', label: 'Cursor (.cursor/skills)' },
+      { value: '.windsurf/skills', label: 'Windsurf (.windsurf/skills)' },
+      { value: '.claude/skills', label: 'Claude Desktop (.claude/skills)' },
+      { value: '.claudecode/skills', label: 'Claude Code (.claudecode/skills)' },
+      { value: '.agents/skills', label: 'Antigravity (.agents/skills)' },
+      { value: '.vscode/skills', label: 'VSCode / Copilot (.vscode/skills)' },
+      { value: 'custom', label: 'Custom path...' }
+    ]
   })
 
-  if (p.isCancel(skillsDirName)) {
+  if (p.isCancel(toolChoice)) {
     p.cancel('Cancelled')
     return
   }
 
+  let skillsDirName = toolChoice as string
+
+  if (toolChoice === 'custom') {
+    const customDir = await p.text({
+      message: 'Enter custom skills directory path:',
+      initialValue: 'skills',
+      placeholder: 'skills'
+    })
+
+    if (p.isCancel(customDir)) {
+      p.cancel('Cancelled')
+      return
+    }
+    skillsDirName = customDir as string
+  }
+
   const selectedSkills = Array.from(new Set(
     (selectedCollectionNames as string[]).flatMap(name => allCollections[name])
   ))
-  const targetDir = join(targetProject as string, skillsDirName as string)
+  const targetDir = join(targetProject as string, skillsDirName)
 
   if (!existsSync(targetDir)) {
     mkdirSync(targetDir, { recursive: true })
@@ -446,9 +470,129 @@ async function installSkills() {
     if (existsSync(destPath)) {
       rmSync(destPath, { recursive: true })
     }
-    
+
     mkdirSync(destPath, { recursive: true })
-    
+
+    const files = readdirSync(sourcePath, { recursive: true, withFileTypes: true })
+    for (const file of files) {
+      if (file.isFile()) {
+        const fullPath = join(file.parentPath, file.name)
+        const relativePath = fullPath.replace(sourcePath, '')
+        const dp = join(destPath, relativePath)
+        const dd = dirname(dp)
+        if (!existsSync(dd)) {
+          mkdirSync(dd, { recursive: true })
+        }
+        cpSync(fullPath, dp)
+      }
+    }
+    successCount++;
+  }
+
+  spinner.stop(`Installed ${successCount}/${selectedSkills.length} skills to target project`)
+}
+
+async function installSpecificSkills() {
+  const spinner = p.spinner()
+
+  const allSkills = getExistingSkillNames()
+
+  if (allSkills.length === 0) {
+    p.log.warn('No skills found in skills directory. Try running init or sync first.')
+    return
+  }
+
+  const selectedSkills = await p.multiselect({
+    message: 'Select specific skills to install (Space to select, Enter to confirm)',
+    options: allSkills.map(name => ({
+      value: name,
+      label: name
+    }))
+  })
+
+  if (p.isCancel(selectedSkills)) {
+    p.cancel('Cancelled')
+    return
+  }
+
+  if (selectedSkills.length === 0) {
+    p.log.warn('No skills selected')
+    return
+  }
+
+  const targetProject = await p.text({
+    message: 'Enter target project directory path (relative or absolute)',
+    initialValue: process.cwd(),
+    placeholder: process.cwd(),
+    validate: (value) => {
+      if (!value) return 'Path is required'
+      if (!existsSync(value)) return 'Directory does not exist'
+    }
+  })
+
+  if (p.isCancel(targetProject)) {
+    p.cancel('Cancelled')
+    return
+  }
+
+  const toolChoice = await p.select({
+    message: 'Which AI tool are you installing these skills for?',
+    options: [
+      { value: 'skills', label: 'Generic (skills/)', hint: 'Default skills directory' },
+      { value: '.cursor/skills', label: 'Cursor (.cursor/skills)' },
+      { value: '.windsurf/rules', label: 'Windsurf (.windsurf/rules)' },
+      { value: '.claude/skills', label: 'Claude Desktop (.claude/skills)' },
+      { value: '.claudecode/skills', label: 'Claude Code (.claudecode/skills)' },
+      { value: '.agents/skills', label: 'Antigravity (.agents/skills)' },
+      { value: '.vscode/skills', label: 'VSCode / Copilot (.vscode/skills)' },
+      { value: 'custom', label: 'Custom path...' }
+    ]
+  })
+
+  if (p.isCancel(toolChoice)) {
+    p.cancel('Cancelled')
+    return
+  }
+
+  let skillsDirName = toolChoice as string
+
+  if (toolChoice === 'custom') {
+    const customDir = await p.text({
+      message: 'Enter custom skills directory path:',
+      initialValue: 'skills',
+      placeholder: 'skills'
+    })
+
+    if (p.isCancel(customDir)) {
+      p.cancel('Cancelled')
+      return
+    }
+    skillsDirName = customDir as string
+  }
+
+  const targetDir = join(targetProject as string, skillsDirName)
+
+  if (!existsSync(targetDir)) {
+    mkdirSync(targetDir, { recursive: true })
+  }
+
+  spinner.start(`Installing ${selectedSkills.length} skills to ${targetDir}...`)
+
+  let successCount = 0;
+  for (const skill of selectedSkills as string[]) {
+    const sourcePath = join(root, 'skills', skill)
+    if (!existsSync(sourcePath)) {
+      p.log.warn(`Skill not found: ${skill}`)
+      continue
+    }
+
+    const destPath = join(targetDir, skill)
+    if (existsSync(destPath)) {
+      rmSync(destPath, { recursive: true })
+    }
+
+    mkdirSync(destPath, { recursive: true })
+
     const files = readdirSync(sourcePath, { recursive: true, withFileTypes: true })
     for (const file of files) {
       if (file.isFile()) {
@@ -502,15 +646,22 @@ async function main() {
   }
 
   if (command === 'install') {
-    p.intro('Skills Manager - Install')
+    p.intro('Skills Manager - Install Groups')
     await installSkills()
     p.outro('Done')
     return
   }
 
+  if (command === 'add') {
+    p.intro('Skills Manager - Add Specific Skills')
+    await installSpecificSkills()
+    p.outro('Done')
+    return
+  }
+
   if (skipPrompt) {
     p.log.error('Command required when using -y flag')
-    p.log.info('Available commands: install, init, sync, check, cleanup')
+    p.log.info('Available commands: install, add, init, sync, check, cleanup')
     process.exit(1)
   }
 
@@ -519,7 +670,8 @@ async function main() {
   const action = await p.select({
     message: 'What would you like to do?',
     options: [
-      { value: 'install', label: 'Install collections', hint: 'Copy skill collections to a local project' },
+      { value: 'install', label: 'Install collections', hint: 'Copy entire skill collections to a local project' },
+      { value: 'add', label: 'Add specific skills', hint: 'Choose individual skills to add to your project' },
       { value: 'sync', label: 'Sync submodules', hint: 'Pull latest and sync Type 2 skills' },
       { value: 'init', label: 'Init submodules', hint: 'Add new submodules from meta.ts' },
       { value: 'check', label: 'Check updates', hint: 'See available updates' },
@@ -536,6 +688,9 @@ async function main() {
     case 'install':
       await installSkills()
       break
+    case 'add':
+      await installSpecificSkills()
+      break
     case 'init':
       await initSubmodules()
       break