Skills Manager v2.2.0

中文

Skills Manager v2.2.0 带来了独立的命令行工具 skm，以及 macOS 上的 Homebrew 安装渠道。

命令行工具 skm（新增）

新增一个与桌面应用并列的命令行前端，面向适合在终端里完成的工作流：SSH / 无头服务器、dotfiles 初始化脚本、快速状态检查。CLI 与桌面应用读写同一份配置和同一批软链接，两者可以随意混用。

命令	作用
skm init	不启动 GUI 完成首次配置（写配置、检测已装工具）
skm adopt	把已散落在各工具目录里的技能收编进技能库，并替换为指回技能库的链接
skm list	列出技能及其在各工具下的链接状态
skm enable <skill> --for <tool>	为指定工具创建软链接
skm disable <skill> --for <tool>	移除软链接
skm doctor	检测已安装工具并报告同步问题
skm fix	修复 doctor 发现的问题（需要 --yes 才真正写入）

• 可脚本化：每个命令都支持 --json，数据走 stdout、诊断信息走 stderr，所以调用方可以只解析一份文档，同时仍然信任退出码。
• 前缀匹配：技能名和工具名都接受唯一前缀，claude 即可匹配 claude-code。
• 可与 GUI 并存：所有会改动状态的命令都会先对配置文件加建议锁，并且在读取之前就加锁，避免把修复动作套用在已被其他写入者替换过的快照上。只读路径（list、doctor、不带 --yes 的 fix）完全不加锁，不会阻塞正在进行的启用/禁用；交互式确认发生在锁之外，不会因为等待用户回答而卡住其他 skm 进程。
• 安全默认：init 不会覆盖已有配置；adopt 对候选项做稳定排序，重名技能每次运行都会得到相同的处理结果。

桌面应用是可选的：skm init + skm adopt 就构成一套纯终端工作流。

从桌面应用一键安装 CLI（新增）

安装包内已附带编译好的 skm，无需二次下载 —— 在 设置 → 命令行工具 里可以一键安装。

安装位置会优先选用确实可写的 /usr/local/bin，否则回退到用户级 bin 目录（优先挑已经在 PATH 上的）。如果最终落到一个不在 PATH 上的目录，界面会直接说明这一点，而不是假装安装成功：安装后会有一条常驻提示，行内也会保留一条说明，直到 PATH 被修正为止。

配套 skill 自动保持同步（新增）

skills-manager-cli 配套 skill 会写入技能库并为已检测到的工具启用，让其他 agent 不必猜参数就能驱动 skm —— 里面写清了 --json 契约、dry-run 与实际写入的区别，以及 skm 明确不做的事。

这一版起，它不会再随版本升级而过期：

• GUI 启动时自动刷新技能库里的副本（未安装 CLI 时是空操作）
• skm doctor 会检查它与当前二进制是否匹配（--json 里的 companion_skill 字段，文本模式下给出刷新提示），覆盖手动替换二进制的情况
• 每次版本升级自动发布到 ClawHub，从市场拉技能而非从应用安装的 agent 也总能拿到与当前 skm 匹配的说明

Homebrew 安装（macOS，新增）

brew tap jiweiyeah/tap
brew install --cask jiweiyeah/tap/skills-manager

cask 会自动匹配 CPU 架构，之后 brew upgrade 即可保持最新。

请使用完整路径 jiweiyeah/tap/skills-manager：Homebrew 官方 cask 仓库里有一个同名但无关的 skills-manager，官方源优先级更高，直接用短名会装错。

本应用有 ad-hoc 签名但未经 Apple 公证，因此 cask 会在安装后移除隔离标记，否则 Gatekeeper 会拒绝启动。具体含义与手动处理方式见 tap 仓库说明。

修复与改进

