@wang121ye/skillmanager 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ye.wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+# skillmanager（`@wang121ye/skillmanager`）
+
+跨平台（Windows / Linux / macOS）的 **Agent Skills 管理器**：把「官方 skills + 第三方 skills 仓库 + 你自己的 skills 仓库」统一做 **安装（install）**，并可选用 **Web UI 交互式勾选**来安装子集。
+
+本项目 **基于 `openskills`** 实现安装与 `AGENTS.md` 同步。
+
+## 安装与使用
+
+### 全局安装（推荐）
+
+```bash
+npm i -g @wang121ye/skillmanager
+skillmanager install
+```
+
+### 直接 npx（无需安装）
+
+```bash
+npx @wang121ye/skillmanager install
+```
+
+> 说明：你最初写的 `npx skillmanager bootstrap` 只有在发布“非 scope 包名”时才成立。  
+> 现在按 scoped 包发布为 `@wang121ye/skillmanager`，对应 npx 用法是 `npx @wang121ye/skillmanager ...`，但执行的命令名仍然叫 `skillmanager`（由 `bin` 决定）。
+
+## 关键能力
+
+### 1) 一键安装（默认装“全部来源的全部 skills”）
+
+```bash
+skillmanager install
+```
+
+### 2) 安装时启用 Web UI 选择（默认全选，可批量全选/全不选/反选/搜索）
+
+```bash
+skillmanager webui
+```
+
+你也可以用某个 profile 名称（会保存选择集到该 profile）。**多数情况下不需要显式传 `--profile`**，直接用默认 profile（通常是 `default` 或你在 `skillmanager config set-default-profile` 里设置的值）即可：
+
+```bash
+skillmanager webui --profile laptop
+skillmanager install --profile laptop
+```
+
+## 把 `--profile laptop` 设为默认（推荐）
+
+设置一次默认 profile 后，绝大多数命令都可以不写 `--profile`：
+
+```bash
+skillmanager config set-default-profile laptop
+skillmanager webui
+skillmanager install
+```
+
+你也可以用环境变量临时覆盖默认 profile：
+
+```bash
+SKILLMANAGER_PROFILE=laptop skillmanager webui
+```
+
+## profile 配置的“上传/下载”（换电脑同步）
+
+你可以把某个 profile 上传到一个远端 URL（例如 OSS 对象地址），另一台电脑再 pull 回来。
+
+> 安全提示：**开放公共写权限非常危险**，任何人都可以篡改你的 profile。更安全的做法是使用签名 URL、私有桶 + 凭证、或 Git 私有仓库。
+
+### 1) 设置远端 URL（只需一次）
+
+```bash
+skillmanager config set-remote-profile-url https://<bucket>.<region>.aliyuncs.com/skillmanager_profile.json
+```
+
+你也可以不写入本地配置，改用环境变量（更适合 CI/临时机器）：
+
+```bash
+SKILLMANAGER_PROFILE_URL=https://<bucket>.<region>.aliyuncs.com/skillmanager_profile.json
+```
+
+### 2) 上传当前 profile
+
+```bash
+skillmanager config push --profile laptop
+```
+
+### 3) 新电脑下载并写入本地 profile
+
+```bash
+skillmanager config pull --profile laptop
+```
+
+### 3) 安装位置（交给 openskills）
+
+- 默认：项目级（`./.claude/skills`）
+- `--global`：全局（`~/.claude/skills`）
+- `--universal`：使用通用目录（`.agent/skills` / `~/.agent/skills`）
+
+示例：
+
+```bash
+skillmanager install --global --universal
+```
+
+### 4) 同步 `AGENTS.md`
+
+默认会执行 `openskills sync`（输出到当前目录的 `AGENTS.md`）。
+
+- 指定输出文件：
+
+```bash
+skillmanager install --output AGENTS.md
+```
+
+- 跳过同步：
+
+```bash
+skillmanager install --no-sync
+```
+
+### 5) dry-run（只打印要装什么，不实际安装）
+
+```bash
+skillmanager install --dry-run
+```
+
+## 更方便地添加/管理第三方仓库
+
+以后不需要手动去编辑 `sources.json`，可以直接用命令写入用户配置：
+
+```bash
+skillmanager source add https://github.com/obra/superpowers
+skillmanager source add ComposioHQ/awesome-claude-skills
+skillmanager source list
+```
+
+禁用/启用/删除：
+
+```bash
+skillmanager source disable superpowers
+skillmanager source enable superpowers
+skillmanager source remove superpowers
+```
+
+> `source add` 支持输入 `owner/repo` 或 GitHub URL（也支持 `git@github.com:owner/repo.git`）。
+
+## 更新已安装 skills（无论哪种来源）
+
+### 默认更新（推荐）
+
+这会调用 `openskills update` 更新所有 openskills 已记录的来源，然后重新 `sync`：
+
+```bash
+skillmanager update
+```
+
+### 如果你用了 profile 做“子集安装”（Web UI 勾选）
+
+因为子集安装是按“本地目录复制安装”（为了兼容 Windows 下 openskills 的本地路径识别问题），`openskills update` 不一定能自动追踪来源；此时用 profile 方式更新最稳：
+
+```bash
+skillmanager update --profile laptop
+```
+
+需要临时调整选择集：先用 Web UI 更新 profile，再执行 update：
+
+```bash
+skillmanager webui --profile laptop
+skillmanager update --profile laptop
+```
+
+## 卸载 skills
+
+### 用 Web UI 勾选要卸载的已安装 skills（推荐）
+
+```bash
+skillmanager webui --mode uninstall
+```
+
+### 直接按名称卸载
+
+```bash
+skillmanager uninstall algorithmic-art xlsx
+```
+
+### 清空目标目录（危险操作，需要显式 --all）
+
+```bash
+skillmanager uninstall --all
+```
+
+## Skills 来源配置（官方 / 第三方 / 你自己的）
+
+skillmanager 会在第一次运行时，把内置的 `manifests/sources.json` 复制到你的用户配置目录，之后你只需要编辑 **用户配置文件**即可：
+
+```bash
+skillmanager paths
+```
+
+会打印出类似：
+
+- `manifest: C:\Users\<you>\AppData\Roaming\skillmanager\sources.json`（Windows）
+- macOS/Linux 则在 `~/.config/skillmanager/sources.json` 附近
+
+`sources.json` 里维护三类来源（你可以继续追加第三方仓库）：
+
+- 官方：`anthropics/skills`
+- 你的：`wangyendt/wayne-skills`
+- 第三方：自行添加（`enabled: true`）
+
+## 发布到 npm（给你未来用）
+
+你要发布 scoped 包到 npm，一般是：
+
+```bash
+npm login
+npm publish --access public
+```
+
+（你提到的 npm 账号是 `wang121ye`：确保你拥有 `@wang121ye` scope 的发布权限；发布 scoped 包通常需要 `npm publish --access public`，本项目已在 `publishConfig` 里默认设置为 public。）

