// 01 为什么需要它 why
Agent 技能本质上是带有特定结构的 Markdown 文档。凭借可插拔、任务间通用、渐进式披露三大特性，它已经脱离了普通 prompt 的范畴，成为 Coding Agent 能力体系中独立的一层。尤其擅长那些有套路、有 SOP、需要风格迁移的任务——网页设计、数据分析、幻灯片制作。
但技能的管理体验一直跟不上。CLI 工具（npx skills）只能做安装和列表，技能一多列表就被截断，阅读基本无从谈起。哪些技能该删、哪些该更新、哪些质量高——这些判断都需要人主动参与，而参与的前提是看得见、读得懂。
Skill Zoo 的出发点就是这一句话：给所有流浪的技能宝宝一个家。用一个桌面 App 把技能管理的完整链条串起来，让阅读和维护不再是一件需要忍耐的事。
// 02 SSOT：一次管理，到处使用 ssot
如果你同时用 Claude Code 和 Codex，两个 Agent 各有一套技能目录。同一个技能存两份——版本分裂、磁盘浪费、更新不可控。Skill Zoo 的方案是唯一真实源（SSOT）+ 软链接：
~/.agents/skills/web-search/ ← 唯一真源，统一管理 ~/.claude/skills/web-search → ~/.agents/skills/web-search/ ~/.codex/skills/web-search → ~/.agents/skills/web-search/
这里有一个产品决策值得展开。从架构最优的角度，把用户所有技能收归 SSOT 目录统一管理是最干净的。但这会破坏一个场景：如果用户同时用 npx skills 更新技能，那个工具依赖技能目录里的真实文件而非软链接，强制收归会导致更新失败。
选择最优架构，还是尊重用户习惯？Skill Zoo 选了后者。不强制迁移已有文件。只有通过 Skill Zoo 安装的技能才纳入 SSOT 管理。这意味着代码里要多维护一套路径判断逻辑，但用户的现有工作流完全不受影响。
// 03 功能全景 features
-
>搜索与发现
搜索栏支持模糊匹配技能名。也接受 GitHub 仓库链接或owner/repo标识直接查找。进入仓库页后自动下载并解析全部技能，提供逐个安装或批量安装。 -
>仓库视图
首页按仓库分组，点击进入后左侧是该仓库下所有技能，右侧实时渲染 README。不需要离开 App 就能全面了解一个技能仓库的全貌。 -
>技能编辑
内置 CodeMirror 6 编辑器，支持在任意位置创建或修改技能 Markdown 文件。不需要切换到外部编辑器。 -
>批量管理
卡片视图下没有批量入口——这是刻意的，防止误触。切换到右上角列表视图后，复选框出现，可以批量勾选安装、归档或删除。 -
>一致性检查
三种维度：重复技能、版本冲突、格式不规范。随着技能库膨胀，这些检查能帮你及时发现管理死角。 -
>安全审计
技能详情页内置安全审计入口，对接 skills.sh 社区，一键获取技能的社区安全评分。 -
>技能归档
暂时不用的技能可归档暂存，减少 Agent 上下文占用。需要时一键恢复。 -
>CLI + WUI 双模式
除桌面 GUI 外，额外提供 npm CLI（npx skill-zoo）和内嵌轻量 Web 界面。Agent 可以用 CLI 调用，人可以用 GUI 浏览——两种消费端各得其所。 -
>中英双语
基于 i18next，完整支持中英文界面切换。
// 04 技术架构 stack
选择 Tauri v2 而非 Electron 是认真的。Electron 打包体积动辄上百 MB，内存占用高，对一个小工具来说太重了。 Tauri 用系统的 WebView 渲染，后端以 Rust 编写，打包体积小一个数量级，内存占用也低得多。
-
>前端
React 19 + TypeScript + Vite 5，UI 层用 Tailwind CSS 4 + shadcn/ui，状态管理 TanStack React Query，动效 Framer Motion -
>后端
Rust（Tauri v2），IPC 命令处理层、技能操作服务层、元数据持久化层三层架构 -
>编辑器
CodeMirror 6，支持 Markdown 语法高亮与内联编辑 -
>国际化
i18next，中英文完整界面切换 -
>工程化
Bun 包管理，Vitest + Rust tests 双端测试，oxlint + clippy 双端 lint，GitHub Actions 自动化构建 macOS dmg 和 Windows exe
// 05 下载安装 install
macOS 用户从 GitHub Releases
下载 .dmg，Windows 用户下载 .exe。也提供 npm CLI：
npm install -g skill-zoo
安装包通过 GitHub Actions 构建，过程透明可审计。项目以 MIT 协议开源， 欢迎 Star 与贡献：github.com/luochang212/skill-zoo