• 修复技能发布时的版本查询解析错误：ClawHub 接口实际返回 items 字段，而客户端只读 versions，缺失的键会静默变成空列表 —— 于是已发布的技能看起来像未发布，预览里建议 1.0.0，随后被服务端当作重复版本拒绝。现在两种字段都接受，遇到无法识别的响应会报告查询失败，而不是猜成「没有已发布版本」。
• 内部重构：models 与 services 抽成独立的 sm-core crate，仓库转为 cargo workspace，桌面应用不再是这些逻辑的唯一使用方。启用/禁用的链接应用路径与 doctor/fix 的同步检查也移入 core，非 GUI 调用方才能复用。
• 现有用户会在启动时看到一次 CLI 介绍弹窗，最多显示三次，可用 Escape 关闭。

安装包

本版本提供 macOS Apple Silicon、macOS Intel、Windows 和 Linux 的桌面安装包，以及四个平台的 skm 命令行归档（按 Rust target 命名，例如 skm-aarch64-apple-darwin.tar.gz）。请从下方 Assets 中选择适合系统和架构的文件。

English

Skills Manager v2.2.0 introduces skm, a standalone command-line interface, and a Homebrew installation channel on macOS.

New: the skm command-line interface

A second front end alongside the desktop app, for the parts of the workflow that belong in a terminal: SSH and headless machines, dotfiles setup scripts, and quick status checks. The CLI reads and writes the same config and the same symlinks as the desktop app, so the two are interchangeable.

Command	What it does
skm init	First-run setup without the GUI (writes config, detects installed tools)
skm adopt	Move skills already living in tool directories into the hub and relink them back to it
skm list	List skills and their per-tool link status
skm enable <skill> --for <tool>	Create the symlink
skm disable <skill> --for <tool>	Remove the symlink
skm doctor	Detect installed tools and report sync issues
skm fix	Repair what doctor found (--yes required to actually write)

• Scriptable: every command takes --json, with data on stdout and diagnostics on stderr, so a consumer can parse one document and still trust the exit code.
• Prefix matching: both <skill> and <tool> accept a unique prefix — claude matches claude-code.
• Safe alongside the GUI: anything that mutates state takes an advisory lock on the config file, and always locks before reading, so a repair is never applied against a snapshot another writer has already replaced. Read-only paths (list, doctor, fix without --yes) take no lock at all and never block an in-flight enable/disable. Interactive prompts happen outside the lock, so waiting on an answer can't stall other skm processes.
• Careful defaults: init refuses to clobber an existing config, and adopt sorts candidates deterministically, so a duplicate skill name resolves the same way on every run.

The desktop app is optional: skm init + skm adopt give a fully terminal-only workflow.

New: install the CLI from the desktop app

The compiled skm now ships inside the installer, so there is no second download — install it in one click from Settings → Command Line Tool.

The install target prefers /usr/local/bin when it is genuinely writable, and otherwise falls back to a user bin directory, preferring one already on PATH. If the chosen directory is still off PATH, the UI says so rather than claiming success: a persistent toast after installing, plus a hint in the row that outlives it, until PATH is fixed.

New: the companion skill stays in sync

The skills-manager-cli companion skill is written into the hub and enabled for every detected tool, so other agents can drive skm without guessing flags — it documents the --json contracts, dry-run versus apply, and which commands skm deliberately does not implement.

As of this release it no longer goes stale on upgrade:

• The hub copy is refreshed on GUI startup (a no-op unless the CLI is installed)
• skm doctor checks it against the running binary (companion_skill in --json, a refresh hint in text mode), covering the manual-binary-swap case
• Every version bump publishes it to ClawHub, so agents pulling from the marketplace instead of the app also get instructions matching the current skm

New: Homebrew on macOS

brew tap jiweiyeah/tap
brew install --cask jiweiyeah/tap/skills-manager

The cask picks the right build for your CPU automatically, and brew upgrade keeps it current.

Use the full jiweiyeah/tap/skills-manager path: Homebrew's official cask repository contains an unrelated cask that happens to share the skills-manager token, and the official tap wins on a bare name.

The app is ad-hoc signed but not notarized by Apple, so the cask strips the quarantine attribute on install — without that, Gatekeeper refuses to launch the bundle. See the tap README for what that means and how to handle it yourself.

Fixes and improvements

