skills-hub

Skills Hub (Tauri Desktop)

A cross-platform desktop app (Tauri + React) for installing, organizing, updating, and syncing Agent Skills to multiple AI coding tools' global or project-level skills directories. Skills Hub prefers symlink/junction and automatically falls back to copy when needed: "Install once, sync everywhere".

Documentation

• English (default): README.md (this file)
• 中文：docs/README.zh.md

Why Skills Hub

AI coding tools increasingly use their own skills directories and installation flows. Maintaining those directories manually can quickly become messy: the same skill gets copied many times, update sources become unclear, tool activation states drift, and bulk cleanup takes too much effort.

Skills Hub installs skills into one central repository, then syncs them to tools such as Claude Code, Codex, Cursor, OpenCode, and Antigravity based on your choices. You can tag skills, choose global or project scope, update tool targets in bulk, and let the system update Git and local-source skills on a schedule.

Key Features

• Centralized library: Install skills into one central repository instead of scattering copies across tool folders.
• Explore and install: Install from curated lists, online search, local folders, or Git repositories.
• Multi-tool sync: Sync skills to different AI coding tools by global or project scope.
• Multi-device library sync: Keep Skill content, descriptions, and tags aligned across computers through a GitHub, GitLab, or Gitee repository.
• Local recycle bin: Recover deleted Skills and their saved local configuration for up to 30 days.
• Bulk management: Apply tags, tool targets, enabled state, or delete operations to many skills at once.
• Tag organization: Filter, group, and maintain skills with tags.
• Tool management: Enable built-in tool targets or add custom skills directories.
• Automatic updates: Update Git and local-source skills on a schedule, with visible failure details.
• Detail view: Browse skill file trees, Markdown content, and code snippets.
• Migration: Scan and import existing local skills into one managed library.
• Discovery controls: Choose which installed tool directories participate in import discovery.
• Multilingual interface: Use Skills Hub in English, Simplified Chinese, or Korean.

Interface Preview

My Skills — Managed Skills and Bulk Actions

My Skills provides card and list views for each managed skill's source, tags, sync scope, target tools, and enabled state. The toolbar supports scope filtering, sorting, tag filtering, search, and bulk actions.

When Skills Hub discovers importable Skills in installed tool directories, the discovery banner lets you review them or open Scan settings. Scan sources are independent from sync targets, persist across restarts, and remain accessible from Settings. Only directories containing SKILL.md are shown as importable Skills.

Skill Details — Inspect Content and Sync Targets

Open a Skill to view its source, tags, scope, and sync status. Browse its file tree and read Markdown or code without leaving the app.

Explore — Curated Skills and Online Search

Explore brings together curated repository skills and online search. After clicking Install, you can choose tags, install scope, and target tools.

Add Skill — Set Tags, Scope, and Tools Before Installation

Manual add supports both local folders and Git repositories. Before installing, you can assign tags, choose global or project scope, and choose which tools to sync to.

Device Sync — Keep Your Skill Library Aligned

Device Sync connects Skills Hub to a GitHub, GitLab, or Gitee repository. You can preview changes, synchronize manually, after startup, at an interval, or at a daily time, inspect per-Skill history, and resolve real conflicts without exposing device-local paths, tool targets, or credentials.

Start by authorizing your account or configuring Token/SSH access, then choose a repository and complete the first sync.

Once connected, review the latest sync status, automatic sync schedule, and per-Skill changes from the dashboard.

Recycle Bin — Recover Deleted Skills

Deleted Skills remain in a local recycle bin for 30 days. Restoring a Skill brings back its files and saved local configuration when the original locations are still available.

Tools — Built-in and Custom Tool Management

Tools shows detected and enabled AI coding tools with recognizable product icons. You can enable built-in targets or create and edit custom tools with an avatar, skills directories, and an explicit sync mode.

Updates — Scheduled Runs and Results

Updates can register a system-level schedule that keeps Git and local-source skills current while the app is closed. You can also update immediately and review checked, updated, and failed counts from the latest run.

Settings — App-Level Preferences

Settings keeps app-level preferences such as interface language, appearance, storage and cache, GitHub token, network proxy, and app updates.

Workflow

1. Install a skill from Explore, a local folder, or a Git repository.
2. Choose tags, sync scope, and target tools before installation.
3. Skills Hub stores the skill in the central repository, which defaults to ~/.skillshub.
4. Skills Hub syncs it to global skills directories or project-level skills directories based on each tool's rules.
5. Optionally connect Device Sync to keep the portable Skill library aligned across computers.
6. Later, you can organize, enable/disable, delete, recover, or bulk update skills from My Skills and Management Center.

Supported AI Coding Tools

Skills Hub includes 48 built-in tool adapters and supports custom skills directories from Management Center. Project skills directories are relative to the selected project root. Tools marked N/A do not have a confirmed project-level skills directory and are supported for global sync only.

tool key	Display name	global skills dir (relative to ~)	project skills dir (relative to project)	detected if exists (relative to ~)
cursor	Cursor	.cursor/skills	.agents/skills	.cursor
claude_code	Claude Code	.claude/skills	.claude/skills	.claude
codex	Codex	.codex/skills	.agents/skills	.codex
deepseek_harness	DeepSeek Harness	.dsh/skills	.dsh/skills	.dsh
zcode	ZCode	.zcode/skills	.zcode/skills	.zcode
opencode	OpenCode	.config/opencode/skills	.agents/skills	.config/opencode
antigravity	Antigravity	.gemini/config/skills	.agents/skills	.gemini/config
amp	Amp	.config/agents/skills	.agents/skills	.config/agents
kimi_cli	Kimi Code CLI	.kimi-code/skills (or $KIMI_CODE_HOME/skills)	.kimi-code/skills	.kimi-code (or $KIMI_CODE_HOME)
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
codewhale	CodeWhale	.codewhale/skills	.codewhale/skills	.codewhale
workbuddy	WorkBuddy	.workbuddy/skills	N/A	.workbuddy
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

See src-tauri/src/core/tool_adapters/mod.rs for the complete path rules and detection logic.

Development

Prerequisites

• Node.js 18+ (recommended: 20+)
• Rust (stable)
• Tauri system dependencies (follow Tauri official docs for your OS)

Create the local OAuth configuration once before starting the desktop app or building an installer:

cp .env.example .env

Replace both placeholders with the team's GitHub and GitLab OAuth public Client IDs. npm run tauri:dev and local npm run tauri:build* commands load only these two allowlisted values from the root .env; each value already present in the process environment takes precedence. Both IDs are required so browser authorization is available for both providers. Never add a client secret or user token, and do not commit .env.

npm install
npm run tauri:dev

Build

npm run lint
npm run build
npm run tauri:build

Platform build commands (from package.json)

• macOS (dmg): npm run tauri:build:mac:dmg
• macOS (universal dmg): npm run tauri:build:mac:universal:dmg
• Windows (MSI): npm run tauri:build:win:msi
• Windows (NSIS exe): 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

Tests (Rust)

cd src-tauri
cargo test

Contributing & Security

• Contributing: CONTRIBUTING.md
• Code of Conduct: CODE_OF_CONDUCT.md
• Security: SECURITY.md

FAQ / Notes

• Where are skills stored? The Central Repo defaults to ~/.skillshub (configurable in Settings).
• What are tags for? Tags help you find and organize skills. They do not change where a skill is synced or which tools can use it.
• What is Management Center for? Management Center handles tags, tool targets, and automatic skill updates. Settings keeps app-