技能中心（Tauri 桌面应用）

一款跨平台桌面应用（Tauri + React），用于在一个地方管理 Agent 技能，并将其同步到多个 AI 编码工具的全局或项目级技能目录中（优先使用符号链接/连接点，备用方案为复制）——“一次安装，处处同步”。

文档

• 英文（默认）：README.md（此文件）
• 中文：docs/README.zh.md

核心功能

• 探索页面：浏览精选推荐技能并在线搜索——一键安装并同步到所有已检测到的工具
• 全局/项目同步：将技能全局同步到所有项目，或将作用范围限定在选定的项目目录
• 作用范围控制：在全局和项目作用范围之间切换技能，管理项目目录，并按作用范围筛选我的技能
• 技能详情视图：点击技能名称即可浏览其文件，支持 Markdown 渲染和语法高亮（40 多种语言）
• 统一视图：已管理的技能、技能总数、作用范围标签以及各工具的启用状态
• 引导迁移：扫描已安装工具中的现有技能，导入到中央仓库并进行同步
• 导入来源：本地文件夹 / Git URL（包括多技能仓库选择、.claude/skills/ 目录支持）
• 更新：从源刷新；将更新传播到复制模式的目标
• 新工具检测：检测新安装的工具，并提示同步已管理的技能

我的技能

探索与搜索

手动添加

技能详情

支持的 AI 编码工具

项目技能目录是相对于所选项目根目录的。标记为 N/A 的工具没有确认的项目级技能目录，仅支持全局同步。

工具键	显示名称	全局技能目录（相对于 ~）	项目技能目录（相对于项目）	是否检测到（相对于 ~）
cursor	Cursor	.cursor/skills	.agents/skills	.cursor
claude_code	Claude Code	.claude/skills	.claude/skills	.claude
codex	Codex	.codex/skills	.agents/skills	.codex
opencode	OpenCode	.config/opencode/skills	.agents/skills	.config/opencode
antigravity	Antigravity	.gemini/antigravity/skills	.agents/skills	.gemini/antigravity
amp	Amp	.config/agents/skills	.agents/skills	.config/agents
kimi_cli	Kimi Code CLI	.config/agents/skills	.agents/skills	.config/agents
augment	Augment	.augment/skills	.augment/skills	.augment
openclaw	OpenClaw	.openclaw/skills	skills	.openclaw
copaw	Copaw	.copaw/skill_pool	.copaw/skill_pool	.copaw
cline	Cline	.agents/skills	.agents/skills	.agents
codebuddy	CodeBuddy	.codebuddy/skills	.codebuddy/skills	.codebuddy
command_code	Command Code	.commandcode/skills	.commandcode/skills	.commandcode
continue	Continue	.continue/skills	.continue/skills	.continue
crush	Crush	.config/crush/skills	.crush/skills	.config/crush
junie	Junie	.junie/skills	.junie/skills	.junie
iflow_cli	iFlow CLI	.iflow/skills	.iflow/skills	.iflow
kiro_cli	Kiro CLI	.kiro/skills	.kiro/skills	.kiro
kode	Kode	.kode/skills	.kode/skills	.kode
mcpjam	MCPJam	.mcpjam/skills	.mcpjam/skills	.mcpjam
mistral_vibe	Mistral Vibe	.vibe/skills	.vibe/skills	.vibe
mux	Mux	.mux/skills	.mux/skills	.mux
openclaude	OpenClaude IDE	.openclaude/skills	.openclaude/skills	.openclaude
openhands	OpenHands	.openhands/skills	.openhands/skills	.openhands
pi	Pi	.pi/agent/skills	.pi/skills	.pi
qoder	Qoder	.qoder/skills	.qoder/skills	.qoder
qoderwork	QoderWork	.qoderwork/skills	.qoderwork/skills	.qoderwork
qwen_code	Qwen Code	.qwen/skills	.qwen/skills	.qwen
trae	Trae	.trae/skills	.trae/skills	.trae
trae_cn	Trae CN	.trae-cn/skills	.trae/skills	.trae-cn
zencoder	Zencoder	.zencoder/skills	.zencoder/skills	.zencoder
neovate	Neovate	.neovate/skills	.neovate/skills	.neovate
pochi	Pochi	.pochi/skills	.pochi/skills	.pochi
adal	AdaL	.adal/skills	.adal/skills	.adal
kilo_code	Kilo Code	.kilocode/skills	.kilocode/skills	.kilocode
roo_code	Roo Code	.roo/skills	.roo/skills	.roo
goose	Goose	.config/goose/skills	.goose/skills	.config/goose
gemini_cli	Gemini CLI	.gemini/skills	.agents/skills	.gemini
github_copilot	GitHub Copilot	.copilot/skills	.agents/skills	.copilot
clawdbot	Clawdbot	.clawdbot/skills	.clawdbot/skills	.clawdbot
droid	Droid	.factory/skills	.factory/skills	.factory
windsurf	Windsurf	.codeium/windsurf/skills	.windsurf/skills	.codeium/windsurf
moltbot	MoltBot	.moltbot/skills	.moltbot/skills	.moltbot
hermes_agent	Hermes Agent	.hermes/skills	N/A	.hermes

