在多个 AI Agent 之间统一管理、同步与分发 Skills 的桌面应用

文档语言 / Readme language
中文 · English

下载最新版本 · 使用指南 · 反馈问题

Skills Manager 是什么

Skills Manager 是一个基于 Tauri 2 + React + Rust 的桌面应用，用来把分散在不同 AI Agent 目录里的 skills 收拢到一个界面里查看、启用、分发和备份。

它主要解决这些问题：

多 Agent 管理分散：把不同 Agent 的 skills 聚合成统一视图，减少来回切目录。
复用成本高：同一个 skill 可以快速分发到多个 Agent，而不是手动复制。
迁移和备份麻烦：支持把 skills 同步到 GitHub，在新机器上一键恢复。
发现优质 skills 困难：内置 Marketplace，可直接浏览、搜索和安装社区技能。

当前内置的 Agent 预设包括：Claude Code、Cursor、Codex、OpenClaw、OpenCode、Trae、Qoder、Antigravity、Kiro。

功能概览

Marketplace

基于 skills.sh 浏览社区 skills，支持 All Time / Trending / Hot 三种榜单
按名称、描述快速搜索
预览 SKILL.md、详情统计和安装目标
一键安装到 Root 或指定 Agent

技能市场
技能详情

已安装 Skills 管理

把多个来源的 skills 聚合到一个管理界面
按 Agent 开关启用状态
查看来源、文件结构和详情内容
支持拖拽导入包含 SKILL.md 的文件夹

技能详情

GitHub 备份与分发

同步本地 skills 仓库到 GitHub
从 GitHub 恢复到新机器
把整理好的 skills 仓库分享给自己或团队复用

GitHub 备份
GitHub 设置

下载安装

前往 GitHub Releases 下载最新版本。
安装并启动应用。
首次启动后，应用会自动扫描本地 Agent 目录并展示已发现的 skills。

更详细的使用方式见 docs/user-guide.md。

本地开发

环境要求

Node.js 20+，推荐配合 pnpm 9
Rust stable（通过 rustup 安装）
macOS 如遇 OpenSSL 报错，可先执行：

brew install openssl@3
export OPENSSL_DIR=$(brew --prefix openssl@3)
export PKG_CONFIG_PATH=$(brew --prefix openssl@3)/lib/pkgconfig

仓库当前使用 pnpm-lock.yaml，以下文档命令默认以 pnpm 为准。

克隆与安装依赖

git clone https://github.com/cchao123/skills-manager.git
cd skills-manager
pnpm install

启动开发环境

pnpm tauri:dev

这会启动：

Vite 开发服务器（默认 http://localhost:5173）
Tauri 桌面窗口
前端热更新与后端重新编译流程

如果你只是用浏览器打开前端预览，部分功能会走 Mock 数据；完整行为请在 Tauri 窗口中验证。

可选：配置统计与监控

可以从 .env.example 复制一份 .env，按需填写：

cp .env.example .env

应用会读取 .env、.env.local、src-tauri/.env 等环境变量文件。常用变量如下：

VITE_ENABLE_TELEMETRY=false：关闭前端 telemetry
VITE_APTABASE_APP_KEY：Aptabase 前端事件统计
VITE_SENTRY_DSN：前端 React 错误上报
SENTRY_DSN：Rust 侧 panic / error 上报

构建发布

# Windows x64
pnpm tauri:build

# macOS Apple Silicon
pnpm tauri:build -- --target aarch64-apple-darwin

# macOS Intel
pnpm tauri:build -- --target x86_64-apple-darwin

构建产物位于：

src-tauri/target/release/
src-tauri/target/release/bundle/

仅修改 Rust 代码时，可以更快地执行：

cargo build --manifest-path=src-tauri/Cargo.toml

项目使用 GitHub Actions 自动构建发布：

构建工作流：.github/workflows/build.yml
Pages 文档部署：.github/workflows/deploy-pages.yml

配置与数据路径

应用配置：~/.skills-manager/config.json
中央 skills 目录：~/.skills-manager/skills/
GitHub 配置：~/.skills-manager/github-config.json

每个 skill 的元数据主要来自其目录下的 SKILL.md，推荐使用 YAML frontmatter 定义 name、description 等字段。

仓库结构

skills-manager/
|-- .github/workflows/
|   |-- build.yml
|   `-- deploy-pages.yml
|-- app/
|   `-- src/
|       |-- pages/
|       |   |-- Dashboard/
|       |   |-- GitHubBackup/
|       |   |-- Marketplace/
|       |   `-- Settings/
|       `-- api/
|-- docs/
|-- scripts/
|-- src-tauri/
|   `-- src/
|       |-- commands/
|       `-- ...
|-- .env.example
|-- README.md
`-- README.en.md

常见问题

现象	建议检查
图标格式报错	使用 `npx @tauri-apps/cli icon <源图>` 重新生成图标
5173 端口占用	释放端口或修改 Vite 端口配置
macOS OpenSSL 报错	检查 `OPENSSL_DIR` 与 `PKG_CONFIG_PATH`
列表里没有技能	确认 Agent 已安装、目录存在且包含 `SKILL.md`，然后在应用中重新扫描
Marketplace 无法加载	检查网络连接，确认可以访问 `skills.sh`
GitHub 备份失败	确认 Token 具备仓库读写权限，仓库配置填写正确
安装 skill 失败	确认目标 Agent 目录存在且可写，磁盘空间充足

如果文档与代码实现有差异，请以当前代码为准。

参与贡献

欢迎通过 GitHub Issues 反馈问题，也欢迎提交 Pull Request。

Fork 仓库
新建分支：git checkout -b feature/your-feature
提交修改并推送
发起 Pull Request

提交前建议至少运行：

pnpm build
cargo build --manifest-path=src-tauri/Cargo.toml

开源协议

本项目采用 MIT License，详见 LICENSE。

skills-manager