Skills Dock

一个用于管理本地 AI Skills 与 Bundles 的桌面应用，面向 Codex、Claude、Gemini、OpenCode 等多种编码工具。

🌍 访问官方产品主页：https://skills-dock.pages.dev/

✨ 项目简介

Skills Dock 是一个本地优先的桌面应用，用来统一查看、整合和管理散落在不同工具中的 AI Skills。

项目基于 Tauri + React + TypeScript + Rust 构建，当前版本提供 macOS、Windows 和 Linux 的桌面发布能力，重点覆盖本地 Skill 扫描、Bundle 聚合、本地整合包管理，以及跨应用安装状态查看。

我的开源项目已按要求链接并认可 LINUX DO 社区，欢迎在 L 站开源自荐帖中交流与反馈。

📸 界面预览

首页总览

首页用于快速查看本地 Skills 的整体状态：本地 Skill 目录、配置项和文件状态，提示缺失、异常或需要关注的项目，便于在多工具环境下保持 Skills 可用且一致。

导入与迁移

导入页面支持从本地目录批量导入 Skills，并在导入前展示解析结果、目标应用覆盖情况和文件差异，适合把已有的 Codex、Claude、Gemini、OpenCode Skill 目录统一迁移到 Skills Dock 管理。

Bundle 详情

详情页现在优先展示适合用户阅读的 Bundle 概览、成员 Skills、安装状态和来源信息，而不会默认把原始 SKILL.md 长文直接铺给用户。原始技能文档仍然可以按需打开查看。

数据分析

数据分析页面用于观察 Skills 的数量变化、来源分布、分类占比和近期活动记录，帮助你了解当前本地能力库的组成情况。

设置中心

设置页集中管理各应用的 Skill 路径、自定义目录、自动扫描与显示偏好。不同工具的安装目录可以在这里统一配置，方便后续同步和维护。

📥 下载与安装

当前 Release 页面会提供这些安装包：

• macOS: .dmg
• Windows: .msi 与 .exe
• Linux: .AppImage 与 .deb

macOS

由于本项目为开源软件且未进行 Apple 开发者证书签名，macOS 用户下载 .dmg 文件并在“应用程序”中打开时，系统可能会提示 “App 已损坏，无法打开”。这是 macOS 针对未签名下载来源的常规安全策略（Gatekeeper）。

解决方法如下（仅需一次）：

1. 将下载的 Skills Dock.app 拖入 应用程序 (Applications) 文件夹。
2. 打开系统自带的 终端 (Terminal)。
3. 复制并执行以下命令以移除安全隔离属性（可能需要输入开机密码）：

sudo xattr -cr "/Applications/Skills Dock.app"

4. 重新在应用程序中双击打开 Skills Dock 即可正常运行。

Linux

Linux 用户可以任选以下方式：

1. 使用 .AppImage

chmod +x Skills\ Dock_*.AppImage
./Skills\ Dock_*.AppImage

2. 使用 .deb（适用于 Debian / Ubuntu 及其衍生版）

sudo dpkg -i skills-dock_*_amd64.deb
sudo apt-get install -f

✅ 当前已经支持

目前这个版本可以：

• 扫描 Codex、Claude、Gemini、OpenCode 的本地 Skill 目录
• 支持添加自定义 Skill 文件夹
• 将本地 Skills 按来源包或本地整合包聚合成 Bundles
• 支持创建本地整合包（custom bundle），并维护成员 Skills
• 展示 Claude、Codex、Gemini、OpenCode 各自的安装状态
• 通过复制或删除目标目录中的 Skill 文件夹，切换单个应用的安装状态
• 支持对本地整合包配置目标应用、同步状态和修复动作
• 从 ZIP 一键导入 Skills 到本地目录
• 将当前选中的 Skills 一键导出为 ZIP
• 展示 Bundle 概览、成员 Skills、校验状态和安装位置
• 自动调用统计：通过 Rust 解析 Claude、Codex、Gemini、OpenCode 的本地会话记录，自动且真实地反映 Agent 在背后调用各 Skill 的次数
• 调用统计改为按需刷新，避免普通安装或同步动作触发高 CPU 的全量日志扫描
• 正式接入的远程 Skill 市场
• 在线安装、更新同步与发布流程

