Skill Control — AI skill for Claude Code

Skill Control（技能管理器）

[简体中文](./README.md) · [English](./README_EN.md)

本地优先的 Agent Skill 可视化管理器。Skill Control 扫描你电脑上的 `SKILL.md` 技能目录，在一个界面中完成检索、详情预览、差异检查、跨工具同步， 以及 `.skill` 技能包的导入和导出。


当前版本：`v0.1.0` 首个公开版。源码和已经通过各目标平台冒烟测试的桌面产物 见 [Releases](../../releases)。

为什么需要 Skill Control

同一个 Skill 经常需要同时安装到 Codex、Claude Code 或其他 Agent 工具中。 手动复制目录很容易产生漏装、版本不一致和覆盖错误。Skill Control 以 Skill 名称聚合各处的本地安装，并在写入前展示计划：

• 哪些工具尚未安装；
• 同名 Skill 的内容是否一致；
• 本次操作会新增、替换还是跳过；
• 原版本会备份到哪里。

所有核心扫描和同步均在本机完成，不需要把 Skill 内容上传到远程服务。

功能

管理本地 Skills

• 扫描兼容 SKILL.md 的本地目录，并按 frontmatter name 聚合同名 Skill；
• 在 Agent 之间切换，查看各工具已安装的 Skills；
• 按名称、中文名称、介绍和标签搜索，并按状态筛选；
• 大型技能列表和同步任务列表采用渐进显示，避免首屏一次渲染全部条目；
• 显示安装覆盖、内容指纹、更新时间、文件数量、体积和软链接状态；
• 识别“已对齐”“覆盖不完整”“仅单端安装”和“版本冲突”；
• SKILL.md 存在中文名称或中文介绍时，优先显示中文信息。

查看与交换

• 浏览 Skill 文件树（超大目录会按安全上限截断），已安装 Skill 详情中的文件夹 默认折叠；
• 默认选择 SKILL.md；
• Markdown 文件支持渲染预览和原始内容切换；
• 文本文件可直接预览，二进制文件只显示元数据；
• 从详情中使用系统文件管理器定位 Skill 目录；
• 把本地 Skill 导出为可移植的 .skill 文件；
• 拖放或选择 .skill 文件，先检查包结构和内容，再选择安装目标；
• .skill 导入预览同样支持文件夹折叠、Markdown 渲染和原文切换。


安全地同步

• 同步前生成新增、替换和跳过计划；
• 支持独立副本的“复制”模式；
• 支持一处修改、多端生效的“软链接”模式；
• 替换已有目录前自动备份；
• 只有在预览并明确确认后才会写入目标目录；
• 同步与导入记录只保存在本机。

Windows 创建目录软链接时可能需要启用“开发人员模式”或使用具备相应权限的账户； 不确定时建议使用默认的“复制”模式。

支持的 Agent 工具

内置目录规则如下。应用只会把本机检测到或由你手动配置的工具加入数据源。 默认技能列表仅展示 Codex 和 Claude Code，可以在“工具数据源”中修改。

工具	默认扫描目录
Codex	~/.codex/skills、~/.agents/skills、~/.codex/vendor_imports/skills
Claude Code	~/.claude/skills
WorkBuddy	~/.workbuddy/skills、~/.workbuddy/connectors/skills
Cursor	~/.cursor/skills
Gemini CLI	~/.gemini/skills
Kiro	~/.kiro/skills
Trae	~/.trae/skills
OpenCode	~/.config/opencode/skills、~/.opencode/skills
Windsurf	~/.windsurf/skills
Cline	~/.cline/skills
Roo Code	~/.roo/skills、`~/.ro