• Fixed version lookup when publishing a skill. The ClawHub API answers with an items key while the client only read versions; the missing key silently became an empty list, so an already published skill looked unpublished, the preview suggested 1.0.0, and the server then rejected it as a duplicate. Both keys are now accepted, and an unrecognized response reports a failed lookup instead of guessing "no published versions".
• Internal refactor: models and services were extracted into a standalone sm-core crate and the repository became a cargo workspace, so the desktop app is no longer the only consumer of that logic. The enable/disable link-apply path and the doctor/fix sync check moved into core as well, so non-GUI callers can reuse them.
• Existing users see a one-time modal pointing at the CLI on launch, capped at three displays and closable with Escape.

Downloads

This release includes desktop installers for macOS Apple Silicon, macOS Intel, Windows, and Linux, plus skm CLI archives for all four platforms (named after their Rust target, e.g. skm-aarch64-apple-darwin.tar.gz). Choose the appropriate file for your platform and architecture from the Assets section below.

Full changelog: v2.1.9...v2.2.0

Skills Manager v2.1.9

中文

Skills Manager v2.1.9 重点增强了 Skill 安装、更新和个人管理体验，并改善了桌面端登录的可靠性。

新功能

• 新增 Skill 自定义备注。备注保存在本机配置中，不会修改 SKILL.md，并可用于搜索和筛选。
• Marketplace 支持多目标安装，可将 Skill 安装到全局技能库、当前项目及所选 AI 工具。
• 新增项目级 Skill 管理和工具目标选择，方便按项目配置不同的 AI 工具。
• 新增 DeepSeek Harness 工具支持。
• 新增 Marketplace 更新确认界面，可查看涉及的 Skill 与安装位置、选择更新目标，并在覆盖本地修改前获得明确提示。

修复与改进

• 优化桌面端浏览器登录流程，通过统一的网页登录入口完成授权。
• 修复刷新凭据或新访问令牌被拒绝后仍保留失效登录状态的问题；临时网络故障和服务端错误不会误触发退出登录。
• 优化 Marketplace 中可更新 Skill 的排序、筛选、批量更新和状态说明。
• 更新中英文 README 的官网入口与 Star History 图表。

安装包

本版本提供 macOS Apple Silicon、macOS Intel、Windows 和 Linux 安装包。请从下方 Assets 中选择适合系统和架构的文件。

English

Skills Manager v2.1.9 improves skill installation, updates, personal organization, and desktop authentication reliability.

New features

• Added custom notes for skills. Notes stay in local configuration, do not modify SKILL.md, and are included in search and filtering.
• Added multi-target Marketplace installation for the global skill library, the current project, and selected AI tools.
• Added project-level skill management and tool target selection for per-project AI tool setups.
• Added support for DeepSeek Harness.
• Added a Marketplace update confirmation flow that shows affected skills and install locations, supports target selection, and clearly warns before local changes are overwritten.

Fixes and improvements

• Streamlined desktop browser sign-in through a unified web authorization entry point.
• Fixed stale signed-in sessions after refresh credentials or newly issued access tokens are rejected. Temporary network and server failures continue to preserve the local session.
• Improved update sorting, filtering, bulk actions, and status messaging in Marketplace.
• Updated the official website links and Star History charts in both READMEs.

Downloads

This release includes installers for macOS Apple Silicon, macOS Intel, Windows, and Linux. Choose the appropriate file for your platform and architecture from the Assets section below.

Full changelog: v2.1.8...v2.1.9

Skills Manager v2.1.8

Release Notes - v2.1.8

中文

新增

• 一键发布技能到 ClawHub：技能卡片的「⋯」菜单新增「发布到 ClawHub」，无需再手动打包上传。
• 发布前自动预检：列出将上传的文件与总大小，推导技能标识与建议版本号。
• 支持填写展示名称、更新说明、分类（最多 3 个）与话题（最多 5 个），可发布到组织名下。
• 本地提前校验分类枚举、保留话题、版本号格式，以及单文件 10MB、总量 50MB 上限，避免上传后才失败。
• 新技能从 1.0.0 起步，已发布过的自动递增修订号。
• 已发布的技能在列表中显示「已发布」徽标，悬停可见标识与版本，点击直达 ClawHub 页面。
• 更新时自动沿用上次的技能标识与归属账号：即使改过标识、重命名本地目录或发布到组织名下，仍能识别为同一技能而非重复创建。
• 设置页新增 ClawHub Token 配置项，支持一键测试连通性。

