MySkills

一个窗口，管你所有 AI agent 技能。

_{Claude Code · Codex · 共享池 · 任何读 SKILL.md 的工具}

English · 中文

MySkills 是一个本地桌面应用，扫描你登记的技能目录，按 name + source 去重，给你一个统一的视图。默认登记的是 ~/.claude/skills、~/.codex/skills、~/.agents/skills 三个目录；可以在「设置」里增删平台或改路径。

SKILL.md 是带 YAML frontmatter 的 Markdown 文件，Claude Code / Codex 这类工具会把它加载为可复用能力（提示词、工具配置、agent 指令）。同时用着多个这样的工具之后，副本就开始在各处漂移。MySkills 把这场混乱整理清楚；任何写入都必须显式确认、先备份、可回滚。

也可以完全不用点界面: 通过 MCP 把你的 agent 连上来,让它在对话里管理整个技能库 —— 盘点和阅读技能、归类到场景、从目录安装新技能、对齐漂移的副本、清理无用的 —— 每个文件改动都受闸门控制、有备份、可撤销。见 用 agent 驱动(MCP)。

安装

下载适合你平台的最新签名版本:

→ Releases 页面

• macOS —— 通用 .dmg(同时支持 Apple 芯片和 Intel)。用 Developer ID 证书签名、附 Apple 公证票据,双击即可打开,无需终端绕过。需 macOS 13 (Ventura) 或以上。约 19 MB。
• Windows —— .exe 安装包(NSIS)。
• Linux —— .AppImage、.deb 或 .rpm。

MySkills 会自我更新:启动时检查 stable 发布通道,有新版本时从通知或设置 → 更新一键升级;更新安装前会做签名校验。

最初的 v0.1.x 是 Electron、仅 Apple 芯片的版本,已被跨平台的 Tauri 版本(v0.2.0+)取代,只为存档保留在 releases 页。

它在你桌面系统上的痕迹

MySkills 写入的位置：

• Tauri preview 隔离 app data 目录 myskills-tauri-preview 里的 myskills.db —— SQLite 数据库（场景、标签、扫描结果）
• Tauri preview 隔离 app data 目录 myskills-tauri-preview 里的 backups/ 和 staging/ —— 同步备份与安装暂存；保留策略在「设置」可调
• 系统凭据库 —— 你的 AI provider API key（启用 AI 功能时）

你的 SKILL.md 文件 MySkills 一字不改。 标签和场景只活在上面的数据库里。

iCloud 注意： 不要把 ~/.agents/（主源目录）放进 iCloud Drive。iCloud 可能"驱逐"文件、留下 .icloud 占位符，看起来会变成失效副本 —— 主源放在本地路径。

它能做什么

在一个地方看完你的库

• 列表、场景看板（按场景分组）、覆盖矩阵（行 = 唯一技能，列 = 平台，单元格颜色显示哪些副本已同步、哪些不一致）
• 单技能详情抽屉显示最近修改时间、内容哈希、磁盘真实路径
• 纳入主源：把某个平台的版本提升为主版本，其他平台的副本指向主源并自动同步

写入都可审查

• 每次磁盘写入都走 Plan → Confirm → Execute。对话框先告诉你具体会改什么，再开始
• 破坏性操作先备份到 app data 的 backups/
• 一键回滚，在「同步历史」里
• 写入先经过临时路径，再替换目标；成功写入都会留下可回滚记录

从 skills.sh 发现并安装

• 内置搜索对接 skills.sh —— 社区贡献的 SKILL.md 目录，免账号
• 安装前可预览 GitHub raw 上的 SKILL.md
• 可安装到任意几个平台组合，走同一条 plan-confirm-execute 流水线

AI 辅助（可选，自带 API key）

• 支持 OpenAI / Anthropic / OpenRouter / DeepSeek / Ollama / 任意 OpenAI 兼容 baseURL
• AI 透视 把你的库聚类成主题，可一键把任何簇提升为正式场景
• 自动分类 把新技能归到你定义的场景里
• AI 搜索 在 Discover 里按自然语言重排目录结果
• 创造技能 把粗略需求收窄成可编辑轮廓，追问关键选择，生成经本地审查的 SKILL.md 并走确认安装
• 每个功能独立开关。Key 保存在系统凭据库里。

用 agent 驱动（MCP）

myskills-mcp 是一个独立的 Model Context Protocol 服务 —— 纯 Rust、无 Node 依赖，已签名内置进 app —— 让 agent（Claude Code、Codex…）在对话里跑完你技能库的整个生命周期，而不是一格格点界面：

• 理解 —— 盘点每个技能的各平台健康度（synced / source / drifted / broken / disabled）、阅读任意 SKILL.md、查看变更账本
• 整理 —— 新建场景、把技能归类进去
• 获取 —— 搜 skills.sh 目录并安装技能（复制到主源、软链到各平台）
• 修复 —— 把技能漂移/坏链的副本重新对齐回主源，或按平台启用/停用
• 清理 —— 把技能删进系统回收站
• 任意撤销 —— 每个文件改动都备份并记录，skills_rollback 一键还原

