SkillDeck

Native macOS SwiftUI app for managing multiple AI code agent skills

Automatically checked · GitHub checked 2026-11-14

SkillDeck

Overview

SkillDeck App Icon

SkillDeck

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

CI Release macOS Swift License

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

Dashboard Overview Registry Browser

Features

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

  • 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

  • Usage Insights — Track invocation counts per skill across Codex, Claude Code, and Copilot CLI, then sort the dashboard by usage to spot and clean up skills you no longer use

  • 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

  • Global Disable / Enable — One switch hides a skill from all 15 agents at once (renames SKILL.md → .SKILL.md.disabled), preserving assignments for quick A/B testing and fully restoring them on re-enable. v1 limits: only canonical ~/.agents/skills/<id> skills (external symlink targets, agent-directory skills, and real duplicate copies are refused); the hidden marker is the only copy of the content — don't delete it; avoid npx skills update while disabled. See docs/FEATURES.md.

  • 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

AgentSkills DirectoryDetectionSkills Reading Priority
Claude Code~/.claude/skills/claude binary + ~/.claude/ dirOwn directory only
Codex~/.codex/skills/codex binaryOwn → ~/.agents/skills/ (shared global)
Copilot CLI~/.copilot/skills/gh binaryOwn → ~/.claude/skills/
OpenCode~/.config/opencode/skills/opencode binaryOwn → ~/.claude/skills/ → ~/.agents/skills/
Pi~/.pi/agent/skills/pi binaryOwn → ~/.agents/skills/ (Agent Skills location)
Cursor~/.cursor/skills/cursor binaryOwn → ~/.claude/skills/
Kiro~/.kiro/skills/kiro binaryOwn directory only
CodeBuddy~/.codebuddy/skills/codebuddy binaryOwn directory only
Trae~/.trae/skills/trae binaryOwn directory only
Qoder~/.qoder/skills/qoder binaryOwn → ~/.agents/skills/ (legacy compat)
Gemini CLI~/.gemini/skills/gemini binary + ~/.gemini/ dirOwn directory only
Antigravity~/.gemini/antigravity/skills/antigravity binaryOwn directory only
OpenClaw~/.openclaw/skills/openclaw binaryOwn directory only

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