package/manifests/sources.json

@@ -0,0 +1,38 @@
+{
+  "version": 2,
+  "sources": [
+    {
+      "id": "anthropic",
+      "name": "Anthropic Official Skills",
+      "kind": "git",
+      "enabled": true,
+      "repo": "https://github.com/anthropics/skills.git",
+      "openskillsRef": "anthropics/skills"
+    },
+    {
+      "id": "wayne",
+      "name": "Wayne Skills",
+      "kind": "git",
+      "enabled": true,
+      "repo": "https://github.com/wangyendt/wayne-skills.git",
+      "openskillsRef": "wangyendt/wayne-skills"
+    },
+    {
+      "id": "superpowers",
+      "name": "Obra Superpowers",
+      "kind": "git",
+      "enabled": true,
+      "repo": "https://github.com/obra/superpowers.git",
+      "openskillsRef": "obra/superpowers"
+    },
+    {
+      "id": "awesome-claude-skills",
+      "name": "Awesome Claude Skills (ComposioHQ)",
+      "kind": "git",
+      "enabled": true,
+      "repo": "https://github.com/ComposioHQ/awesome-claude-skills.git",
+      "openskillsRef": "ComposioHQ/awesome-claude-skills"
+    }
+  ]
+}
+

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@wang121ye/skillmanager",
+  "version": "0.0.1",
+  "description": "Cross-platform agent skill manager (bootstrap + optional Web UI selection) built on top of openskills.",
+  "keywords": [
+    "skillmanager",
+    "openskills",
+    "claude",
+    "cursor",
+    "skills",
+    "agent"
+  ],
+  "homepage": "https://github.com/wangyendt/skillmanager#readme",
+  "bugs": {
+    "url": "https://github.com/wangyendt/skillmanager/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wangyendt/skillmanager.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Wayne",
+  "type": "commonjs",
+  "bin": {
+    "skillmanager": "src/cli.js"
+  },
+  "main": "src/index.js",
+  "files": [
+    "src/",
+    "manifests/"
+  ],
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "scripts": {
+    "test": "node -e \"console.log('no tests yet')\""
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "express": "^4.21.2",
+    "fast-glob": "^3.3.2",
+    "gray-matter": "^4.0.3",
+    "openskills": "^1.5.0",
+    "simple-git": "^3.27.0",
+    "undici": "^7.4.0"
+  }
+}

