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, and Antigravity. 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
• Registry Browser — Browse skills.sh leaderboard (All Time, Trending, Hot) and search the catalog
• Unified Dashboard — All skills in one three-pane macOS-native view
• One-Click Install — Clone from GitHub, auto-create symlinks and update 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
• Auto-Refresh — File system monitoring picks up CLI-side changes instantly

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

Agent	Skills Directory	Detection
Claude Code	~/.claude/skills/	claude binary + ~/.claude/ dir
Codex	~/.agents/skills/ (shared)	codex binary
Gemini CLI	~/.gemini/skills/	gemini binary + ~/.gemini/ dir
Copilot CLI	~/.copilot/skills/	gh binary
Antigravity	~/.gemini/antigravity/skills/	antigravity binary

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