Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<div align="center">
<img src="docs/assets/logo.png" alt="Skills Manager" width="520" />
在多个 AI Agent 之间统一管理、同步与分发 Skills 的桌面应用
<p> <strong>文档语言 / Readme language</strong><br /> <b>中文</b> · <a href="README.en.md">English</a> · <a href="README.ja.md">日本語</a> </p>
<p> <a href="https://github.com/cchao123/skills-manager/releases">下载最新版本</a> · <a href="docs/user-guide.md">使用指南</a> · <a href="https://github.com/cchao123/skills-manager/issues">反馈问题</a> </p>
</div>
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：关闭前端 telemetryVITE_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
`-- README.ja.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。