package/src/cli.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+const { Command } = require('commander');
+
+const { bootstrap } = require('./commands/bootstrap');
+const { selectUi } = require('./commands/select');
+const { where } = require('./commands/where');
+const { update } = require('./commands/update');
+const { uninstall } = require('./commands/uninstall');
+const { webui } = require('./commands/webui');
+const { listSources, addSource, removeSource, setEnabled } = require('./commands/source');
+const { showConfig, setDefaultProfileCmd, setRemoteProfileUrlCmd, pushProfileCmd, pullProfileCmd } = require('./commands/config');
+
+async function main() {
+  const program = new Command();
+
+  program
+    .name('skillmanager')
+    .description('跨平台 Agent Skills 管理器（基于 openskills）')
+    .version(require('../package.json').version);
+
+  program
+    .command('install')
+    .description('安装 skills：按 sources 配置安装全部，或用 Web UI 选择子集安装。')
+    .option('--global', '安装到全局（默认：当前项目）', false)
+    .option('--universal', '使用通用目录 .agent/skills（默认：.claude/skills）', false)
+    .option('--output <path>', 'sync 输出文件（默认：AGENTS.md）')
+    .option('--no-sync', '跳过 openskills sync', false)
+    .option('--dry-run', '仅打印将执行的内容，不实际安装', false)
+    .option('--concurrency <n>', '选择模式下的并发扫描数（默认：3）', '3')
+    .option('--profile <name>', '选择配置名（默认：来自 config 或 SKILLMANAGER_PROFILE 环境变量）')
+    .action(async (opts) => {
+      await bootstrap(opts);
+    });
+
+  program
+    .command('webui')
+    .description('打开 Web UI：用于选择并安装（install）或选择并卸载（uninstall）。')
+    .option('--mode <install|uninstall>', '模式：install（选择并安装）或 uninstall（选择并卸载）', 'install')
+    .option('--profile <name>', '作用：install 模式下使用/保存到的 profile（默认：使用默认 profile）')
+    .option('--global', '作用：把目标切到全局目录（~/.claude/skills 或 ~/.agent/skills）', false)
+    .option('--universal', '作用：使用 .agent/skills（通用 AGENTS.md 场景；默认是 .claude/skills）', false)
+    .option('--output <path>', '作用：sync 输出文件路径（默认：AGENTS.md）')
+    .option('--no-sync', '作用：不执行 openskills sync（仅安装/卸载，不更新 AGENTS.md）', false)
+    .option('--concurrency <n>', '作用：install 模式下并发拉取/扫描来源仓库，提高速度（默认：3）', '3')
+    .action(async (opts) => {
+      await webui(opts);
+    });
+
+  program
+    .command('paths')
+    .description('打印 skillmanager 的配置/缓存目录，以及 sources.json 位置。')
+    .action(async () => {
+      await where();
+    });
+
+  program
+    .command('update')
+    .description('更新 skills，并同步生成/更新 AGENTS.md。')
+    .option('--global', '安装到全局（默认：当前项目）', false)
+    .option('--universal', '使用通用目录 .agent/skills（默认：.claude/skills）', false)
+    .option('--output <path>', 'sync 输出文件（默认：AGENTS.md）')
+    .option('--no-sync', '跳过 openskills sync', false)
+    .option('--profile <name>', '按 profile 选择集更新（会重新安装选中的 skills）')
+    .option('--concurrency <n>', '选择模式下的并发扫描数（默认：3）', '3')
+    .action(async (opts) => {
+      await update(opts);
+    });
+
+  program
+    .command('uninstall')
+    .description('卸载 skills（从 .claude/skills 或 .agent/skills 删除，并可 sync 更新 AGENTS.md）。')
+    .argument('[skillNames...]', '要卸载的 skill 名称（目录名），可多个')
+    .option('--global', '卸载全局目录（默认：当前项目）', false)
+    .option('--universal', '使用通用目录 .agent/skills（默认：.claude/skills）', false)
+    .option('--all', '卸载目标目录下所有已安装 skills', false)
+    .option('--output <path>', 'sync 输出文件（默认：AGENTS.md）')
+    .option('--no-sync', '跳过 openskills sync', false)
+    .action(async (skillNames, opts) => {
+      await uninstall(opts, skillNames);
+    });
+
+  const config = program.command('config').description('配置管理：默认 profile、Web UI 选择等。');
+
+  config
+    .command('set-default-profile')
+    .description('设置默认 profile（当你不传 --profile 时会用它）。')
+    .argument('<name>', 'profile 名称，例如 laptop')
+    .action(async (name) => {
+      await setDefaultProfileCmd(name);
+    });
+
+  config
+    .command('set-remote-profile-url')
+    .description('设置远端 profile URL（用于 config push/pull）。')
+    .argument('<url>', '例如 https://<bucket>.<region>.aliyuncs.com/skillmanager_profile.json')
+    .action(async (url) => {
+      await setRemoteProfileUrlCmd(url);
+    });
+
+  config
+    .command('push')
+    .description('上传某个 profile 到远端 URL（HTTP PUT）。')
+    .option('--profile <name>', 'profile 名称（默认：default）', 'default')
+    .option('--url <url>', '远端 URL（可省略，使用 config.remoteProfileUrl 或 SKILLMANAGER_PROFILE_URL）')
+    .action(async (opts) => {
+      await pushProfileCmd(opts);
+    });
+
+  config
+    .command('pull')
+    .description('从远端 URL 下载 profile 并保存到本地（HTTP GET）。')
+    .option('--profile <name>', 'profile 名称（默认：default）', 'default')
+    .option('--url <url>', '远端 URL（可省略，使用 config.remoteProfileUrl 或 SKILLMANAGER_PROFILE_URL）')
+    .action(async (opts) => {
+      await pullProfileCmd(opts);
+    });
+
+  config
+    .command('show')
+    .description('显示配置（含默认 profile）。')
+    .action(async () => {
+      await showConfig();
+    });
+
+  const source = program.command('source').description('管理 skills 来源仓库（官方/第三方/自研）。');
+
+  source
+    .command('list')
+    .description('列出当前 sources.json 中的来源。')
+    .action(async () => {
+      await listSources();
+    });
+
+  source
+    .command('add')
+    .description('添加来源：支持 owner/repo、GitHub URL、或 git@... SSH URL。')
+    .argument('<repoOrRef>', '例如 ComposioHQ/awesome-claude-skills 或 https://github.com/obra/superpowers')
+    .option('--id <id>', '指定来源 id（可选）')
+    .option('--name <name>', '显示名称（可选）')
+    .option('--ref <openskillsRef>', '指定 openskillsRef（可选，形如 owner/repo）')
+    .option('--disabled', '添加为禁用（bootstrap 默认不安装）', false)
+    .action(async (repoOrRef, opts) => {
+      await addSource(repoOrRef, opts);
+    });
+
+  source
+    .command('remove')
+    .description('删除来源（按 id）。')
+    .argument('<id>', '来源 id')
+    .action(async (id) => {
+      await removeSource(id);
+    });
+
+  source
+    .command('enable')
+    .description('启用来源（按 id）。')
+    .argument('<id>', '来源 id')
+    .action(async (id) => {
+      await setEnabled(id, true);
+    });
+
+  source
+    .command('disable')
+    .description('禁用来源（按 id）。')
+    .argument('<id>', '来源 id')
+    .action(async (id) => {
+      await setEnabled(id, false);
+    });
+
+  await program.parseAsync(process.argv);
+}
+
+main().catch((err) => {
+  console.error(err?.stack || String(err));
+  process.exitCode = 1;
+});
+