修复

• 修复返回技能列表时筛选与搜索状态丢失的问题。
• 修复仅含发布记录、未打标签也未收藏的技能，其元数据在保存时被误删的问题。

安全与隐私

• ClawHub 要求所有技能以 MIT-0 许可发布（任何人可自由使用、修改、再分发，无需署名）。此项需在发布对话框中显式勾选确认，应用不会代为接受。

其他

• 新增发布链路的单元测试覆盖：文件收集与忽略规则、分类话题校验、发布数据构造、版本推导与发布记录持久化。
• 版本升级至 v2.1.8。

English

Added

• Publish skills to ClawHub in one click: new "Publish to ClawHub" entry in the skill card's "⋯" menu, replacing manual packaging and uploading.
• Automatic pre-flight check listing the files to upload with total size, plus a derived slug and suggested version.
• Set display name, changelog, categories (up to 3) and topics (up to 5); publishing under an organization is supported.
• Category enum, reserved topics, semver format, and the 10 MB per-file / 50 MB total limits are all validated locally instead of failing after the upload.
• New skills start at 1.0.0; previously published ones get an automatic patch bump.
• Published skills show a "Published" badge in the list — hover for slug and version, click to open the ClawHub page.
• Updates reuse the slug and owner from the previous publish, so renaming the local folder, changing the slug, or publishing under an organization still resolves to the same skill instead of creating a duplicate.
• New ClawHub Token setting with one-click connection test.

Fixed

• Filter and search state is no longer lost when returning to the skills list.
• Fixed metadata for skills that only had a publish record (no tags, not favorited) being dropped on save.

Security and Privacy

• ClawHub requires every skill to be published under the MIT-0 license (anyone may use, modify and redistribute it without attribution). This must be confirmed explicitly in the publish dialog — the app never accepts it on your behalf.

Other

• Added unit coverage for the publishing path: file collection and ignore rules, category/topic validation, publish payload construction, version resolution, and publish-record persistence.
• Bumped the application version to v2.1.8.

Skills Manager v2.1.7

Release Notes - v2.1.7

中文

新增与优化

• Skills 页面新增“分组”和“平铺”两种浏览模式。
• 技能组支持展开和收起，组内 Skills 层级更加清晰。
• Skill 卡片支持直接展开详情，减少页面跳转。
• 优化技能组搜索和筛选逻辑：搜索成员时保留所属技能组上下文。
• 增加缺失组成员提示，便于发现不完整的技能组安装。

修复

• 修复收藏 Skill 后，刷新页面收藏状态丢失的问题。
• 修复无标签收藏记录在配置保存时被错误清除的问题。

其他

• 新增技能分组和收藏持久化回归测试。
• 版本升级至 v2.1.7。

English

Added and Improved

• Added Grouped and Flat browsing modes to the Skills page.
• Skill groups can now be expanded or collapsed for clearer hierarchy.
• Skill details can be expanded directly from the list.
• Improved group-aware search and filtering so matching members retain their group context.
• Added warnings for missing group members to help identify incomplete installations.

Fixed

• Fixed favorite status being lost after refreshing the application.
• Fixed favorited skills without tags being incorrectly removed from persisted metadata.

Other

• Added regression coverage for skill grouping and favorite persistence.
• Bumped the application version to v2.1.7.

Skills Manager v2.1.6

Release Notes — v2.1.6

中文

新增

