harveyz-skill 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -7,7 +7,43 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.9.0] - 2026-05-28
+## [0.11.0] - 2026-06-09
+
+### Added
+- `hskill list`：新增 Bundle 列并按 bundle 名称排序（替换旧的分组标题格式）；`hskill status` skills 列表同步增加 Bundle 列
+
+### Changed
+- `hskill` 内部重构：平台列表从 `SKILL_TARGETS` 单一来源派生，消除 `bundles.js` / `preview.mjs` 中的硬编码数组
+
+### Fixed
+- `url-extract`：移除 `SKILL_DIR` 用户配置变量
+- `preview`：安装状态侧边栏补全 openclaw、hermes 平台（USER LEVEL）
+- `npm-release`：中间步骤跳过 push 操作，最终统一给出推送 + 发布指令清单
+
+## [0.10.0] - 2026-06-08
+
+### Added
+- `url-extract` skill（`data-extraction` bundle）：跨平台 URL 存档工具，支持 Claude Code / Codex / Hermes，含 Playwright 抓取、SQLite 存储、VAULT_PATH / SKILL_DIR / CHROME_PROFILE 配置
+- `vision-extract` skill（`data-extraction` bundle）：从 hermes-skills 贡献的视觉数据提取 skill
+- `skill-publish` skill（`meta` bundle）：检查 skill 格式合规性与 skills-index.json 注册状态
+- `npm-release` skill（`meta` bundle）：完整 npm 发布工作流（版本号 → CHANGELOG → 分支 → tag → publish）
+- `migrate-specs` skill（`harness` bundle）：将旧 spec 文档迁移为 Diataxis 结构
+- `dir-manage` skill（`document` bundle）：从 writing-agent 贡献的目录管理 skill
+- `capture-insight` skill（`writing` bundle）：从 writing-agent 贡献的洞察捕获 skill
+- `add-todo` skill（`workflow` bundle）：从 harveyz-skill workflow 贡献的 TODO 追踪 skill
+- Diataxis 结构文档：cache、config、bundle、info 模块的参考文档与指南
+
+### Changed
+- `hskill` 安装交互优化：改为两步式（先选 target，再选 scope），更符合操作直觉
+- `url-extract`：通用 SKILL.md + 各平台 patch 文件，支持跨平台复用
+
+### Fixed
+- installer：`--force` 时按 `uninstallPaths` 精确清理，支持版本感知 venv 升级
+- `url-extract`：以 `source_url` 为主键，支持存量 DB schema 迁移
+- `url-extract`：命令注入安全加固，usability 改进
+- SKILL.md frontmatter 跨所有 skill 规范化
+
+## [0.9.0] - 2026-05-29
 
 ### Added
 - `hskill uninstall <tool>` 命令：清理 binary、Python 模块、tool.json、venv 及 zshrc snippet
@@ -22,6 +58,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - p-launch `tool.json` 新增 `uninstallPaths`（`p-launch-venv`）和 `configPaths`（`~/.config/p-launch`）
 
+### Fixed
+- installer：`--force` 重装时根据 `uninstallPaths` 精确清理旧版本文件，避免残留
+- installer：`--force` 重装时正确清理 venv，支持版本感知升级
+- tool 版本对比逻辑：upgrade 前先读取已安装版本，跳过同版本重复安装
+
 ## [0.8.1] - 2026-05-24
 
 ### Fixed

package/bin/cli.js

@@ -12,7 +12,7 @@ import {
   resolveSkills, resolveSkillsByName, resolveTools, resolveToolsByName,
   TOOL_BUNDLE_CHOICES,
 } from '../lib/bundles.js'
-import { buildTargetChoices, resolveTargets, TARGETS } from '../lib/targets.js'
+import { buildTargetChoices, resolveTargets, TARGETS, USER_ONLY_TARGETS } from '../lib/targets.js'
 import { installSkills, installTools, installHooks, installHooksForTarget, uninstallHook, uninstallTool, uninstallSkill } from '../lib/installer.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
