SkillDeck 是一个原生 macOS 应用，用来统一管理多个 AI 编程助手的技能（Skills）。它本身不是一个需要跑在服务器上的服务，而是一个桌面客户端，所以“部署”主要就是把它装到你的 Mac 上。

📥 方式一：下载安装包（推荐，最简单）

这是官方首推的方式，适合绝大多数用户。

  1. 下载：从 GitHub Releases 页面下载最新的 SkillDeck-vX.Y.Z-universal.zip。
  2. 安装：解压后，把 SkillDeck.app 拖进 /Applications/ 文件夹。
  3. 首次打开：因为应用没有经过 Apple 签名，macOS 会阻止它启动。需要先移除隔离属性：
1
xattr -cr /Applications/SkillDeck.app

如果不想用命令行，也可以在 Finder 里右键点击应用图标，选择“打开”，然后在弹出的对话框里再点一次“打开”。

🍺 方式二：Homebrew 安装

如果你用 Homebrew 管理软件，一条命令就能装好。

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

🔨 方式三：从源码构建（适合开发者）

如果你想自己编译，或者想参与开发，需要先准备好环境。

环境要求：macOS 14.0+ (Sonoma)、Xcode 15.0+、Swift 5.9+。

1
2
3
4
5
6
7
8
9
10
11
12
13
# 克隆仓库
git clone https://github.com/crossoverJie/SkillDeck.git
cd SkillDeck

# 方式 A：直接用 SwiftPM 运行
swift run SkillDeck

# 方式 B：用 Xcode 打开
open Package.swift
# 然后在 Xcode 里按 Cmd+R 运行

# 运行测试
swift test

⚙️ 安装后要做什么

SkillDeck 启动后会自动检测你系统里已经安装的 AI 编程助手。它的工作原理是把技能目录通过符号链接（symlink）挂载到各个 Agent 的技能目录下，所以你需要先确保目标 Agent 本身已经装好了。

它支持的 Agent 和对应的技能目录如下，可以对照检查：

Agent 技能目录
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/
Gemini CLI ~/.gemini/skills/
Copilot CLI ~/.copilot/skills/
OpenCode ~/.config/opencode/skills/
Cursor ~/.cursor/skills/
其他（Kiro、CodeBuddy 等） ~/.<agent名>/skills/

SkillDeck 会通过检测对应的命令行工具（如 claude、codex 二进制）来判断某个 Agent 是否已安装。

💡 核心用法

装好之后，你可以通过图形界面完成这些操作：

  • 统一浏览：在一个三栏视图里查看所有 Agent 的技能。
  • 导入技能：从 GitHub 直接安装，或从本地文件夹导入。
  • 分配 Agent：用开关控制某个技能安装到哪些 Agent 上。
  • 编辑 SKILL.md：内置 Markdown 编辑器，带实时预览。
  • 更新检查：一键拉取远程技能的最新版本。

另外它还内置了一个 skilldeck 技能，你可以在任意支持的 Agent 里用自然语言让它帮你管理技能，不用离开终端。

📝 注意事项

  • 仅限 macOS：这是原生 SwiftUI 应用，没有 Windows 或 Linux 版本。
  • 不是服务端软件：不需要 Docker，也不需要长期后台运行，就是一个普通桌面 App。
  • 文件系统即数据库：技能就是包含 SKILL.md 的文件夹，Symlink 由 SkillDeck 自动维护，手动改动前最好先了解它的管理逻辑。