开发

前置条件

• Node.js 18+（推荐：20+）
• Rust（稳定版）
• Tauri 系统依赖项（请根据您的操作系统参考 Tauri 官方文档）

npm install
npm run tauri:dev

构建

npm run lint
npm run build
npm run tauri:build

平台构建命令（来自 package.json）

• macOS（dmg）：npm run tauri:build:mac:dmg
• macOS（通用 dmg）：npm run tauri:build:mac:universal:dmg
• Windows（MSI）：npm run tauri:build:win:msi
• Windows（NSIS 可执行文件）：npm run tauri:build:win:exe
• Windows（MSI+NSIS）：npm run tauri:build:win:all
• Linux（deb）：npm run tauri:build:linux:deb
• Linux（AppImage）：npm run tauri:build:linux:appimage
• Linux（deb+AppImage）：npm run tauri:build:linux:all

测试（Rust）

cd src-tauri
cargo test

贡献与安全

• 贡献：CONTRIBUTING.md
• 行为准则：CODE_OF_CONDUCT.md
• 安全：SECURITY.md

常见问题解答 / 备注

• 技能存储在哪里？中央仓库默认位于 ~/.skillshub（可在设置中配置）。
• 什么是项目级同步？技能仍然只在中央仓库中存储一次，但其同步目标是选定的项目目录，例如 <project>/.agents/skills、<project>/.claude/skills 或其他工具特定的项目技能路径。
• 为什么 Cursor 的同步总是复制？Cursor 目前不支持基于符号链接或联接点的技能目录，因此 Skills Hub 在同步到 Cursor 时会强制进行目录复制。
• 为什么同步有时会回退到复制？Skills Hub 优先使用符号链接或联接点，但在某些系统上（尤其是 Windows），符号链接可能受到限制；在这种情况下，它会回退到目录复制。
• TARGET_EXISTS|... 是什么意思？目标文件夹已经存在，且操作未覆盖它（默认为非破坏性）。请移除现有文件夹，或使用适当的覆盖流程重试。
• macOS Gatekeeper 注意事项（未签名或未公证的版本，可能因 macOS 版本而异）：如果看到“已损坏”或“开发者未验证”的提示，请运行 xattr -cr "/Applications/Skills Hub.app"（https://v2.tauri.app/distribute/#macos）。

支持的平台

• macOS（已验证）
• Windows（按设计预期支持；未在本地验证）
• Linux（按设计预期支持；未在本地验证）

许可证

MIT 许可证 — 请参阅 LICENSE 文件。

Skills Hub 快速上手指南

