harveyz-skill 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.26.0] - 2026-08-12
+
+### Added
+- `hskill mcp`：新增 MCP（Model Context Protocol）服务器子命令，以 stdio 方式暴露 8 个工具（`hskill_list`/`hskill_status`/`hskill_outdated`/`hskill_info`/`hskill_install`/`hskill_uninstall`/`hskill_hooks`/`hskill_update`），供 MCP 兼容的 agent host（Claude Code、Claude Desktop、Cursor 等）直接调用 hskill 的操作
+
+### Changed
+- `publish-skill` 审计：修正 `pdf-math-translate` description 语言违规（改为英文），刷新 `capture-vocab`/`extract-url`/`pdf-math-translate` 三个 skill 的 contentHash 记录
+
+## [0.25.1] - 2026-07-22
+
+### Fixed
+- `extract-url`：新增微信公众号文章抓取脚本（`playwright_web_wechat.py`），修复隐藏正文、懒加载图片、发布日期提取失败问题
+- `extract-url`：修复 X.com Article 正文中加粗文字被错误拆分为独立段落、加粗样式丢失的问题
+
 ## [0.25.0] - 2026-07-20
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # harveyz-skill
 
-Harvey 的个人 Claude Code / Cursor / Codex 技能管理器，当前版本 **v0.6.2**。
+Harvey 的个人 Claude Code / Cursor / Codex / OpenClaw / Hermes / OpenCode / Pi 技能管理器，当前版本 **v0.6.2**。
 
 通过 `hskill` 命令将技能安装到 `~/.claude/skills/`，按 bundle 分组管理。
 
@@ -134,6 +134,40 @@ hskill hooks uninstall check-similar-branch --scope project    # 从当前项目
 
 ---
 
+## MCP Server
+
+`hskill mcp` 会启动一个基于 stdio 的 MCP（Model Context Protocol）服务器，让 MCP 兼容的 agent host（Claude Code、Claude Desktop、Cursor 等）可以直接调用 hskill 的操作，而不需要人工手动执行 CLI 命令。
+
+暴露的 8 个工具：
+
+| 工具 | 说明 |
+|------|------|
+| **hskill_list** | 列出所有可用的 skill 和 bundle |
+| **hskill_status** | 显示所有 skill、工具、hook 在各个 target 上的安装状态 |
+| **hskill_outdated** | 列出有可用更新的 skill 和工具 |
+| **hskill_info** | 显示指定 skill 或工具的安装详情 |
+| **hskill_install** | 安装一个 bundle、指定 skill 或 shell 工具 |
+| **hskill_uninstall** | 卸载指定的 skill 或 shell 工具 |
+| **hskill_hooks** | 查看、安装或卸载 hskill git hooks |
+| **hskill_update** | 将 hskill 自身更新到最新版本 |
+
+在 MCP host 的配置中注册（假设已通过 `npm install -g harveyz-skill` 全局安装）：
+
+```json
+{
+  "mcpServers": {
+    "hskill": {
+      "command": "hskill",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+本地源码开发时，可将 `command` 换成 `node`，`args` 换成 `["bin/cli.js", "mcp"]`。
+
+---
+
 ## Skill 开发指南
 
 ### 目录结构

package/bin/cli.js

@@ -27,7 +27,7 @@ const jsonFlag = args.includes('--json')
 // ── Help ─────────────────────────────────────────────────────────────────────
 function printHelp() {
   console.log(`
-  ${chalk.bold('hskill')} — skill manager for Claude Code, Cursor, Codex, OpenClaw, Hermes, and OpenCode  v${version}
+  ${chalk.bold('hskill')} — skill manager for Claude Code, Cursor, Codex, OpenClaw, Hermes, OpenCode, and Pi  v${version}
 
   ${chalk.cyan('Usage:')}
     hskill                         interactive install (requires TTY + fzf)