它接的是和 app 同一个数据库。在设置 → 「连接你的 agent（MCP）」里打开（默认关 —— agent 虽然自己拉起进程，但访问权在你手里），把它生成的那段话粘给 agent 即可。权限分层:读取 + 数据库整理优先;任何动到磁盘文件的操作（安装 / 对齐 / 启停 / 删除 / 回滚）需要单独的「允许破坏性操作」开关,且每次调用都重新校验。app 自带的 LLM 功能不暴露 —— agent 是大脑,服务器是可信、可逆的双手。

完整工具清单、构建与客户端配置见 docs/mcp.md。

隐私

• 所有处理都在你机器上。 无遥测、无埋点、无后台回家
• 扫描器只扫你配置的目录（默认：~/.claude/skills、~/.codex/skills、~/.agents/skills）
• 网络调用仅限：skills.sh 目录搜索、你选的 AI 提供商。两个都默认关闭，启用后请求从你的机器直接走到对应服务 —— 不经我们任何中转
• 设置里的「允许外部网络」总开关，关掉之后 MySkills 完全离线

从源码构建

npm install
npm run dev         # Tauri dev shell + Next.js dev (:4477)
npm run check:tauri # command bridge 审计 + Rust fmt/clippy/tests + 前端 build
npm run validate:tauri # check:tauri + Tauri 桌面 bundle
npm run smoke:tauri:launch # 启动已打包 app，验证隔离 preview DB 初始化
npm run smoke:tauri:dmg # 挂载 macOS DMG 并验证 preview DB 初始化
npm run smoke:tauri:fixtures # 创建临时技能样本目录，用于桌面 parity smoke
npm run build       # Next.js 静态导出
npm run build:tauri # Tauri 桌面 bundle

冻结 Electron 线的命令保留在 *:electron:legacy。

环境要求： Node 22+、npm 10+、Rust/Cargo（rustup），以及对应平台的 Tauri 前置依赖。

架构

v0.2 线使用 Web 控制面 + Rust 后端：

Renderer 不拿直接文件系统、SQL、shell 或 HTTP 权限。所有文件系统、数据库、凭据与网络门控逻辑都在 MySkills 自定义 Tauri commands 后面。

深入架构看 CLAUDE.md —— 这个文件名义上是给 LLM 编程助手看的简报，但内容就是值得读的普通架构笔记。完整产品规格看 SPEC.md。

内部工作机制

技能的身份由 (name, source_key) 这对组合决定。 source_key 目前是 local，未来会是仓库/市场的 slug。内容通过 SKILL.md 的 SHA-256 指纹标识 —— 技能更新只改 content_hash，不改身份。场景、标签和任何用户态都活在 DB 里，编辑技能时不丢。

写入流水线 Plan → Confirm → Execute：

1. Plan 纯只读：遍历来源，分类（in_sync / stale / only_here / missing），算 diff 哈希，预分配备份路径。输出是一个类型化的 SyncPlan。
2. Confirm 把 plan 一行行展示给你。
3. Execute 先备份，写入临时目录，最后原子 rename 到位。

每次成功的写入都记录 before_hash、after_hash、backup_path、原始 dry_run_plan 到 sync_history —— 都可回滚。

路线图

不会做的： - 通用应用内技能编辑器 —— 创造技能可以生成并安装经审查的 SKILL.md，长期精修仍交给你常用的编辑器 - 云同步 —— MySkills 设计上就只跑在本地 - 在 MySkills 内运行 skill —— 执行仍交给各 agent 工具

当前状态

个人项目，活跃开发中。当前稳定版 v0.4.0 —— 跨平台（macOS 通用包 / Windows / Linux），已签名 + Apple 公证，应用内自动更新已上线。Rust 后端对 migration、scanner、以及 sync/align 引擎都有单测；MCP 服务的核心写入路径（对齐、安装、删除、回滚）在真机真库上做过可逆验证。v0.1.x 是已冻结的 Electron/macOS 线，只为存档保留。

贡献

欢迎 issue 和 PR。开 PR 前请注意：

1. 非小改动的 PR，请先开 issue。 MVP 范围有意保持窄，架构里有些不太显眼的不变量（技能身份、plan→confirm→execute、IPC 边界）很容易被无意识地破坏。短清单看 CLAUDE.md。
2. 遵守 Conventional Commits 风格（feat:、fix:、ux:、docs:、chore:）。看历史记录就懂。
3. 目前没有自动测试。 别在 PR 里说"测试通过"—— 在 PR 描述里写清楚你手动验证了什么。

致谢

• skills.sh —— 这个 app 搜索的目录来源，以及把 SKILL.md 格式规范化、让聚合成为可能的整个社区。
• 构建于 Tauri、Next.js、shadcn/ui 和 Lucide 之上。冻结的 v0.1.x 维护线使用 Electron。

License

MIT © 2026 Milk Tang.