crossoverjie/skilldeck

SkillDeck

The desktop GUI for managing AI code agent skills on macOS.

English | 中文

---

SkillDeck is the first desktop GUI for managing skills across multiple AI code agents — Claude Code, Codex, Gemini CLI, Copilot CLI, OpenCode, Antigravity, Cursor, Kiro, CodeBuddy, OpenClaw, Trae, and Qoder. No more manual file editing, symlink juggling, or YAML parsing by hand.

Screenshots

Features

• Multi-Agent Support — Claude Code, Codex, Gemini CLI, Copilot CLI, OpenCode, Antigravity, Cursor, Kiro, CodeBuddy, OpenClaw, Trae, Qoder

• Registry & Marketplace Browser — Browse skills.sh leaderboard plus the ClawHub catalog for OpenClaw with search, sorting, and filters

• Unified Dashboard — All skills in one three-pane macOS-native view

• Flexible Imports — Install from GitHub or import from a local folder, then auto-create symlinks and update the lock file

• Update Checker — Detect remote changes and pull updates with one click

• SKILL.md Editor — Split-pane form + markdown editor with live preview

• Agent Assignment — Toggle which agents a skill is installed to via symlink management

• App Settings — Configure global app fonts and proxy networking (HTTPS / SOCKS5, Keychain-backed credentials, bypass list)

• Localization — Full English and Simplified Chinese interface support with in-app language switching

• Inline Translation — Automatic Chinese translation of skill documentation paragraphs when UI language is set to Chinese (requires macOS 26+)

• Auto-Refresh — File system monitoring picks up CLI-side changes instantly

• Built-in skilldeck Skill — Manage skills via natural language in any AI agent. Install, update, delete, and assign skills to agents without leaving your terminal. See skills/skilldeck/SKILL.md.

See the full feature list and roadmap in docs/FEATURES.md.

Installation

Download (Recommended)

Download the latest universal binary from GitHub Releases:

1. Download SkillDeck-vX.Y.Z-universal.zip
2. Unzip and move SkillDeck.app to /Applications/
3. On first launch, macOS will block unsigned apps. To open:

   xattr -cr /Applications/SkillDeck.app
   

   Or: Right-click → Open → “Open” in the dialog

Homebrew

brew tap crossoverJie/skilldeck && brew install --cask skilldeck

Build from Source

Requires macOS 14.0+ (Sonoma), Xcode 15.0+, Swift 5.9+.

git clone https://github.com/crossoverJie/SkillDeck.git
cd SkillDeck
swift run SkillDeck

# Or open in Xcode
open Package.swift    # then press Cmd+R

Run tests:

swift test

Supported Agents

Architecture

MVVM with @Observable (macOS 14+). The filesystem is the database — skills are directories containing SKILL.md files. Services use Swift actor for thread-safe file system access.

Views → ViewModels (@Observable) → SkillManager → Services (actor)

See docs/DEVELOPMENT.md for the full architecture guide, design decisions, and development setup.

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feat/my-feature)
3. Run tests (swift test)
4. Open a Pull Request

See docs/DEVELOPMENT.md for environment setup and coding conventions.

License

MIT