• Skill 风险安全扫描：规则引擎 + LLM 二审 + 全局进度提示，帮助识别 Skill 内容中的潜在风险
• Skills 一键导入导出：支持打包为 zip 在设备间同步，导入时提供冲突预览（跳过/覆盖/重命名）
• QoderWork CN 工具支持：新增内置工具配置
• 工具页 Skills 弹窗标签能力：展示标签并支持按标签批量启用/禁用
• 递归扫描嵌套 Skill 目录：支持 skills/superpowers/<skill>/SKILL.md 等深层结构（最大 5 层），自动跳过 .git 等隐藏目录

修复

• Windows：处理 WindowsApps 0 字节别名占位符导致编辑器启动失败（ERROR_BAD_EXE_FORMAT 193），并在符号链接创建失败时回退到 copy-mode
• Linker 安全保护：disable_skill 拒绝删除非托管的真实目录，避免误删用户内容；新增 copy-mode 元数据识别
• Marketplace：修复 ZIP 归档内重复 slug 前缀（如 my-skill/my-skill/SKILL.md）只剥离一层导致文件定位失败的问题

调整

• 版本号升级至 v2.1.6
• 设置页分区顺序调整，安全扫描移至"恢复默认设置"之前
• 风险扫描缓存目录移至 cache/risk 下

---

English

Added

• Skill risk scanning: rule engine + LLM second-pass review with global progress indicator to help identify potential risks in skill content
• One-click skills import/export: pack as zip for cross-device sync, with conflict preview (skip/overwrite/rename) on import
• QoderWork CN tool support: new built-in tool configuration
• Tags in tools page Skills dialog: display tags and batch enable/disable by tag
• Recursive nested skill scanning: supports deep structures like skills/superpowers/<skill>/SKILL.md (max depth 5), skips hidden directories like .git

Fixed

• Windows: handle 0-byte WindowsApps alias stubs causing editor launch failures (ERROR_BAD_EXE_FORMAT 193), with copy-mode fallback when symlink creation is not permitted
• Linker safety: disable_skill now refuses to delete non-managed real directories to prevent user content loss; added copy-mode metadata identification
• Marketplace: fixed repeated slug prefix in ZIP archives (e.g. my-skill/my-skill/SKILL.md) being stripped only once, causing file resolution failures

Changed

• Bumped version to v2.1.6
• Reordered settings sections; security scanning moved before "restore defaults"
• Risk scan cache directory relocated under cache/risk

Skills Manager v2.1.5

This update adds comprehensive Skill invocation statistics, with support now available for Claude Code, Codex, and WorkBuddy.

Skills Manager v2.1.4

Added

• Skill favorites: supports favoriting local and marketplace skills; marketplace favorites store snapshots for offline display; favorited items pinned to top with "favorites only" filter
• Marketplace source switched to clawhub.ai: backend now uses clawhub.ai public API with in-memory ZIP archive preview and tag filtering
• Improved marketplace search: dedicated Clawhub search endpoint enables full-library search; token-based AND matching extended to tags; search results highlight matched substrings with result count
• Added WorkBuddy tool support

Changed

• Merged the "Marketplace" settings section into "General"; command palette command updated to set-github-token
• Cleaned up Rust compile warnings: removed unused re-exports, added #[allow(dead_code)] to clawhub response structs
• Bumped version to 2.1.4 across the board

Fixed

• Fixed clawhub marketplace skill external link URL construction (missing owner and /skills/ segment)
• Fixed dropdown menus not closing when clicking outside (backdrop-filter broke the fixed overlay; replaced with useClickOutside hook)
• Fixed installed skills from a previous marketplace source leaking into the current source list after switching sources
• Fixed infinite "loading" indicator at the bottom when a tag filter was selected

Skills Manager v2.1.2

1. Revamped the user interface
2. Addressed several known issues

Skills Manager v2.1.1

UX Improvements (multi-phase)

• Welcome flow: smoother first-launch experience
• Skills page: core interaction and card experience improvements
• Marketplace: browsing and installation experience improvements
• Settings: layout and interaction detail improvements
• Editor: editing experience and stability improvements
• Tools page: fixed T-01 / T-03 UX details
• Overall: cross-page consistency and micro-interaction improvements

Skills Manager v2.1.0

1. Open-sourced the code repository
2. Trimmed part of the code