🚧 暂未包含

当前 MVP 还没有这些能力：

• 应用内直接编辑 Skill
• 同步、账号体系或云存储

🧪 两种开发模式

这个项目有两种运行方式，它们的用途并不相同。

1. 浏览器预览模式

运行：

npm run dev

适合用于：

• 布局调试
• 样式调整
• 组件交互开发

这个模式使用的是演示数据，不会扫描你本机的真实 Skill 目录。

2. 桌面应用模式

运行：

npm run tauri dev

当你需要验证下面这些真实行为时，应使用这个模式：

• 本地目录扫描
• 软链接 Skill 目录
• 打开文件、打开文件夹操作
• 各应用的安装开关
• 本地整合包的同步与修复
• 来自本机环境的真实统计结果

如果你只运行 npm run dev，应用会显示提示横幅，说明当前使用的是演示数据。

📁 内置识别的本地目录

桌面应用当前会自动识别这些内置路径：

• ~/.codex/skills
• ~/.codex/superpowers/skills
• ~/.claude/skills
• ~/.gemini/skills
• ~/.opencode/skills

此外，你也可以在 UI 中手动添加自定义本地目录。

🛠 环境要求

开始前请准备：

• Node.js
• npm
• Rust
• Cargo
• macOS 上的 Xcode 或 Xcode Command Line Tools

如果 xcode-select -p 能返回有效的 Xcode 路径，通常说明当前 macOS 环境已经满足 Tauri 开发要求。

如果你在 Linux 上开发 Tauri 桌面版本，还需要安装这些系统依赖：

sudo apt-get update
sudo apt-get install -y \
  build-essential \
  curl \
  file \
  libayatana-appindicator3-dev \
  libfuse2 \
  libgtk-3-dev \
  librsvg2-dev \
  libssl-dev \
  libwebkit2gtk-4.1-dev \
  patchelf

📦 安装依赖

npm install

🚀 常用命令

启动浏览器开发环境：

npm run dev

启动桌面应用：

npm run tauri dev

运行前端测试：

npm run test

构建前端产物：

npm run build

检查 Rust 侧编译状态：

cargo check --manifest-path src-tauri/Cargo.toml

运行 Rust 测试：

cargo test --manifest-path src-tauri/Cargo.toml

🧱 项目结构

仓库中比较重要的目录包括：

• src/ React 前端应用，包含布局、列表页、详情页以及相关 hooks
• src-tauri/ Rust 命令层，负责扫描、校验、文件操作和各应用安装切换
• docs/superpowers/specs/ MVP 设计说明
• docs/superpowers/plans/ 当前版本的实现计划

🖥 当前界面模型

应用目前围绕本地 Bundle 管理来组织界面：

• 概览 查看当前本地 Skills / Bundles 的整体状态
• Skills 按 Bundle 聚合展示来源包与本地整合包
• 详情 展示 Bundle 概览、成员 Skills、安装状态、来源与同步信息
• 导入/导出 处理 ZIP 导入与导出
• 调用统计 按需查看本地日志解析后的使用数据
• 市场 当前仅为静态预览页，用于占位未来正式市场能力

Skills 页会优先展示更适合用户阅读的摘要信息，而不是默认直接显示面向 Agent 的原始 SKILL.md 长文。

🔍 当前扫描逻辑

Rust 扫描器目前会：

• 识别包含 SKILL.md 的目录
• 跟随符号链接的 Skill 目录继续扫描
• 从 frontmatter 或 Markdown 标题中提取名称
• 计算校验状态
• 对内容做哈希，以便比较安装差异

这对 Claude Code 一类工具尤其重要，因为它们的 Skills 目录有时会通过软链接指向其他位置，例如 ~/.cc-switch/skills。

📌 当前状态

这个项目已经具备：

• 可运行的桌面应用基础骨架
• 已有测试覆盖的扫描与聚合逻辑
• 已有测试覆盖的应用安装切换逻辑
• 基于 main 分支初始化完成的 GitHub 仓库

下一步比较自然的演进方向包括：

• “导入已有 Skills” 流程
• 更清晰的来源分组与计数规则
• 针对 copy / symlink 安装策略提供更完善的设置项