Popskill — Gerenciador de Skills para Claude
maojiebc/majia-Popskill
Gerencie 72+ skills em uma tabela com backup, atualização por hash e symlink
Ver no GitHubGerenciador local de skills para Claude Code e Codex que centraliza a instalação, atualização e manutenção de múltiplas habilidades. Usa symlinks e hash de conteúdo para rastrear versões, com suporte a recuperação automática de backups e reparo inteligente de dependências quebradas.
Instalação
npx convez-ai maojiebc/majia-Popskill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Centralizar e sincronizar skills em múltiplas instâncias de Claude/Codex
- Detectar atualizações de repositórios monorepo sem depender de versionamento
- Recuperar versões antigas de skills via reciclagm automática
- Reparar symlinks quebrados e detectar conflitos de dependências
Veredito

Solução nativa macOS bem-pensada para quem mantém ecosystem fragmentado de skills. Arquitetura elegante (filesystem como DB), mas limitada a macOS 14+ e requer afinidade com terminal/symlinks.
README
A tradução para o português deste README ainda está na fila.
Popskill
本地 AI 能力管理器。技能装一次,挂到多个 AI 工具上;坏了能修,旧了能升。Claude Code 和 Codex 的 skill,从此一张表管完。
中文 · English README
下载安装
↓ 下载 Popskill(2.3 MB,已签名 + 已公证)
要求 macOS 14 (Sonoma) 及以上。装完之后新版本走 Sparkle 应用内更新,不用再来 GitHub。
DMG 经过 Apple Developer ID 签名 + 公证 + 钉票,双击不会跳"未识别开发者"警告。
我为什么做这个
我的 Mac 上有 72 个 skill、来自 9 个上游、用着 6 种互不兼容的更新机制——npm 包、git monorepo、独立 clone、npx skills、自定义安装器、Marketplace。在 Popskill 之前,维持这套东西最新需要一个 178 行的 shell 脚本加 launchd 定时任务,而且没有任何工具能回答「我装了什么、哪个旧了、哪条链断了」。
Popskill 的回答是把管理建立在一个最简单的事实上:技能就是文件夹,启用就是 symlink。
~/.agents/skills/baoyu-comic/ ← store:技能本体(装一次)
~/.claude/skills/baoyu-comic → 软链 ← Claude Code 用
~/.codex/skills/baoyu-comic → 软链 ← Codex 用
文件系统就是数据库。没有 sidecar、没有 SQLite,你的目录结构本身即全部状态——Popskill 只是给它一张看得见、点得动的脸。
截图
功能
- 能力矩阵 — 全部技能一张表:每行一个能力,Claude / Codex 两枚状态 pill,点一下挂载/摘除
- 源式套装 — 同一上游仓库的技能自动归拢成一张卡(宝玉系 22 项、飞书系 26 项),磁盘平铺、symlink 不动
- 内容哈希更新 — 不依赖版本号,逐成员 SHA-256 比对上游;monorepo 一次 clone 检完全员、只换变化的,还提示「上游新增了 N 个你没装的」
- 更新前自动备份 — 被替换的旧版进回收站(保留 20 份),随时可恢复
- 行内修复 — 断链 / 本地副本一键处理;所有危险操作只动 symlink,真实目录一律进回收站
- 未托管导入 — 散落在
~/.claude/~/.codex的真实技能目录,一键收编进 store 换成 symlink - 键盘导航 —
↑↓行焦点、←→选工具列、空格切换挂载或修复、/搜索、Esc退出 - 内置精选目录 — 约 80 个热门 skill 的中文一句话简介与类型提示,上游英文长描述不再直出卡片
快速上手
- 装好打开——如果你已经在用
~/.agents/skills/(npx skills生态约定目录),矩阵会直接铺满你现有的技能 - 还没有?点「+ 添加」粘贴一个 GitHub 仓库试试,比如
github.com/anthropics/skills - 在卡片上点 Claude / Codex pill 挂载;点 ✕ 或 ◐ 修复异常;设置里开「自动更新」
工作原理
来源识别是五级回填:popskill 自装记录 → .skill-lock.json(npx skills 生态锁文件)→ 技能目录自带的 git remote → SKILL.md frontmatter homepage → 内置精选目录(救 guanskill 这类复制安装的「来源孤儿」)。更新比对用目录内容哈希(SHA-256),所以没有规范版本号的技能也能发现更新。
FAQ
Q:为什么不上 Mac App Store?
App Store 的 sandbox 不允许应用管理 ~/.claude、~/.codex 这些目录的 symlink。直接分发才能让它真正干活。签名 + 公证保证安全性等价。
Q:收集任何数据吗?
不。100% 本地运行,无统计、无遥测。网络访问只有两种:检查更新时 git clone 你自己技能的上游仓库,以及 Sparkle 检查应用自身更新。
Q:数据存在哪?怎么卸载?
技能本体在 ~/.agents/(这是你的数据,不是 Popskill 的);应用自身的元数据只有一个 ~/.agents/.popskill.json。卸载 = 把 Popskill.app 拖进废纸篓,你的技能和 symlink 原样保留。
Q:它会动我的文件吗?
防呆三条铁律:只删 symlink、真实目录一律进回收站(~/.agents/.trash/,留 20 份)、store 目录绝不被开关动到。40 个引擎单测盯着这些行为。
Q:支持 Claude Code / Codex 之外的工具吗?
架构上工具列表是动态的,但当前版本刻意只做这两个(我自己的真实需求)。原生扫描 ~/.agents/skills/ 的工具(如 opencode)无需 symlink 直接可用。
Q:Windows / Linux? 不做。纯 SwiftUI,Mac only。
版本
当前 v2.7.1 · 全部版本见 Releases · 更新日志在 docs/release/
v2 是一次按第一性原理的重写(一个屏幕、文件系统即数据库)。v1.x(sidecar 架构)已下线,设计过程归档在 docs/design/。
致谢
- CC Switch — 这个项目的起点。Popskill v1 以零 fork 方式(git submodule)把它的 Rust services 层直接当存储引擎用;v2 虽然改为纯 Swift 直写文件系统,但 v2.1 的更新机制——内容哈希比对上游、更新前自动备份、按应用独立启用位——都直接借鉴自它的 skill 管理设计。
- Sparkle — Mac 应用内自动更新的事实标准,本应用的更新分发由它驱动。
npx skills生态 —~/.agents/skills/跨工具约定目录与.skill-lock.json锁文件,是 Popskill 来源识别与互操作的基石。
👤 作者 / 联系
马甲(@maojiebc) · 超级马甲
如果这款 Mac app 帮到你,欢迎在以下任意渠道找我交流踩坑实录、提需求、报 bug,也欢迎勾兑 Mac 自研 app / 用户运营 / AI 工具集成的实战经验:
| 渠道 | 链接 |
|---|---|
| m9224@163.com | |
| 🐙 GitHub | github.com/maojiebc |
| 🪝 ClawHub | clawhub.ai/p/maojiebc |
| 🐦 X | @maojiebc |
| 📕 小红书 | 超级马甲 |
| 📰 微信公众号 | 超级马甲 |
这款 app 是 14 年用户运营 + Mac 自研实战沉淀 出来的,问题/合作随时聊。