@@ -35,7 +35,7 @@ function printHelp() {
     hskill install --bundle <b>    install a skill bundle
     hskill install --skill <s>     install specific skill(s)
     hskill install --tool <t>      install shell tool(s)
-    hskill install --target <t>    set target (claude/cursor/codex/openclaw/hermes/opencode/all)
+    hskill install --target <t>    set target (${SKILL_TARGETS.join('/')}/all)
     hskill install --scope <s>     set scope: user (default) or project
     hskill install --force         overwrite existing installs
     hskill list [--json]           list available skills and bundles
@@ -51,6 +51,7 @@ function printHelp() {
     hskill uninstall <tool> --yes      skip all confirmations (incl. config files)
     hskill uninstall <skill> --scope <s> --target <t>  uninstall a skill
     hskill update                  update hskill to the latest version
+    hskill mcp                     start an MCP server (stdio) exposing hskill's tools to MCP-capable agent hosts
     hskill version                 show version
     hskill --help                  show this help
 
@@ -75,7 +76,7 @@ if (args[0] === '--help' || args[0] === '-h') {
     console.log(JSON.stringify({
       name: 'hskill',
       version,
-      description: 'Skill manager for Claude Code, Cursor, Codex, OpenClaw, and Hermes',
+      description: 'Skill manager for Claude Code, Cursor, Codex, OpenClaw, Hermes, OpenCode, and Pi',
       agent_notes: 'Interactive mode requires TTY. Use --json for machine-readable output. Set NO_COLOR=1 to suppress ANSI codes.',
       commands: [
         {
@@ -87,7 +88,7 @@ if (args[0] === '--help' || args[0] === '-h') {
             { name: '--bundle', arg: '<name>',   description: 'Install a skill bundle (comma-separated)' },
             { name: '--skill',  arg: '<name>',   description: 'Install specific skill(s) (comma-separated)' },
             { name: '--tool',   arg: '<name>',   description: 'Install shell tool(s) (comma-separated)' },
-            { name: '--target', arg: '<target>', description: 'Install target', enum: ['claude','cursor','codex','openclaw','hermes','opencode','all'] },
+            { name: '--target', arg: '<target>', description: 'Install target', enum: [...SKILL_TARGETS,'all'] },
             { name: '--scope',  arg: '<scope>',  description: 'Install scope', enum: ['user','project'], default: 'user' },
             { name: '--force',  description: 'Overwrite existing installs' },
           ],
@@ -129,7 +130,7 @@ if (args[0] === '--help' || args[0] === '-h') {
           note: 'Only upgrades skills already installed on the given target. Never installs new ones.',
           flags: [
             { name: '--skill',  arg: '<name>',   description: 'Upgrade a specific skill (default: all installed)' },
-            { name: '--target', arg: '<target>', description: 'Limit to one target', enum: ['claude','cursor','codex','openclaw','hermes','opencode'] },
+            { name: '--target', arg: '<target>', description: 'Limit to one target', enum: SKILL_TARGETS },
             { name: '--scope',  arg: '<scope>',  description: 'Install scope', enum: ['user','project'], default: 'user' },
             { name: '--json',   description: 'Machine-readable output' },
           ],
@@ -138,6 +139,10 @@ if (args[0] === '--help' || args[0] === '-h') {
           name: 'update',
           description: 'Update hskill to the latest version via npm',
         },
+        {
+          name: 'mcp',
+          description: "Start an MCP server (stdio) exposing hskill's tools to MCP-capable agent hosts",
+        },
         {
           name: 'version',
           description: 'Print version and exit',
@@ -189,6 +194,20 @@ if (subcommand === 'update') {
   process.exit(0)
 }
 
+// ── MCP server ───────────────────────────────────────────────────────────────
+if (subcommand === 'mcp') {
+  const { startServer } = await import('../lib/mcp-server.js')
+  await startServer()
+  // StdioServerTransport keeps stdin/stdout open for JSON-RPC. bin/cli.js is a
+  // flat top-level script with no early-return mechanism (this is a real ES
+  // module, so a bare top-level `return` is a syntax error) — every other
+  // subcommand block ends itself with process.exit(), which we can't do here
+  // without killing the server we just started. Blocking on a promise that
+  // never resolves is what stops execution from falling through into the
+  // generic install-arg parsing near the end of this file.
+  await new Promise(() => {})
+}
+
 // ── List ─────────────────────────────────────────────────────────────────────
 if (subcommand === 'list') {
   const { skills, tools = [] } = require('../skills-index.json')
@@ -285,7 +304,7 @@ if (subcommand === 'status' || subcommand === 'outdated') {
   })
 
   if (jsonFlag) {
-    const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
+    const targets = SKILL_TARGETS
     const jsonSkills = skillRows.map(r => ({
       name: r.name,
       version: r.version,
@@ -317,7 +336,7 @@ if (subcommand === 'status' || subcommand === 'outdated') {
       process.exit(0)
     }
 
-    const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
+    const targets = SKILL_TARGETS
 
     if (outdatedSkills.length) {
       console.log('\n  ' + chalk.bold('SKILLS WITH UPDATES'))
@@ -420,7 +439,7 @@ if (subcommand === 'info') {
     process.exit(1)
   }
 
-  const targets = ['claude', 'cursor', 'codex']
+  const targets = SKILL_TARGETS
 
   function statusLabel(status) {
     if (status === 'up-to-date') return chalk.green('✓ up to date')
@@ -476,7 +495,9 @@ if (subcommand === 'info') {
 if (subcommand === 'uninstall') {
   const nameToRemove = args[1]
   if (!nameToRemove || nameToRemove.startsWith('--')) {
-    console.error(chalk.red('  ✗ Usage: hskill uninstall <tool-or-skill-name> [--yes] [--scope user|project] [--target claude|...]'))
+    const msg = 'Usage: hskill uninstall <tool-or-skill-name> [--yes] [--scope user|project] [--target claude|...]'
+    if (jsonFlag) process.stderr.write(JSON.stringify({ error: true, message: msg }) + '\n')
+    else console.error(chalk.red('  ✗ ' + msg))
     process.exit(1)
   }
 
@@ -492,13 +513,24 @@ if (subcommand === 'uninstall') {
   const isSkill = skillItems2.some(s => s.skillName === nameToRemove)
 
   if (!isTool && !isSkill) {
-    console.error(chalk.red(`  ✗ Unknown tool or skill: "${nameToRemove}"`))
+    const msg = `Unknown tool or skill: "${nameToRemove}"`
+    if (jsonFlag) process.stderr.write(JSON.stringify({ error: true, message: msg }) + '\n')
+    else console.error(chalk.red('  ✗ ' + msg))
     process.exit(1)
   }
 
   if (isTool) {
+    // uninstallTool logs unconditional chalk status lines via console.error;
+    // suppress them in --json mode so they don't pollute stderr JSON output.
+    const originalError = jsonFlag ? console.error : null
+    if (jsonFlag) console.error = () => {}
     const { removed, failed } = await uninstallTool(nameToRemove, { yes: yesFlag })
-    if (removed.length > 0) console.error(chalk.green.bold(`✔ ${nameToRemove} uninstalled`))
+    if (jsonFlag) {
+      console.error = originalError
+      console.log(JSON.stringify({ removed: removed.length > 0, failed: failed.length > 0 }, null, 2))
+    } else if (removed.length > 0) {
+      console.error(chalk.green.bold(`✔ ${nameToRemove} uninstalled`))
+    }
     process.exit(failed.length ? 1 : 0)
   }
 
@@ -506,17 +538,26 @@ if (subcommand === 'uninstall') {
   const scope = scopeArg2
   const selectedTargets = targetArg2
     ? [targetArg2]
-    : ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
+    : SKILL_TARGETS
   const targets = resolveTargets(selectedTargets, scope)
 
   let anyRemoved = false
   let anyFailed  = false
+  // uninstallSkill logs unconditional chalk status lines via console.error;
+  // suppress them in --json mode so they don't pollute stderr JSON output.
+  const originalError2 = jsonFlag ? console.error : null
+  if (jsonFlag) console.error = () => {}
   for (const { dir } of targets) {
     const { removed, failed } = await uninstallSkill(nameToRemove, dir)
     if (removed.length) anyRemoved = true
     if (failed.length)  anyFailed  = true
   }
-  if (anyRemoved) console.error(chalk.green.bold(`✔ ${nameToRemove} uninstalled`))
+  if (jsonFlag) {
+    console.error = originalError2
+    console.log(JSON.stringify({ removed: anyRemoved, failed: anyFailed }, null, 2))
+  } else if (anyRemoved) {
+    console.error(chalk.green.bold(`✔ ${nameToRemove} uninstalled`))
+  }
   process.exit(anyFailed ? 1 : 0)
 }
 
@@ -635,11 +676,17 @@ if (subcommand === 'hooks') {
   if (hooksSubcmd === 'uninstall') {
     const nameToRemove = args[2]
     if (!nameToRemove || nameToRemove.startsWith('--')) {
-      console.error(chalk.red('  ✗ Usage: hskill hooks uninstall <name> [--scope user|project]'))
+      const msg = 'Usage: hskill hooks uninstall <name> [--scope user|project]'
+      if (hookJsonFlag) process.stderr.write(JSON.stringify({ error: true, message: msg }) + '\n')
+      else console.error(chalk.red('  ✗ ' + msg))
       process.exit(1)
     }
     const { removed } = await uninstallHook(nameToRemove, hookScopeArg, hookProjectArg)
-    if (!removed) console.log(chalk.dim(`  · ${nameToRemove} was not installed in ${hookScopeArg} scope`))
+    if (hookJsonFlag) {
+      console.log(JSON.stringify({ removed }, null, 2))
+    } else if (!removed) {
+      console.log(chalk.dim(`  · ${nameToRemove} was not installed in ${hookScopeArg} scope`))
+    }
     process.exit(0)
   }
 
@@ -721,20 +768,24 @@ 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', 'opencode']
+// Paths are derived from SKILL_TARGETS/userSkillDir (lib/targets.js) — the single
+// source of truth — so adding a target there is enough to update every view here.
+const TARGET_DIRS = SKILL_TARGETS.map(name => {
+  const real = userSkillDir(name)
+  return { name, real, disp: real.replace(os.homedir(), '~') }
+})
 
 function selectTargetThenScope() {
   // Step 1: platform (target)
   const targetInput = [
-    'claude    ~/.claude/skills/',
-    'cursor    ~/.cursor/skills/',
-    'codex     ~/.codex/skills/',
-    'openclaw  ~/.openclaw/skills/',
-    'hermes    ~/.hermes/skills/',
-    'opencode  ~/.config/opencode/skills/',
-    'all       all 6 targets',
+    ...TARGET_DIRS.map(({ name, disp }) => `${name.padEnd(8)}  ${disp}/`),
+    `all       all ${TARGET_DIRS.length} targets`,
   ].join('\n')
 
+  const allEchoLines = TARGET_DIRS.map(({ disp }) => `echo "  ${disp}/";`).join(' ')
+  const caseArms      = TARGET_DIRS.map(({ name, disp, real }) => `${name}) disp="${disp}/"; real="${real}/";;`).join(' ')
+  const previewScript = `t=$(echo {} | awk '{print $1}'); if [ "$t" = "all" ]; then echo ""; echo "  安装到所有平台:"; echo ""; ${allEchoLines} else case "$t" in ${caseArms} esac; echo ""; echo "  安装路径:"; echo ""; printf "  \\033[36m%s\\033[0m\\n" "$disp"; echo ""; if [ -d "$real" ]; then echo "  ✓ 目录已存在"; else echo "  · 将自动新建"; fi; fi`
+
   const targetResult = spawnSync('fzf', [
     '--multi',
     '--prompt=  › ',
@@ -742,7 +793,7 @@ function selectTargetThenScope() {
     '--layout=reverse',
     '--border=rounded',
     '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
-    '--preview=t=$(echo {} | awk \'{print $1}\'); if [ "$t" = "all" ]; then echo ""; echo "  安装到所有平台:"; echo ""; for p in claude cursor codex openclaw hermes opencode; do printf "  ~/.%s/skills/\\n" "$p"; done; else p="${HOME}/.${t}/skills/"; echo ""; echo "  安装路径:"; echo ""; printf "  \\033[36m%s\\033[0m\\n" "$p"; echo ""; if [ -d "$p" ]; then echo "  ✓ 目录已存在"; else echo "  · 将自动新建"; fi; fi',
+    `--preview=${previewScript}`,
     '--preview-window=right:45%:wrap',
   ], {
     input: targetInput,
@@ -754,7 +805,7 @@ function selectTargetThenScope() {
 
   const rawTargets = targetResult.stdout.trim().split('\n')
     .map(l => l.trim().split(/\s+/)[0])
-  const expandedTargets = rawTargets.includes('all') ? ALL_SKILL_TARGETS : rawTargets
+  const expandedTargets = rawTargets.includes('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))
@@ -1258,7 +1309,7 @@ try {
             '--header=  从哪里卸载  ·  tab 多选  ·  enter 确认  ·  esc 取消',
             '--layout=reverse', '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
-            '--preview=t=$(echo {} | awk \'{print $1}\'); if [ "$t" = "all" ]; then echo ""; echo "  从所有平台卸载:"; echo ""; for p in claude cursor codex openclaw hermes opencode; do printf "  ~/.%s/skills/\\n" "$p"; done; else echo ""; printf "  ~/.%s/skills/\\n" "$t"; fi',
+            `--preview=t=$(echo {} | awk '{print $1}'); if [ "$t" = "all" ]; then echo ""; echo "  从所有平台卸载:"; echo ""; ${TARGET_DIRS.map(({ disp }) => `echo "  ${disp}/";`).join(' ')} else case "$t" in ${TARGET_DIRS.map(({ name, disp }) => `${name}) echo ""; echo "  ${disp}/";;`).join(' ')} esac; fi`,
             '--preview-window=right:45%:wrap',
           ], {
             input: targetChoices2.map(c => c.name).join('\n') + '\nall      — all targets',
@@ -1349,14 +1400,14 @@ try {
     // When only --skill is given and no --target, use the combined selector.
     if (targetArg) {
       const scope = scopeArg ?? 'user'
-      const selectedTargets = targetArg === 'all' ? ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode'] : [targetArg]
+      const selectedTargets = targetArg === 'all' ? SKILL_TARGETS : [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.'))
+        console.error(chalk.red(`  ✗ Interactive target selection requires a TTY. Use --target ${SKILL_TARGETS.join('|')}|all.`))
         process.exit(1)
       }
       const selectedST = selectTargetThenScope()

package/bin/preview.mjs

@@ -3,7 +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'
+import { SKILL_TARGETS, USER_ONLY_TARGETS, userSkillDir } from '../lib/targets.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
@@ -89,7 +89,7 @@ function checkScope(targets, dirFn) {
 // 单平台视图：只展示 ctrl-t 当前所在平台的状态，不展示全平台矩阵
 if (platformKey && SKILL_TARGETS.includes(platformKey)) {
   const cwd = process.cwd()
-  const userDir    = path.join(home, `.${platformKey}`, 'skills')
+  const userDir    = userSkillDir(platformKey)
   const projectDir = path.join(cwd, `.${platformKey}`, 'skills')
   const [userDetail]    = checkScope([platformKey], () => userDir)
   const projectDetail   = USER_ONLY_TARGETS.has(platformKey) || cwd === home
@@ -119,7 +119,7 @@ const userTargets    = SKILL_TARGETS
 const projectTargets = SKILL_TARGETS.filter(t => !USER_ONLY_TARGETS.has(t))
 
 const cwd = process.cwd()
-const userDetails    = checkScope(userTargets,    t => path.join(home, `.${t}`, 'skills'))
+const userDetails    = checkScope(userTargets,    t => userSkillDir(t))
 const projectDetails = cwd === home
   ? projectTargets.map(t => ({ tool: t, version: '—', status: 'none' }))
   : checkScope(projectTargets, t => path.join(cwd, `.${t}`, 'skills'))

package/lib/mcp-server.js

@@ -0,0 +1,173 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { spawn } from 'child_process'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { z } from 'zod'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const CLI_PATH = path.join(__dirname, '..', 'bin', 'cli.js')
+
+// Spawns `node bin/cli.js <argv>` and collects its full stdout/stderr/exit code.
+// Never rejects — callers branch on `code`.
+export function runCli(argv) {
+  return new Promise((resolve) => {
+    const child = spawn(process.execPath, [CLI_PATH, ...argv], { stdio: ['ignore', 'pipe', 'pipe'] })
+    child.stdout.setEncoding('utf8')
+    child.stderr.setEncoding('utf8')
+    let stdout = ''
+    let stderr = ''
+    child.stdout.on('data', (d) => { stdout += d })
+    child.stderr.on('data', (d) => { stderr += d })
+    child.on('close', (code) => resolve({ code, stdout, stderr }))
+  })
+}
+
+// Turns a runCli() result into an MCP CallToolResult. On success, the CLI's
+// stdout JSON is forwarded as-is. On failure, stderr is parsed as the CLI's
+// existing {error:true,message} shape; if that parse fails, the raw stderr
+// text is used so a handler never throws on an unexpected crash.
+export function toToolResult({ code, stdout, stderr }) {
+  if (code === 0) {
+    return { content: [{ type: 'text', text: stdout.trim() || '{}' }] }
+  }
+  // Some CLI commands write valid structured JSON to stdout even on a
+  // non-zero exit (e.g. uninstall's "found but removal failed" case).
+  // Forward that real payload instead of falling back to a generic message.
+  const trimmedStdout = stdout.trim()
+  if (trimmedStdout) {
+    try {
+      JSON.parse(trimmedStdout)
+      return { content: [{ type: 'text', text: trimmedStdout }], isError: true }
+    } catch {
+      // stdout wasn't JSON — fall through to the stderr-based message below
+    }
+  }
+  let message = stderr.trim() || `hskill exited with code ${code}`
+  try {
+    const parsed = JSON.parse(stderr.trim())
+    if (parsed && parsed.error) message = parsed.message
+  } catch {
+    const lastLine = stderr.trim().split('\n').pop()
+    try {
+      const parsed = JSON.parse(lastLine)
+      if (parsed && parsed.error) message = parsed.message
+    } catch {
+      // stderr wasn't JSON — fall back to the raw text already assigned above
+    }
+  }
+  return { content: [{ type: 'text', text: message }], isError: true }
+}
+
+export function createServer() {
+  const server = new McpServer({ name: 'hskill', version: '1.0.0' })
+
+  server.registerTool('hskill_list', {
+    description: 'List all available hskill skills and bundles.',
+    inputSchema: {},
+  }, async () => toToolResult(await runCli(['list', '--json'])))
+
+  server.registerTool('hskill_status', {
+    description: 'Show install status for all skills, tools, and hooks across every target.',
+    inputSchema: {},
+  }, async () => toToolResult(await runCli(['status', '--json'])))
+
+  server.registerTool('hskill_outdated', {
+    description: 'List only the skills and tools that have an available update.',
+    inputSchema: {},
+  }, async () => toToolResult(await runCli(['outdated', '--json'])))
+
+  server.registerTool('hskill_info', {
+    description: 'Show install detail for one named skill or tool, as returned by hskill_list.',
+    inputSchema: {
+      name: z.string().describe('Skill or tool name, exactly as shown by hskill_list'),
+    },
+  }, async ({ name }) => toToolResult(await runCli(['info', name, '--json'])))
+
+  server.registerTool('hskill_install', {
+    description: 'Install a skill bundle, a specific skill, or a shell tool. Writes files under ~/.claude/skills (or the equivalent dir for --target) or a project directory. Provide exactly one of bundle, skill, or tool.',
+    inputSchema: {
+      bundle: z.string().optional().describe('Bundle name(s) to install, comma-separated'),
+      skill: z.string().optional().describe('Specific skill name(s) to install, comma-separated'),
+      tool: z.string().optional().describe('Specific shell tool name(s) to install, comma-separated'),
+      target: z.string().optional().describe('Target host: claude, cursor, codex, opencode, etc., or "all"'),
+      scope: z.enum(['user', 'project']).optional().describe('Install scope, defaults to user'),
+      force: z.boolean().optional().describe('Overwrite an existing install'),
+    },
+  }, async ({ bundle, skill, tool, target, scope, force }) => {
+    const argv = ['install']
+    if (bundle) argv.push('--bundle', bundle)
+    if (skill) argv.push('--skill', skill)
+    if (tool) argv.push('--tool', tool)
+    if (target) argv.push('--target', target)
+    if (scope) argv.push('--scope', scope)
+    if (force) argv.push('--force')
+    argv.push('--json')
+    return toToolResult(await runCli(argv))
+  })
+
+  server.registerTool('hskill_uninstall', {
+    description: 'Uninstall a named skill or shell tool, removing its files from disk. If target is omitted, the skill is removed from every install target (claude, cursor, codex, opencode, etc.), not just one.',
+    inputSchema: {
+      name: z.string().describe('Skill or tool name to uninstall, as shown by hskill_list'),
+      scope: z.enum(['user', 'project']).optional().describe('Scope to uninstall from, defaults to user'),
+      target: z.string().optional().describe('Target host to uninstall from'),
+      yes: z.boolean().optional().describe('Skip confirmation prompts'),
+    },
+  }, async ({ name, scope, target, yes }) => {
+    const argv = ['uninstall', name]
+    if (scope) argv.push('--scope', scope)
+    if (target) argv.push('--target', target)
+    if (yes) argv.push('--yes')
+    argv.push('--json')
+    return toToolResult(await runCli(argv))
+  })
+
+  server.registerTool('hskill_hooks', {
+    description: 'List, install, or uninstall hskill git hooks. Install/uninstall write files under ~/.claude/hooks (or the project dir for --scope project) and register them in settings.json.',
+    inputSchema: {
+      action: z.enum(['list', 'install', 'uninstall']),
+      name: z.string().optional().describe('Hook name — required for install/uninstall'),
+      scope: z.enum(['user', 'project']).optional().describe('Scope, defaults to user'),
+      project: z.string().optional().describe('Project directory, used when scope is project'),
+      force: z.boolean().optional().describe('Overwrite an existing hook install'),
+    },
+  }, async ({ action, name, scope, project, force }) => {
+    if (action !== 'list' && !name) {
+      return { content: [{ type: 'text', text: 'name is required for install/uninstall actions' }], isError: true }
+    }
+    const argv = ['hooks', action]
+    if (action === 'uninstall' && name) {
+      // uninstall expects hook name as positional argument
+      argv.push(name)
+    } else if (name) {
+      // install expects --name flag
+      argv.push('--name', name)
+    }
+    if (scope) argv.push('--scope', scope)
+    if (project) argv.push('--project', project)
+    if (force) argv.push('--force')
+    argv.push('--json')
+    return toToolResult(await runCli(argv))
+  })
+
+  server.registerTool('hskill_update', {
+    description: 'Update hskill itself to the latest version via `npm install -g harveyz-skill@latest`. This replaces the globally installed hskill binary and is irreversible except by manually reinstalling a specific version.',
+    inputSchema: {},
+  }, async () => {
+    const { code, stdout, stderr } = await runCli(['update'])
+    if (code === 0) {
+      return { content: [{ type: 'text', text: 'hskill updated to the latest version.' }] }
+    }
+    const message = stderr.trim() || stdout.trim() || `update failed with exit code ${code}`
+    return { content: [{ type: 'text', text: message }], isError: true }
+  })
+
+  return server
+}
+
+export async function startServer() {
+  const server = createServer()
+  const transport = new StdioServerTransport()
+  await server.connect(transport)
+}

package/lib/targets.js

@@ -1,13 +1,14 @@
 import os from 'os'
 import path from 'path'
 
-export const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
+export const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode', 'pi']
 
 export const USER_ONLY_TARGETS = new Set(['openclaw', 'hermes'])
 
 // Targets whose user-level skill dir doesn't follow ~/.{name}/skills
 const USER_DIR_OVERRIDES = {
   opencode: path.join(os.homedir(), '.config', 'opencode', 'skills'),
+  pi:       path.join(os.homedir(), '.pi', 'agent', 'skills'),
 }
 
 export function userSkillDir(name) {
@@ -27,6 +28,7 @@ export const TARGETS = {
   openclaw: path.join(os.homedir(), '.openclaw', 'skills'),
   hermes:   path.join(os.homedir(), '.hermes',   'skills'),
   opencode: path.join(os.homedir(), '.config', 'opencode', 'skills'),
+  pi:       path.join(os.homedir(), '.pi', 'agent', 'skills'),
   shell:    path.join(os.homedir(), '.local', 'bin'),
 }
 

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "harveyz-skill",
-  "version": "0.25.0",
-  "description": "Skill manager for Claude Code, Cursor, and Codex",
+  "version": "0.26.0",
+  "description": "Skill manager for Claude Code, Cursor, Codex, OpenClaw, Hermes, OpenCode, and Pi",
   "type": "module",
   "bin": {
     "hskill": "bin/cli.js"
   },
   "scripts": {
     "prepack": "node scripts/generate-npmignore.js",
-    "test": "bats tests/ && bash scripts/run-skill-tests.sh"
+    "test": "bats tests/ && bash scripts/run-skill-tests.sh && node --test tests/mcp.test.mjs"
   },
   "files": [
     "bin/",
@@ -25,6 +25,7 @@
     "skills/research/extract-cognition/",
     "skills/research/probe-session/",
     "skills/research/pdf-math-translate/",
+    "skills/research/clip-url/",
     "skills/creative/capture-todo/",
     "skills/creative/capture-insight/",
     "skills/coding/init-workflow/",
@@ -53,6 +54,7 @@
     "skills/meta/release-project/",
     "skills/meta/sync-hotfix/",
     "skills/meta/sync-agent/",
+    "skills/coding/handoff/",
     "tools/hub/",
     "tools/sync-agent/",
     "hooks/check-similar-branch/"
@@ -62,8 +64,10 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.4.2",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "chalk": "^5.3.0",
-    "fs-extra": "^11.2.0"
+    "fs-extra": "^11.2.0",
+    "zod": "^4.4.3"
   },
   "author": "harveyzhang",
   "repository": {