github.com/cchao123/skills-manager @v1.3.5

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

文档语言 / Readme language

中文 · English

意见反馈（GitHub Issues）

Skills Manager 是什么

Skills Manager 是一个基于 Tauri 2 + React + Rust 的桌面应用，为 Claude Code 及其他 AI Agent 提供统一的技能管理与分发平台。

它当前围绕以下工作流展开：

• Marketplace 技能市场：浏览、搜索并一键安装社区技能，支持 All Time、Trending、Hot 三种排序
• 统一扫描与管理：聚合本地多个 Agent 的 skill 目录，合并成一份可管理视图
• 跨 Agent 分发：通过链接或复制，把同一个 skill 分发到不同 Agent
• 集中存储：把可复用的 skills 放进中心目录，便于维护与迁移
• GitHub 备份与恢复：将技能仓库推送到远端，或在新机器上一键恢复
• CI/CD 自动构建：基于 GitHub Actions 实现跨平台自动构建与发布

默认支持的 Agent 包括：Claude、Cursor、Codex、OpenClaw、OpenCode。

功能概览

Marketplace 技能市场

• 三大榜单：All Time（总榜）、Trending（趋势榜）、Hot（热门榜）
• 智能搜索：按技能名称、描述快速筛选
• 一键安装：选择目标 Agent，直接下载并启用技能
• 详情预览：查看技能的 SKILL.md 内容、统计数据、安全审计等
• 进度追踪：实时显示下载进度与安装状态
• Agent 选择器：可选择安装到 Root 或特定 Agent 目录

Skills 总览与管理

• 统一视图：把来自不同来源的 skills 聚合到一个界面中管理
• 跨 Agent 开关：通过总开关 / 子开关控制 skill 在不同 Agent 中的启用状态
• 多来源查看：查看 skill 的详情、来源和文件结构
• 拖拽导入：支持将包含 SKILL.md 的文件夹直接拖入导入

GitHub 备份与分发

• 同步到 GitHub：将本地 skills 仓库推送到远端
• 从 GitHub 恢复：在新机器上拉取远端仓库并恢复本地 skills
• 分发技能仓库：把整理好的 skills 作为共享仓库提供给自己或团队使用
• 配置向导：可视化配置 GitHub 仓库信息

技术栈

开发与构建需安装 Node.js、Rust；在 macOS 上编译部分原生依赖时可能需要 OpenSSL（见下文）。

快速开始

环境要求

• Node.js 18+（npm 或 pnpm，与仓库锁文件一致即可）
• Rust（rustup 安装 stable）
• macOS：若遇 OpenSSL 相关报错，可用 Homebrew： bash brew install openssl@3 export OPENSSL_DIR=$(brew --prefix openssl@3) export PKG_CONFIG_PATH=$(brew --prefix openssl@3)/lib/pkgconfig

克隆与安装

git clone <仓库地址>
cd skills-managers
npm install

可选：启用统计与监控（Aptabase + Sentry）

项目会按需读取 .env / .env.local / src-tauri/.env 等环境变量文件。若你需要启用统计或监控，可自行创建 .env 并填写以下变量：

• APTABASE_APP_KEY：事件统计（前端 trackEvent + Rust 生命周期事件）
• VITE_SENTRY_DSN：前端 React 错误上报
• SENTRY_DSN：Rust 侧 panic / error 上报
• VITE_ENABLE_TELEMETRY=false：可一键关闭前端 telemetry

开发调试

npm run tauri:dev

将启动 Vite（默认 http://localhost:5173）并打开桌面窗口；前端支持热更新，后端修改后按 Tauri 常规流程重新编译。

在纯浏览器中打开前端时，部分能力会使用 Mock 数据，完整功能请在 Tauri 窗口中使用。

构建发布

# Windows x64
npm run tauri:build

# macOS（按需指定 target，详见 Tauri 文档）
npm run tauri:build -- --target aarch64-apple-darwin
npm run 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

配置与数据位置（摘要）

• 应用配置：~/.skills-manager/config.json（技能启用状态、Agent、语言等）
• 中央技能目录：~/.skills-manager/skills/
• GitHub 配置：~/.skills-manager/github-config.json

技能元数据来自各目录下的 SKILL.md（建议含 YAML frontmatter：name、description 等）。

CI/CD 自动构建

项目使用 GitHub Actions 实现自动化构建与发布：

构建工作流 (.github/workflows/build.yml)

触发条件： - 推送标签：v*（如 v1.0.4） - 手动触发：可选择指定标签

支持平台： - macOS ARM64（Apple Silicon） - macOS x64（Intel） - Windows x64

构建产物： - macOS：.app、.app.tar.gz、.dmg - Windows：.exe（NSIS 安装包）、.msi（Windows Installer）

自动发布： - 构建成功后自动创建 GitHub Release - 产物上传为 Release Assets - 支持环境变量配置监控与统计（Aptabase、Sentry）

使用方式

# 创建并推送标签触发自动构建
git tag v1.0.4
git push origin v1.0.4

# 或在 GitHub Actions 页面手动触发工作流

常见问题

更多截图、说明和静态文档可参考 docs/ 目录；若文档与代码不一致，以当前代码实现为准。

项目结构（简）

skills-manager/
├── .github/workflows/   # GitHub Actions CI/CD 配置
│   ├── build.yml        # 多平台构建工作流
│   └── deploy-pages.yml # 页面部署工作流
├── app/                 # React 前端（Vite）
│   └── src/
│       ├── pages/       # 页面组件
│       │   ├── Dashboard/       # 技能管理主页
│       │   ├── SkillDownload.tsx # Marketplace 技能市场
│       │   ├── GitHubBackup/    # GitHub 备份页
│       │   └── Settings/        # 设置页
│       └── api/         # Tauri API 封装
├── src-tauri/           # Tauri + Rust 后端
│   ├── src/
│   │   ├── commands/   # Tauri 命令处理
│   │   └── *.rs        # 核心业务逻辑
├── docs/                # 文档与资源（如 docs/assets/logo.png）
├── LICENSE
├── README.md
└── README.en.md         # 英文说明

参与贡献

欢迎通过 GitHub Issues 反馈与讨论，也欢迎 Pull Request：功能改进、文档、国际化、Bug 修复等。

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

提交前建议在本地执行 npm run build（含 tsc）与 cargo build，减少 CI 失败。

开源协议

本项目以 MIT License 发布，详见仓库内 LICENSE。

英文说明见 README.en.md。

致谢 · Acknowledgments

• Tauri · Material Symbols · Claude Code