# skills-hub

**Repository Path**: muzil/skills-hub

## Basic Information

- **Project Name**: skills-hub
- **Description**: 用于统一管理 Agent Skills，并把它们同步到多种 AI 编程工具
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-30
- **Last Updated**: 2026-02-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Skills Hub

用于统一管理 Agent Skills，并把它们同步到多种 AI 编程工具，优先使用软连接（symlink/junction），失败回退复制目录（copy）。

## 主要功能

- 统一视图：查看 Hub 托管的 skills 及其在各工具的生效状态
- 迁移接管：扫描本机工具目录已有 skills，导入到中心仓库并可一键同步
- 多来源导入：本地目录 / Git 仓库 URL（含 multi-skill 候选选择）
- 更新：从原来源更新中心仓库内容，并回灌 copy 模式的目标
- 新工具检测：发现新安装工具时提示是否同步所有已托管 skills

## 支持的 AI 编程工具

| tool key | 工具 | skills 目录（相对 `~`） | detect 目录（相对 `~`） |
| --- | --- | --- | --- |
| `cursor` | Cursor | `.cursor/skills` | `.cursor` |
| `claude_code` | Claude Code | `.claude/skills` | `.claude` |
| `codex` | Codex | `.codex/skills` | `.codex` |
| `opencode` | OpenCode | `.config/opencode/skill` | `.config/opencode` |
| `antigravity` | Antigravity | `.gemini/antigravity/skills` | `.gemini/antigravity` |
| `amp` | Amp | `.config/agents/skills` | `.config/agents` |
| `kilo_code` | Kilo Code | `.kilocode/skills` | `.kilocode` |
| `roo_code` | Roo Code | `.roo/skills` | `.roo` |
| `goose` | Goose | `.config/goose/skills` | `.config/goose` |
| `gemini_cli` | Gemini CLI | `.gemini/skills` | `.gemini` |
| `github_copilot` | GitHub Copilot | `.copilot/skills` | `.copilot` |
| `clawdbot` | Clawdbot | `.clawdbot/skills` | `.clawdbot` |
| `droid` | Droid | `.factory/skills` | `.factory` |
| `windsurf` | Windsurf | `.codeium/windsurf/skills` | `.codeium/windsurf` |
| `trae` | Trae | `.trae/skills` | `.trae` |
| `trae-cn` | Trae-CN | `.trae-cn/skills` | `.trae-cn` |

## 开发

### 环境要求

- Node.js 18+（建议 20+）
- Electron

### 启动（桌面端）

```bash
npm install
npm run dev
```

### 构建

```bash
npm run electron:build
```

## 文档

- 系统设计：[`system-design.md`](system-design.md)

## FAQ / 备注

- Skill 存在哪里？中心仓库（Central Repo）默认是 `~/.skills-hub`，可在设置里修改。
- Cursor 为什么强制 Copy？Cursor 当前不支持软链（symlink/junction）形式的技能目录，因此同步到 Cursor 时会固定使用目录复制（copy）。
- 为什么有时会变成 Copy？默认优先 symlink/junction，但在某些系统（尤其 Windows）可能因为权限/策略导致无法创建链接，会自动回退到目录复制。
- `TARGET_EXISTS|...` 是什么意思？目标目录已存在且默认不覆盖（为了安全）。你需要先清理目标目录，或在“接管/覆盖”的明确流程里重试。

## License

MIT License（见 `LICENSE`）。