@@ -158,29 +158,31 @@ if (subcommand === 'update') {
 
 // ── List ─────────────────────────────────────────────────────────────────────
 if (subcommand === 'list') {
-  const { bundleMeta, skills, tools = [] } = require('../skills-index.json')
-  const byBundle = {}
-  for (const s of skills) {
-    if (!byBundle[s.bundle]) byBundle[s.bundle] = []
-    byBundle[s.bundle].push(s.path)
-  }
+  const { skills, tools = [] } = require('../skills-index.json')
+  const sorted = [...skills].sort((a, b) => a.bundle.localeCompare(b.bundle) || a.path.split('/').pop().localeCompare(b.path.split('/').pop()))
   if (jsonFlag) {
-    const bundles = {}
-    for (const [name, paths] of Object.entries(byBundle)) {
-      bundles[name] = { description: bundleMeta[name] ?? name, skills: paths }
-    }
-    console.log(JSON.stringify({ bundles, tools: tools.map(t => t.name) }, null, 2))
+    console.log(JSON.stringify({
+      skills: sorted.map(s => ({ name: s.path.split('/').pop(), path: s.path, bundle: s.bundle })),
+      tools: tools.map(t => t.name),
+    }, null, 2))
     process.exit(0)
   }
-  for (const [name, paths] of Object.entries(byBundle)) {
-    console.log(chalk.bold(name) + ' — ' + (bundleMeta[name] ?? name))
-    for (const p of paths) console.log('  ' + p)
+  const nw = Math.max(...sorted.map(s => s.path.split('/').pop().length), 4)
+  const bw = Math.max(...sorted.map(s => s.bundle.length), 6)
+  const sep = chalk.dim('  ' + '─'.repeat(nw + bw + 4))
+  console.log('')
+  console.log('  ' + chalk.bold('NAME'.padEnd(nw)) + '  ' + chalk.bold('BUNDLE'))
+  console.log(sep)
+  for (const s of sorted) {
+    console.log('  ' + s.path.split('/').pop().padEnd(nw) + '  ' + chalk.dim(s.bundle))
   }
   if (tools.length > 0) {
     console.log('')
-    console.log(chalk.bold('shell tools:'))
+    console.log('  ' + chalk.bold('SHELL TOOLS'))
+    console.log(sep)
     for (const t of tools) console.log('  ' + t.name)
   }
+  console.log('')
   process.exit(0)
 }
 
@@ -208,11 +210,11 @@ if (subcommand === 'status' || subcommand === 'outdated') {
   const skillRows = skillItems.map(s => {
     const inst = checkInstalled(s.skillName, s.version ?? '—')
     return {
-      name: s.skillName, version: s.version ?? '—',
+      name: s.skillName, bundle: s.bundle ?? '—', version: s.version ?? '—',
       userStatus: scopeSummary(inst.user), projectStatus: scopeSummary(inst.project),
       userDetail: inst.user, projectDetail: inst.project,
     }
-  })
+  }).sort((a, b) => a.bundle.localeCompare(b.bundle) || a.name.localeCompare(b.name))
   const toolRows = toolItems.map(t => {
     const inst = checkToolInstalled(t.toolName, t.srcPath)
     return { name: t.toolName, version: t.version ?? '—', ...inst }
@@ -285,15 +287,16 @@ if (subcommand === 'status' || subcommand === 'outdated') {
   const allVers  = [...skillRows, ...toolRows].map(r => r.version)
   const nw = Math.max(...allNames.map(n => n.length), 4)
   const vw = Math.max(...allVers.map(v => v.length), 7)
-  const sep = chalk.dim('  ' + '─'.repeat(nw + vw + 20))
+  const bw = Math.max(...skillRows.map(r => r.bundle.length), 6)
+  const sep = chalk.dim('  ' + '─'.repeat(nw + vw + bw + 22))
 
   console.log('')
   console.log('  ' + chalk.bold('SKILLS') + chalk.dim(`  — ${skillRows.length} available`))
   console.log(sep)
-  console.log('  ' + ''.padEnd(nw + vw + 3) + chalk.dim('user    project'))
+  console.log('  ' + ''.padEnd(nw + vw + bw + 5) + chalk.dim('user    project'))
   for (const r of skillRows) {
     const u = icon(r.userStatus), p = icon(r.projectStatus)
-    console.log('  ' + r.name.padEnd(nw) + '  ' + chalk.dim(r.version.padEnd(vw)) + '  ' + u + '       ' + p)
+    console.log('  ' + r.name.padEnd(nw) + '  ' + chalk.dim(r.version.padEnd(vw)) + '  ' + chalk.dim(r.bundle.padEnd(bw)) + '  ' + u + '       ' + p)
   }
 
   console.log('')
@@ -594,6 +597,69 @@ const scopeArg  = scopeIdx  !== -1 ? installArgs[scopeIdx  + 1] : undefined
 
 const TOOL_BUNDLE_VALUES = new Set(TOOL_BUNDLE_CHOICES.map(c => c.value))
 
+// ── Two-step target→scope selector ───────────────────────────────────────────
+const ALL_SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+
+function selectTargetThenScope() {
+  // Step 1: platform (target)
+  const targetInput = [
+    'claude    ~/.claude/skills/',
+    'cursor    ~/.cursor/skills/',
+    'codex     ~/.codex/skills/',
+    'openclaw  ~/.openclaw/skills/',
+    'hermes    ~/.hermes/skills/',
+    'all       all 5 targets',
+  ].join('\n')
+
+  const targetResult = spawnSync('fzf', [
+    '--multi',
+    '--prompt=  › ',
+    '--header=  安装到  ·  tab 多选  ·  enter 确认  ·  esc 取消',
+    '--layout=reverse',
+    '--border=rounded',
+    '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+  ], {
+    input: targetInput,
+    encoding: 'utf8',
+    stdio: ['pipe', 'pipe', 'inherit'],
+  })
+
+  if (!targetResult.stdout.trim()) return null
+
+  const rawTargets = targetResult.stdout.trim().split('\n')
+    .map(l => l.trim().split(/\s+/)[0])
+  const expandedTargets = rawTargets.includes('all') ? ALL_SKILL_TARGETS : rawTargets
+
+  // Step 2: scope (user/project) — skip if all selected targets are user-only
+  const allUserOnly = expandedTargets.every(t => USER_ONLY_TARGETS.has(t))
+  let scope = 'user'
+  if (!allUserOnly) {
+    const scopeResult = spawnSync('fzf', [
+      '--prompt=  › ',
+      '--header=  安装范围  ·  enter 确认  ·  esc 取消',
+      '--layout=reverse',
+      '--border=rounded',
+      '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+    ], {
+      input: 'user     — 所有项目共享  (~/.{target}/skills/)\nproject  — 仅当前项目  (.{target}/skills/)',
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'inherit'],
+    })
+    if (!scopeResult.stdout.trim()) return null
+    scope = scopeResult.stdout.trim().startsWith('project') ? 'project' : 'user'
+  }
+
+  // Build final list — openclaw/hermes always resolve to user scope
+  const seen = new Set()
+  const result = []
+  for (const t of expandedTargets) {
+    const effectiveScope = USER_ONLY_TARGETS.has(t) ? 'user' : scope
+    const key = `${effectiveScope}/${t}`
+    if (!seen.has(key)) { seen.add(key); result.push({ scope: effectiveScope, target: t }) }
+  }
+  return result  // [{ scope, target }]
+}
+
 function requireFzf() {
   const probe = spawnSync('fzf', ['--version'], { encoding: 'utf8' })
   if (probe.error || probe.status !== 0) {
@@ -804,77 +870,66 @@ try {
       if (!skillItems.length && !toolItems.length && !hookItems.length) continue
 
       // ── Action selection (install / uninstall) ─────────────────────────────
+      // Skip the prompt when nothing is installed yet — default to install.
       let action = 'install'
       if (process.env.HSKILL_TEST_ACTION) {
         action = process.env.HSKILL_TEST_ACTION
       } else {
-        const actionResult = spawnSync('fzf', [
-          '--prompt=  › ',
-          '--header=  Action  ·  enter 确认  ·  esc 取消',
-          '--layout=reverse',
-          '--border=rounded',
-          '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
-        ], {
-          input: `install    安装 / 重新安装\nuninstall  卸载并清理文件`,
-          encoding: 'utf8',
-          stdio: ['pipe', 'pipe', 'inherit'],
-        })
-        if (!actionResult.stdout.trim()) {
-          console.log(chalk.dim('  · Cancelled'))
-          break
-        }
-        action = actionResult.stdout.trim().startsWith('uninstall') ? 'uninstall' : 'install'
-      }
+        const anyInstalled =
+          skillItems.some(s => {
+            const inst = checkInstalled(s.skillName, s.version ?? '—')
+            return scopeSummary(inst.user) !== 'none' || scopeSummary(inst.project) !== 'none'
+          }) ||
+          toolItems.some(t => checkToolInstalled(t.toolName, t.srcPath).status !== 'none') ||
+          hookItems.some(h => {
+            const inst = checkHookInstalled(h.name)
+            return inst.user.status !== 'none' || inst.project.status !== 'none'
+          })
 
-      if (action === 'install') {
-        let skillSummary = null
-        if (skillItems.length > 0) {
-          // Scope selection
-          const scopeResult = spawnSync('fzf', [
+        if (anyInstalled) {
+          const actionResult = spawnSync('fzf', [
             '--prompt=  › ',
-            '--header=  Scope  ·  enter 确认  ·  esc 取消',
+            '--header=  Action  ·  enter 确认  ·  esc 取消',
             '--layout=reverse',
             '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
           ], {
-            input: `user     — ~/.claude/skills/  (所有项目共享)\nproject  — .claude/skills/    (仅当前项目)`,
+            input: `install    安装 / 重新安装\nuninstall  卸载并清理文件`,
             encoding: 'utf8',
             stdio: ['pipe', 'pipe', 'inherit'],
           })
-          if (!scopeResult.stdout.trim()) {
+          if (!actionResult.stdout.trim()) {
             console.log(chalk.dim('  · Cancelled'))
             break
           }
-          const scope = scopeResult.stdout.trim().startsWith('project') ? 'project' : 'user'
+          action = actionResult.stdout.trim().startsWith('uninstall') ? 'uninstall' : 'install'
+        }
+      }
 
-          // Target selection
-          const targetChoices = buildTargetChoices(scope)
-          const targetInput = targetChoices.map(c => c.name).join('\n') + '\nall      — all tools'
-          const targetResult = spawnSync('fzf', [
-            '--multi',
-            '--prompt=  › ',
-            '--header=  Install to  ·  tab 多选  ·  enter 确认  ·  esc 取消',
-            '--layout=reverse',
-            '--border=rounded',
-            '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
-          ], {
-            input: targetInput,
-            encoding: 'utf8',
-            stdio: ['pipe', 'pipe', 'inherit'],
-          })
-          if (!targetResult.stdout.trim()) {
+      if (action === 'install') {
+        let skillSummary = null
+        if (skillItems.length > 0) {
+          // Combined scope+target selection (one step instead of two)
+          const selectedST = selectTargetThenScope()
+          if (!selectedST) {
             console.log(chalk.dim('  · Cancelled'))
             break
           }
-          const selectedTargets = targetResult.stdout.trim().split('\n')
-            .map(l => l.trim().split(/\s+/)[0])
 
-          if (selectedTargets.length > 0) {
+          // Group by scope so we make one installSkills call per scope
+          const byScope = {}
+          for (const { scope, target } of selectedST) {
+            if (!byScope[scope]) byScope[scope] = []
+            byScope[scope].push(target)
+          }
+
+          console.log('')
+          for (const [scope, selectedTargets] of Object.entries(byScope)) {
             const targets = resolveTargets(selectedTargets, scope)
-            console.log('')
-            skillSummary = await installSkills(skillItems, targets, forceFlag)
-            console.log('')
+            const result = await installSkills(skillItems, targets, forceFlag)
+            skillSummary = skillSummary ? { ...skillSummary, ...result } : result
           }
+          console.log('')
         }
 
         let toolSummary = null
@@ -960,30 +1015,33 @@ try {
         }
 
         for (const item of uSkillItems) {
-          const scopeRes = spawnSync('fzf', [
-            '--prompt=  › ',
-            '--header=  Uninstall from scope  ·  enter 确认  ·  esc 取消',
+          // Step 1: target (platform)
+          const targetChoices2 = buildTargetChoices('user')
+          const targetRes = spawnSync('fzf', [
+            '--multi', '--prompt=  › ',
+            '--header=  从哪里卸载  ·  tab 多选  ·  enter 确认  ·  esc 取消',
             '--layout=reverse', '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
           ], {
-            input: `user     — ~/.claude/skills/\nproject  — .claude/skills/`,
+            input: targetChoices2.map(c => c.name).join('\n') + '\nall      — all targets',
             encoding: 'utf8', stdio: ['pipe', 'pipe', 'inherit'],
           })
-          if (!scopeRes.stdout.trim()) { console.log(chalk.dim('  · Cancelled')); break }
-          const scope2 = scopeRes.stdout.trim().startsWith('project') ? 'project' : 'user'
+          if (!targetRes.stdout.trim()) { console.log(chalk.dim('  · Cancelled')); break }
+          const selTargets2 = targetRes.stdout.trim().split('\n').map(l => l.trim().split(/\s+/)[0])
 
-          const targetChoices2 = buildTargetChoices(scope2)
-          const targetRes = spawnSync('fzf', [
-            '--multi', '--prompt=  › ',
-            '--header=  Uninstall from  ·  tab 多选  ·  enter 确认',
+          // Step 2: scope (user/project)
+          const scopeRes = spawnSync('fzf', [
+            '--prompt=  › ',
+            '--header=  卸载范围  ·  enter 确认  ·  esc 取消',
             '--layout=reverse', '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
           ], {
-            input: targetChoices2.map(c => c.name).join('\n') + '\nall      — all tools',
+            input: 'user     — 所有项目  (~/.{target}/skills/)\nproject  — 仅当前项目  (.{target}/skills/)',
             encoding: 'utf8', stdio: ['pipe', 'pipe', 'inherit'],
           })
-          if (!targetRes.stdout.trim()) { console.log(chalk.dim('  · Cancelled')); break }
-          const selTargets2 = targetRes.stdout.trim().split('\n').map(l => l.trim().split(/\s+/)[0])
+          if (!scopeRes.stdout.trim()) { console.log(chalk.dim('  · Cancelled')); break }
+          const scope2 = scopeRes.stdout.trim().startsWith('project') ? 'project' : 'user'
+
           const targets2 = resolveTargets(selTargets2, scope2)
           for (const { dir } of targets2) {
             await uninstallSkill(item.skillName, dir)
@@ -1043,66 +1101,36 @@ try {
   // ── Install skills ──────────────────────────────────────────────────────────
   let skillSummary = null
   if (skillItems.length > 0) {
-    // Resolve scope
-    let scope = scopeArg ?? 'user'
-    if (!scopeArg && !targetArg) {
-      if (!process.stdout.isTTY) {
-        console.error(chalk.red('  ✗ Interactive scope selection requires a TTY. Use --scope user|project.'))
-        process.exit(1)
-      }
-      const scopeResult = spawnSync('fzf', [
-        '--prompt=  › ',
-        '--header=  Scope  ·  enter 确认  ·  esc 取消',
-        '--layout=reverse',
-        '--border=rounded',
-        '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
-      ], {
-        input: `user     — ~/.claude/skills/  (所有项目共享)\nproject  — .claude/skills/    (仅当前项目)`,
-        encoding: 'utf8',
-        stdio: ['pipe', 'pipe', 'inherit'],
-      })
-      if (!scopeResult.stdout.trim()) {
-        console.log(chalk.dim('  · Cancelled'))
-        process.exit(0)
-      }
-      scope = scopeResult.stdout.trim().startsWith('project') ? 'project' : 'user'
-    }
-
-    // Resolve target
-    let selectedTargets
+    // When --target is given, use it directly (with --scope or default 'user').
+    // When only --skill is given and no --target, use the combined selector.
     if (targetArg) {
-      selectedTargets = targetArg === 'all' ? ['claude', 'cursor', 'codex', 'openclaw', 'hermes'] : [targetArg]
+      const scope = scopeArg ?? 'user'
+      const selectedTargets = targetArg === 'all' ? ['claude', 'cursor', 'codex', 'openclaw', 'hermes'] : [targetArg]
+      const targets = resolveTargets(selectedTargets, scope)
+      console.log('')
+      skillSummary = await installSkills(skillItems, targets, forceFlag)
+      console.log('')
     } else {
       if (!process.stdout.isTTY) {
         console.error(chalk.red('  ✗ Interactive target selection requires a TTY. Use --target claude|cursor|codex|openclaw|hermes|all.'))
         process.exit(1)
       }
-      const targetChoices = buildTargetChoices(scope)
-      const targetInput = targetChoices.map(c => c.name).join('\n') + '\nall      — all tools'
-      const targetResult = spawnSync('fzf', [
-        '--multi',
-        '--prompt=  › ',
-        '--header=  Install to  ·  tab 多选  ·  enter 确认  ·  esc 取消',
-        '--layout=reverse',
-        '--border=rounded',
-        '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
-      ], {
-        input: targetInput,
-        encoding: 'utf8',
-        stdio: ['pipe', 'pipe', 'inherit'],
-      })
-      if (!targetResult.stdout.trim()) {
+      const selectedST = selectTargetThenScope()
+      if (!selectedST) {
         console.log(chalk.dim('  · Cancelled'))
         process.exit(0)
       }
-      selectedTargets = targetResult.stdout.trim().split('\n')
-        .map(l => l.trim().split(/\s+/)[0])
-    }
-
-    if (selectedTargets.length > 0) {
-      const targets = resolveTargets(selectedTargets, scope)
+      const byScope = {}
+      for (const { scope, target } of selectedST) {
+        if (!byScope[scope]) byScope[scope] = []
+        byScope[scope].push(target)
+      }
       console.log('')
-      skillSummary = await installSkills(skillItems, targets, forceFlag)
+      for (const [scope, selectedTargets] of Object.entries(byScope)) {
+        const targets = resolveTargets(selectedTargets, scope)
+        const result = await installSkills(skillItems, targets, forceFlag)
+        skillSummary = skillSummary ? { ...skillSummary, ...result } : result
+      }
       console.log('')
     }
   }

package/bin/preview.mjs

@@ -3,6 +3,7 @@ import fs from 'fs'
 import os from 'os'
 import path from 'path'
 import { fileURLToPath } from 'url'
+import { SKILL_TARGETS, USER_ONLY_TARGETS } from '../lib/targets.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
@@ -72,10 +73,11 @@ function statusLine(version, status) {
   return ver + '  ' + D + '— not installed' + R
 }
 
-const targets = ['claude', 'cursor', 'codex']
+const userTargets    = SKILL_TARGETS
+const projectTargets = SKILL_TARGETS.filter(t => !USER_ONLY_TARGETS.has(t))
 const home    = os.homedir()
 
-function checkScope(dirFn) {
+function checkScope(targets, dirFn) {
   return targets.map(t => {
     const ver    = readVersion(path.join(dirFn(t), skillName))
     const status = ver === '—' ? 'none'
@@ -86,10 +88,10 @@ function checkScope(dirFn) {
 }
 
 const cwd = process.cwd()
-const userDetails    = checkScope(t => path.join(home, `.${t}`, 'skills'))
+const userDetails    = checkScope(userTargets,    t => path.join(home, `.${t}`, 'skills'))
 const projectDetails = cwd === home
-  ? targets.map(t => ({ tool: t, version: '—', status: 'none' }))
-  : checkScope(t => path.join(cwd, `.${t}`, 'skills'))
+  ? projectTargets.map(t => ({ tool: t, version: '—', status: 'none' }))
+  : checkScope(projectTargets, t => path.join(cwd, `.${t}`, 'skills'))
 
 console.log(B + skillName + R)
 console.log(D + 'available: ' + R + availableVersion)

package/lib/bundles.js

@@ -3,7 +3,7 @@ import os from 'os'
 import { createRequire } from 'module'
 import path from 'path'
 import { fileURLToPath } from 'url'
-import { USER_ONLY_TARGETS } from './targets.js'
+import { SKILL_TARGETS, USER_ONLY_TARGETS } from './targets.js'
 
 const require = createRequire(import.meta.url)
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
@@ -101,13 +101,14 @@ export function buildAllChoices() {
   return choices
 }
 
-// 所有 skill 展开为 { kind:'skill', skillName, srcPath } 列表（对应 all 选项）
+// 所有 skill 展开为 { kind:'skill', skillName, bundle, srcPath } 列表（对应 all 选项）
 export function getAllSkillItems() {
   return skillDefs.map(skill => {
     const srcPath = path.join(skillsRoot, skill.path)
     return {
       kind: 'skill',
       skillName: skill.path.split('/').pop(),
+      bundle: skill.bundle,
       srcPath,
       version: readVersion(srcPath),
     }
@@ -132,7 +133,7 @@ export function getAllToolItems() {
 // 每个工具: { version: string, status: 'up-to-date'|'update'|'none' }
 export function checkInstalled(skillName, availableVersion) {
   const home = os.homedir()
-  const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+  const targets = SKILL_TARGETS
 
   function checkScope(dirFn) {
     const result = {}

package/lib/targets.js

@@ -1,7 +1,7 @@
 import os from 'os'
 import path from 'path'
 
-const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+export const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
 
 export const USER_ONLY_TARGETS = new Set(['openclaw', 'hermes'])
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
@@ -28,10 +28,18 @@
     "skills/task/pm-task-dispatch/",
     "skills/task/task-close/",
     "skills/web-fetch/article-fetcher/",
+    "skills/web-fetch/url-extract/",
+    "skills/data-extraction/vision-extract/",
     "skills/writing/mermaid-diagram/",
     "skills/design/sync-design-html/",
     "skills/analysis/git-cleanup/",
     "skills/meta/contribute-skill/",
+    "skills/harness/migrate-specs/",
+    "skills/workflow/add-todo/",
+    "skills/harness/dir-manage/",
+    "skills/writing/capture-insight/",
+    "skills/meta/skill-publish/",
+    "skills/meta/npm-release/",
     "tools/p-launch/",
     "hooks/check-similar-branch/"
   ],

package/skills/analysis/git-cleanup/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: git-cleanup
-description: "梳理并清理本地 git 分支。规则匹配 + LLM 语义分析，分组确认后批量删除废弃分支。触发词：清理分支、branch cleanup、梳理分支、删除旧分支、整理分支"
+description: "Tidy and clean up local git branches using rule matching and LLM semantic analysis, then batch-delete stale branches after grouped confirmation. Triggers: clean up branches, branch cleanup, tidy branches, delete old branches, organize branches."
 user_invocable: true
 version: "1.0.0"
 ---

package/skills/analysis/skill-analyzer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: skill-analyzer
-description: "对 Skill 仓库进行系统性分析。触发词：分析这个 skill 仓库、对这个 skill 仓库做系统性研究、输出 skill 仓库的分析报告、理解这个 skill 系统的设计意图"
+description: "Performs systematic analysis of the skill repository. Triggers: analyze this skill repo, do a systematic study of the skill repo, output skill repo analysis report, understand the design intent of this skill system."
 user_invocable: true
 version: "1.0.0"
 ---