Skills Hub 是一款跨平台桌面应用（基于 Tauri + React），旨在统一管理 AI 编程助手的技能（Agent Skills）。它支持将技能一次性安装并同步到多个主流 AI 编码工具（如 Cursor、Claude Code、Cline 等）的全局或项目级目录中，实现“一次安装，处处同步”。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：macOS（已验证）、Windows 或 Linux。
• Node.js：版本 18+（推荐 20+）。
  • 国内用户建议：使用 nvm 管理版本，或通过淘宝镜像源安装：

    npm config set registry https://registry.npmmirror.com
    

• Rust：需安装稳定版（stable）。
  • 国内用户建议使用 rustup 镜像加速安装：

    export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
    export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
    curl --proto '=https' --tlsv1.2 -sSf https://mirrors.ustc.edu.cn/rust-static/rustup-init.sh | sh
    

• Tauri 依赖：根据您的操作系统安装相应的系统构建工具（参考 Tauri 官方文档）。
  • macOS: 需安装 Xcode Command Line Tools (xcode-select --install)。
  • Windows: 需安装 Visual Studio Build Tools (包含 C++ 桌面开发组件)。
  • Linux: 需安装 build-essential, curl, wget, libssl-dev, libgtk-3-dev 等（具体依发行版而定）。

安装步骤

方式一：从源码构建（推荐开发者）

如果您希望体验最新功能或参与贡献，可以从源码构建：

1. 克隆仓库

   git clone https://github.com/skills-hub/skills-hub.git
   cd skills-hub
   

2. 安装依赖

   npm install
   

3. 启动开发模式 运行以下命令将自动编译 Rust 后端并启动 React 前端界面：

   npm run tauri:dev
   

4. 构建生产版本（可选） 如需生成可分发的安装包（如 .dmg, .exe, .deb）：

   npm run lint
   npm run build
   npm run tauri:build
   

   针对特定平台的构建命令（例如 macOS DMG）：

   npm run tauri:build:mac:dmg
   

方式二：直接使用预编译包

(注：若项目 Release 页面提供预编译包，可直接下载对应系统的安装包进行安装，无需配置开发环境。)

基本使用

启动应用后，您将看到统一的管理界面。以下是核心操作流程：

1. 浏览与安装技能 (Explore & Install)

• 进入 Explore 页面，浏览精选的技能列表或使用搜索框查找在线技能。
• 点击技能卡片上的 Install 按钮。
• Skills Hub 会自动检测您系统中已安装的 AI 工具（如 Cursor, Claude Code 等），并将该技能同步到所有检测到的工具目录中。

2. 管理同步范围 (Scope Control)

您可以在 My Skills 页面管理已安装的技能：

• 全局同步 (Global)：技能将同步到用户主目录下的全局配置文件夹（例如 ~/.cursor/skills），对所有项目生效。
• 项目同步 (Project)：
  1. 点击技能旁的范围切换按钮，选择 Project。
  2. 指定目标项目根目录。
  3. 技能将被同步到该项目特定的目录中（例如 <project>/.agents/skills），仅在该项目中生效。

3. 查看技能详情

• 点击任意技能名称，进入 Skill Detail 视图。
• 您可以预览技能包含的文件，支持 Markdown 渲染和 40+ 种编程语言的语法高亮。

4. 导入现有技能

• 如果是首次使用，应用会提示扫描已安装工具中的现有技能。
• 您也可以手动通过 Local Folder（本地文件夹）或 Git URL 导入技能库，将其纳入中央仓库统一管理。

5. 自动更新与新工具检测

• 当您在外部更新了技能源时，可在应用中点击 Refresh 拉取最新变更并传播到所有同步目标。
• 当您新安装了一个支持的 AI 编码工具时，Skills Hub 会自动检测并提示您是否将现有技能同步到新工具中。

---

提示：默认情况下，Skills Hub 优先使用符号链接（symlink/junction）进行同步以节省空间。若系统限制（如 Windows 部分场景或 Cursor 当前限制），将自动降级为文件复制模式。