SkillsManager Skill 技能

技能简介

SkillsManager 是一款专为 AI 编程工具设计的软链接管理器，旨在解决多工具间 skill 重复拷贝的问题。用户只需维护一份 skill 存放在中心 Hub 目录，SkillsManager 自动为 32 款 AI 编程工具（Claude Code、Codex、Cursor、Trae、Qwen Code、DeepSeek Harness 等）建立目录软链接，实现「改一处等于改所有地方」。同时内置本地安全扫描引擎，防止安装来路不明的社区 skill 时引入恶意代码。

核心能力

1. 中心化 skill 管理：所有 skill 存放在 ~/.skills-manager/skills 一个目录，各工具通过软链接指向它
2. 一键迁移 adopt：自动扫描各工具已有 skill 目录，将真实文件夹迁入 Hub 并重建链接，支持 dry-run 预览
3. 本地安全扫描：内置规则引擎检测破坏性命令（rm -rf、curl|sh、反弹 shell 等）及可疑编码，叠加 LLM 二审
4. 32 款工具全兼容：覆盖 Claude Code、Codex、Cursor、Gemini CLI、Trae、Qwen Code、DeepSeek Harness、WorkBuddy 等国内外主流 AI 编程工具
5. 跨平台支持：macOS / Windows / Linux 均有构建，Windows 不需要管理员权限（降级为 junction）
6. 纯本地运行：无账号体系，不联网也能用全部核心功能，数据模型就是磁盘上的文件夹

安装配置

方式一：下载安装包（推荐）

前往 https://skillsmanager.freeourdays.com 下载对应平台的安装包：

• macOS：dmg 镜像，ad-hoc 签名（无需 Apple 公证）
• Windows：exe 安装包，使用 junction 降级方案，无需管理员权限
• Linux：AppImage 或 deb 包

方式二：Homebrew（macOS/Linux）

brew install --cask skillsmanager

安装后会自动检测系统上已安装的 AI 编程工具。

方式三：纯 CLI 无头部署

下载包含 CLI 的 release 包，解压后即可使用 skm 命令： skm init # 不开 GUI 完成首次配置 skm doctor # 检测并修复链接漂移 skm fix --yes # 自动修复问题

所有命令支持 --json 输出，适合自动化脚本场景。

使用步骤

第一步：初始化 Hub

打开 SkillsManager 或运行 skm init，程序会自动扫描系统上已安装的 AI 编程工具，建立 Hub 目录 ~/.skills-manager/skills。

第二步：迁移已有 skills（可选）

运行 skm adopt --dry-run 预览迁移计划，确认无误后执行 skm adopt，程序会将各工具目录下散落的 skill 迁入 Hub 并自动建链。

第三步：安装社区 skill

将下载的 skill 文件夹放入 ~/.skills-manager/skills 目录，SkillsManager 会自动为其在各工具目录下建立软链接。

第四步：启用 / 禁用 skill

运行 skm enable --for 为指定工具启用某个 skill；运行 skm disable --for 禁用。

第五步：安全扫描

安装社区 skill 前，SkillsManager 会自动执行本地规则扫描，检测潜在的破坏性命令和可疑编码。可选叠加 LLM 二审进一步判断安全性。

适用场景

1. 多工具并行使用：同时使用 Claude Code、Cursor、Trae 等多款 AI 编程工具的用户，避免 skill 各自拷贝导致的版本不一致
2. 团队共享 skill 规范：将团队统一的编码规范、代码审查 skill 存放在 Hub，链接到所有成员的各工具
3. 安全安装社区 skill：通过内置扫描引擎过滤恶意 skill，防止被植入破坏性命令或后门
4. 旧工具迁移：更换 AI 编程工具时，无需重新配置 skill，一键迁移整个体系

适用人群

• AI 编程深度用户：同时使用 2 款以上 AI 编程工具的开发者
• 团队 leader：需要为团队统一管理 skill 规范的管理员
• 安全意识强的开发者：希望安装社区 skill 前做安全检查的技术人员

工作原理

SkillsManager 的核心机制是「符号链接（Symlink）」：

每个 AI 编程工具都有自己读取 skill 的固定目录（如 Claude Code 读取 ~/.claude/skills，Cursor 读取 ~/.cursor/skills）。SkillsManager 建立一个 Hub 目录作为唯一数据源，然后在各工具的 skills 目录里创建指向 Hub 的软链接。这样同一个 skill 文件夹可以同时被多个工具识别，且修改 Hub 中的文件，所有工具立即生效。

在 Windows 平台，目录软链接需要管理员权限，SkillsManager 实现了三级降级策略：

• 目录软链接（需要管理员）→ junction（mklink /J，无需权限）→ 带溯源记录的复制（写入 .skills-manager-source.json）

安全扫描采用本地规则引擎 + 可选 LLM 二审的双层架构：本地规则覆盖破坏性命令、反弹 shell、可疑编码等常见威胁模式，扫描结果按「路径 + 修改时间 + 扫描器版本」缓存，只在文件变更后重新检测。基础模式纯本地运行，不发送任何网络请求。

官方链接

产品官网：https://skillsmanager.freeourdays.com