package/src/commands/bootstrap.js

@@ -0,0 +1,153 @@
+const { getAppPaths } = require('../lib/paths');
+const { ensureDir } = require('../lib/fs');
+const { loadSourcesManifest } = require('../lib/manifest');
+const { ensureRepo } = require('../lib/git');
+const { scanSkillsInRepo } = require('../lib/scan');
+const { loadProfile } = require('../lib/profiles');
+const { mapWithConcurrency } = require('../lib/concurrency');
+const { getEffectiveDefaultProfile } = require('../lib/config');
+const path = require('path');
+const os = require('os');
+const { installSourceRef, syncAgents } = require('../lib/openskills');
+const { installFromLocalSkillDir } = require('../lib/local-install');
+
+
+function uniq(arr) {
+  return Array.from(new Set(arr));
+}
+
+async function bootstrap(opts) {
+  const paths = getAppPaths();
+  await ensureDir(paths.reposDir);
+  await ensureDir(paths.profilesDir);
+
+  const { sources } = await loadSourcesManifest();
+  const enabledSources = sources.filter((s) => s && s.enabled !== false);
+
+  const profileName = opts?.profile || (await getEffectiveDefaultProfile());
+  const existing = await loadProfile({ profilesDir: paths.profilesDir, profileName });
+
+  const wantsSelection = existing?.selectedSkillIds && Array.isArray(existing.selectedSkillIds);
+  const globalInstall = !!opts?.global;
+  const universal = !!opts?.universal;
+
+  if (!wantsSelection) {
+    // Default path: install everything from each enabled source via openskills directly.
+    // This avoids repo scanning and matches “bootstrap 安装所有 skills”的默认体验。
+    // eslint-disable-next-line no-console
+    console.log(`将从 ${enabledSources.length} 个来源安装（global=${globalInstall}, universal=${universal}）…`);
+
+    if (opts?.dryRun) {
+      // eslint-disable-next-line no-console
+      console.log('\n--dry-run 已启用：将安装以下来源（不执行安装）');
+      for (const s of enabledSources) {
+        const ref = s.openskillsRef || s.repo;
+        // eslint-disable-next-line no-console
+        console.log(`- ${s.name || s.id}  (${ref || 'missing-ref'})`);
+      }
+      // eslint-disable-next-line no-console
+      console.log('\n完成（dry-run）。');
+      return;
+    }
+
+    for (const s of enabledSources) {
+      const ref = s.openskillsRef || s.repo;
+      if (!ref) continue;
+      // eslint-disable-next-line no-console
+      console.log(`\n==> Installing source: ${s.name || s.id}  (${ref})`);
+      await installSourceRef({ ref, globalInstall, universal });
+    }
+
+    if (opts?.sync !== false) {
+      await syncAgents({ output: opts?.output, cwd: process.cwd() });
+    }
+
+    // eslint-disable-next-line no-console
+    console.log('\n完成。');
+    return;
+  }
+
+  // Selection path: clone repos + scan SKILL.md, then install selected skill dirs.
+  const concurrency = Number(opts?.concurrency || process.env.SKILLMANAGER_CONCURRENCY || 3);
+  // eslint-disable-next-line no-console
+  console.log(`并发扫描：${Math.max(1, concurrency)}（可用 --concurrency 或环境变量 SKILLMANAGER_CONCURRENCY 调整）`);
+
+  const skillsById = new Map();
+  const perSource = await mapWithConcurrency(enabledSources, concurrency, async (s) => {
+    try {
+      const repoDir = await ensureRepo({ reposDir: paths.reposDir, source: s });
+      const skills = await scanSkillsInRepo({
+        sourceId: s.id,
+        sourceName: s.name || s.id,
+        repoDir
+      });
+      return { source: s, skills };
+    } catch (err) {
+      // eslint-disable-next-line no-console
+      console.warn(`警告：拉取/扫描来源失败，将跳过：${s.name || s.id}`);
+      // eslint-disable-next-line no-console
+      console.warn(err?.message || String(err));
+      return { source: s, skills: [] };
+    }
+  });
+
+  for (const { skills } of perSource) {
+    for (const sk of skills) skillsById.set(sk.id, sk);
+  }
+
+  const allSkills = Array.from(skillsById.values());
+  let selectedIds =
+    existing?.selectedSkillIds && Array.isArray(existing.selectedSkillIds)
+      ? existing.selectedSkillIds
+      : allSkills.map((s) => s.id);
+
+  // 交互式选择已迁移到：skillmanager webui（mode=install）
+
+  selectedIds = uniq(selectedIds).filter((id) => skillsById.has(id));
+
+  // eslint-disable-next-line no-console
+  console.log(`将安装 ${selectedIds.length} 个 skills（global=${globalInstall}, universal=${universal}）…`);
+
+  if (opts?.dryRun) {
+    // eslint-disable-next-line no-console
+    console.log('\n--dry-run 已启用：仅展示前 30 个将安装的 skills（按解析顺序）');
+    for (const id of selectedIds.slice(0, 30)) {
+      const s = skillsById.get(id);
+      // eslint-disable-next-line no-console
+      console.log(`- ${s.name}  [${s.sourceId}]  (${s.id})`);
+    }
+    if (selectedIds.length > 30) {
+      // eslint-disable-next-line no-console
+      console.log(`… 还有 ${selectedIds.length - 30} 个`);
+    }
+    // eslint-disable-next-line no-console
+    console.log('\n完成（dry-run）。');
+    return;
+  }
+
+  // 2) install selected
+  for (const id of selectedIds) {
+    const skill = skillsById.get(id);
+    // eslint-disable-next-line no-console
+    console.log(`\n==> Installing: ${skill.name}  (${skill.sourceId})`);
+
+    // NOTE: On Windows, openskills does not recognize absolute paths like C:\...
+    // So for selection-mode we perform a direct local install (copy) ourselves, then rely on openskills sync.
+    const folder = universal ? '.agent/skills' : '.claude/skills';
+    const targetDir = globalInstall ? path.join(os.homedir(), folder) : path.join(process.cwd(), folder);
+    const { targetPath } = await installFromLocalSkillDir({ skillDir: skill.skillDir, targetDir });
+    // eslint-disable-next-line no-console
+    console.log(`✅ Installed (local copy): ${targetPath}`);
+  }
+
+  // 3) sync AGENTS.md (optional)
+  if (opts?.sync !== false) {
+    await syncAgents({ output: opts?.output, cwd: process.cwd() });
+  }
+
+  // eslint-disable-next-line no-console
+  console.log('\n完成。');
+}
+
+module.exports = { bootstrap };
+