https://github.com/cchao123/skills-managers
Organize your skills.
https://github.com/cchao123/skills-managers
claude-code
Last synced: 2 months ago
JSON representation
Organize your skills.
- Host: GitHub
- URL: https://github.com/cchao123/skills-managers
- Owner: cchao123
- License: mit
- Created: 2026-03-27T03:27:31.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-15T04:57:36.000Z (2 months ago)
- Last Synced: 2026-04-15T06:28:00.177Z (2 months ago)
- Topics: claude-code
- Language: TypeScript
- Homepage:
- Size: 4.92 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 技能管理器
基于 **Tauri 2**、**React** 与 **TypeScript** 的桌面应用，用于集中管理 Claude Code、Cursor 等环境下的 **Skills**（技能）：扫描、启用/禁用、市场浏览与 GitHub 备份同步。
[](https://tauri.app/)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](LICENSE)
[](README.md)
---
## 功能概览
### 已安装技能（Dashboard）
- 汇总展示本机已扫描到的技能，支持按来源区分（中央存储、Claude 插件缓存、Cursor 等）
- 总开关与各 Agent 子开关（级联逻辑）
- 按名称、描述等搜索与启用/禁用筛选
- 查看详情、删除（仅限中央存储中的技能）、支持文件夹拖入导入（需含 `SKILL.md`）
### 技能市场（Marketplace）
- 浏览与搜索社区技能仓库
- 从 GitHub 安装技能到本地环境
### GitHub 备份
- 配置仓库、分支、路径与 Personal Access Token（PAT）
- **同步到 GitHub**：将中央存储技能推送到远端
- **从 GitHub 恢复**：在新机器上拉取仓库中的技能到本地
- 连接测试、Star 官方仓库等
### 设置
- 外观：浅色 / 深色 / 跟随系统
- 语言：中文 / English
- 关于、更新日志（可跳转 Releases）
### 其他
- 单实例运行、系统托盘、Windows 安装包与开始菜单
- 国际化（i18n）、深色模式、Material Symbols 图标
---
## 技术栈
| 层级 | 技术 |
|------|------|
| 前端 | React 18、TypeScript、Vite 5、Tailwind CSS、react-i18next |
| 桌面 | Tauri 2（Rust） |
| 典型依赖 | serde、git2、ureq、walkdir 等 |
开发与构建需安装 **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
```
### 克隆与安装
```bash
git clone <仓库地址>
cd skills-managers
npm install
```
### 开发调试
```bash
npm run tauri:dev
```
将启动 Vite（默认 `http://localhost:5173`）并打开桌面窗口；前端热更新，后端修改后需按 Tauri usual 流程重新编译。
在**纯浏览器**中打开前端时，部分能力会使用 Mock 数据，完整功能请在 Tauri 窗口中使用。
---
## 构建发布
```bash
# 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 时可加快迭代：
```bash
cargo build --manifest-path=src-tauri/Cargo.toml
```
---
## 配置与数据位置（摘要）
- 应用配置：`~/.skills-manager/config.json`（技能启用状态、Agent、语言等）
- 中央技能目录：`~/.skills-manager/skills/`
- GitHub 备份相关配置由应用写入上述配置体系（具体字段以当前版本为准）
技能元数据来自各目录下的 **`SKILL.md`**（建议含 YAML frontmatter：`name`、`description` 等）。
---
## 常见问题
| 现象 | 处理方向 |
|------|----------|
| 图标格式报错 | 使用 `npx @tauri-apps/cli icon <源图>` 生成符合要求的图标集 |
| 5173 端口占用 | 结束占用进程或修改 Vite 端口配置 |
| macOS OpenSSL | 设置上文 `OPENSSL_DIR` / `PKG_CONFIG_PATH` |
| 列表里没有技能 | 确认本机已安装对应 Agent、技能路径存在且含 `SKILL.md`，在界面中执行重新扫描 |
更细的开发者说明见仓库根目录 **`CLAUDE.md`**；历史设计文档见 **`docs/`**（部分为阶段性记录，以代码为准）。
---
## 项目结构（简）
```
skills-manager/
├── app/ # React 前端（Vite）
├── src-tauri/ # Tauri + Rust 后端
├── docs/ # 文档与资源（如 docs/assets/logo.png）
├── LICENSE
├── README.md
└── README.en.md # 英文说明
```
---
## 参与贡献
欢迎通过 [GitHub Issues](https://github.com/cchao123/skills-managers/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`](LICENSE)。
英文说明见 **[`README.en.md`](README.en.md)**。
---
## 致谢 · Acknowledgments
- [Tauri](https://tauri.app/) · [Material Symbols](https://fonts.google.com/icons) · [Claude Code](https://claude.ai/code)