SkillDeck provides a native macOS graphical user interface for managing skills across various AI code agents, eliminating the need for manual file editing and complex configurations. It targets developers who utilize multiple AI coding assistants like Claude, Codex, and Gemini, offering a unified dashboard to streamline skill installation, updates, and agent assignment, thereby enhancing productivity and simplifying workflow management.

How It Works

SkillDeck employs an MVVM architecture leveraging SwiftUI's @Observable framework for reactive UI updates. Its core design treats the filesystem as the database, where AI agent skills are organized as directories containing SKILL.md files. Swift actors are utilized for thread-safe file system access, ensuring robust and reliable background operations for managing skills and their symlinks across different agents.

Quick Start & Requirements

• Installation: Download the latest universal binary from GitHub Releases and move SkillDeck.app to /Applications/. Alternatively, use Homebrew: brew tap crossoverJie/skilldeck && brew install --cask skilldeck.
• Build from Source: Requires macOS 14.0+ (Sonoma), Xcode 15.0+, and Swift 5.9+. Clone the repository, navigate to the directory, and run swift run SkillDeck or open Package.swift in Xcode.
• Prerequisites: macOS 14.0+ for building from source.

Highlighted Details

• Supports a wide array of AI agents including Claude Code, Codex, Gemini CLI, Copilot CLI, OpenCode, and more.
• Features a Registry & Marketplace browser to discover skills from skills.sh and ClawHub, with search, sorting, and filtering.
• Offers a unified, three-pane macOS-native dashboard for managing all skills.
• Provides flexible import options from GitHub repositories or local folders, with automatic symlink creation and lock file updates.
• Includes an Update Checker to detect remote changes and pull updates with a single click.
• Features a split-pane SKILL.md editor with live Markdown preview.
• Allows toggling agent assignment for skills via symlink management.
• Supports app settings for global fonts and proxy networking (HTTPS/SOCKS5).
• Offers full English and Simplified Chinese localization with in-app language switching.

Maintenance & Community

The README does not specify notable contributors, sponsorships, or community channels like Discord or Slack. The roadmap and detailed feature list are available in docs/FEATURES.md.

Licensing & Compatibility

SkillDeck is licensed under the MIT license, permitting commercial use and integration with closed-source projects.

Limitations & Caveats

Building from source requires macOS 14.0+. The inline translation feature for skill documentation is dependent on macOS 26+, a future release. As the application is unsigned, users must manually bypass macOS security prompts on first launch.