SkillDeck
The native macOS app for managing AI code agent skills. Install once, symlink everywhere, update in one click.
00 · Interface
One pane, every skill
A three-column NavigationSplitView: sidebar for agents, dashboard for skill list, detail pane for editing. Dark and light appearance.
01 · Capabilities
What it does
-
Multi-AgentOne skill, every agent
Claude Code, Codex, Gemini CLI, Copilot CLI, OpenCode, Antigravity, Cursor, Kiro, CodeBuddy, OpenClaw, Trae, Qoder, QClaw, and WorkBuddy. Install a skill once; SkillDeck creates the right symlinks for each agent directory automatically.
-
Registry BrowserDiscover community skills
Browse the skills.sh leaderboard directly inside the app. Filter by All Time, Trending, or Hot. One click to install any listed skill — no terminal required.
-
One-Click InstallGit clone to symlink
Paste a GitHub URL or pick from the registry. SkillDeck clones the repo, parses SKILL.md frontmatter, creates canonical storage in
~/.agents/skills/, symlinks to each agent, and updates the lock file — all in a single operation. -
Update CheckerRemote diff at a glance
Compares local commit hashes against the remote HEAD. A badge appears when updates are available; pull the latest changes with one click. No manual git fetch needed.
-
SKILL.md EditorForm + markdown split
A split-pane editor: structured form fields for YAML frontmatter on the left, live markdown preview on the right. Edit name, description, version, and agent compatibility without touching raw YAML.
-
Auto-RefreshFilesystem watching
Uses DispatchSource and FSEvents to monitor skill directories in real time. If you edit a SKILL.md from the terminal or another tool, SkillDeck picks up the change within half a second.
-
skilldeck SkillNatural language management
A built-in skill that lets any AI agent manage skills via natural language. Say "install the code-review skill" and the agent clones the repo, creates symlinks for all detected agents, and updates the lock file — following the same filesystem conventions as the GUI. Supports install, update, delete, and agent assignment. See
skills/skilldeck/SKILL.md.
02 · Ecosystem
Supported agents
Every agent gets its own symlink farm. SkillDeck detects installed agents via CLI binaries and config directories, then manages the wiring.
- Claude Code
- Codex
- Gemini CLI
- Copilot CLI
- OpenCode
- Antigravity
- Cursor
- Kiro
- CodeBuddy
- OpenClaw
- Trae
- Qoder
- QClaw
- WorkBuddy
03 · Questions
FAQ
- What is a skill?
- A directory containing a
SKILL.mdfile with YAML frontmatter (name, description, version, agent compatibility) and a markdown body. Agents read these files to gain new capabilities. Think of it as a portable prompt package. - Where are skills stored?
- Canonical files live in
~/.agents/skills/<name>/SKILL.md. Each agent gets a symlink to its own directory — for example,~/.claude/skills/<name>points to the canonical path. The lock file at~/.agents/.skill-lock.jsontracks metadata. - Do I need all 14 agents installed?
- No. SkillDeck detects which agents are installed by checking for CLI binaries and config directories. Only detected agents appear in the sidebar. You can still manage skills for agents you haven't installed yet.
- Can I use this with skills I already have?
- Yes. SkillDeck reads existing
SKILL.mdfiles and respects your current directory structure. It won't overwrite anything without confirmation, and it deduplicates skills that share the same canonical path via symlinks. - What macOS version do I need?
- macOS 14 (Sonoma) or later. The app is built with SwiftUI and the
@Observableframework, which requires macOS 14+. It's a native Apple Silicon binary.