skillsig
SuperMarioYL/skillsig
Signed manifest + scope-drift detector for Claude Code skills.
Instalação
npx convez-ai SuperMarioYL/skillsig1 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
README
A tradução para o português deste README ainda está na fila.
English | 简体中文
skillsig 是给 Claude Code Skill 做签名 + 权限漂移检测的命令行验证器。 在
claude skills update把更广的权限静悄悄拉进来之前,先在 CI 里把它拦住。
目录
- 为什么需要它
- 60 秒上手
- 演示
- 核心概念:skillsig manifest
- 对比:skillsig vs 既有方案
- 配置一览
- 发布到 CI
- 路线图
- 付费版(v0.2)
- 贡献 & 许可
- Share this
为什么需要它
ComposioHQ/awesome-claude-skills 与 sickn33/antigravity-awesome-skills
两份清单合计 10 万星、1 494+ 个 Skill,每天还以约 280 颗星的速度往上涨。
@affaan-m 的 everything-claude-code
就是其中一份还在持续增长的合集。每一个 Skill 都是一段挂在 Claude Code 上的
prompt + 工具授权 + 文件系统/网络范围;claude skills update 会在用户下一次开会话时
默默拉回最新内容。2026 年 5 月 Ars Technica 报道的
jqwik prompt-injection 事件 已经把这种攻击落实到生产:一个被信任的开发包带毒上线,
让 AI 编码代理删用户的应用输出。
今天没有任何机制能回答:
- 我团队装的 Skill 里,哪些声明了对
~/的写入? - 上周我审过的那份 manifest,是不是就是刚才被拉下来的那份?
- 某个 Skill 在版本 0.3.0 之后,悄悄多加了一行
Bash(rm -rf …),CI 能拦下来吗?
skillsig 就是来回答这三个问题的:声明范围的 YAML manifest,加上 Sigstore keyless 签名,
再加上 ~/.skillsig/lock.yaml 跨版本权限漂移检测。
60 秒上手
# 1) 装 (macOS:Homebrew tap 即将上线;先用 go install)
go install github.com/SuperMarioYL/skillsig/cmd/skillsig@latest
# 2) 立刻看到它能干嘛(仓库自带 jqwik 复现 fixture)
git clone https://github.com/SuperMarioYL/skillsig && cd skillsig
skillsig verify ./testdata/skills/
# 3) 给自己的 Skill 生成一份 manifest
cd ~/.claude/skills/my-skill
skillsig init
$EDITOR SKILLSIG.yaml # 收紧 declares.fs_write / declares.network_egress
skillsig sign # ed25519 dev 模式;--keyless 走 Sigstore Fulcio
SKILL VERDICT DETAILS
----- ------- -------
skillsig-examples/jqwik-style-bad SCOPE-DRIFTED undeclared grant(s): Bash(rm -rf ~/.claude/*)
skillsig-examples/safe-skill TRUSTED scope matches declared manifest (sidecar)
scope-mismatch UNSIGNED no skillsig manifest (sidecar or SKILLSIG.yaml)
3 skill(s): 1 trusted, 1 unsigned, 1 scope-drifted
演示
📼 演示录制中(参见
assets/README.md了解如何用 vhs 重新生成)。 tape 脚本:assets/demo.tape| 时长目标 30 秒。
发布之后这里会嵌入:
[](https://asciinema.org/a/PLACEHOLDER)
核心概念:skillsig manifest
skillsig 引入的新名词是 manifest:在 SKILL.md 里嵌入一段 fenced YAML 边栏,
或者写到同目录的 SKILLSIG.yaml。它声明四件事 —— model × tools × fs_write × network_egress。
skillsig: v1
skill_id: skillsig-examples/safe-skill
version: 0.1.0
declares:
model: claude-opus-4-7 # 作者声明的目标模型(SKILL.md 里没有这个字段)
tools: # 与 SKILL.md `allowed-tools` 一一比对
- Read
- Edit
- Bash(git status*)
- Bash(git diff*)
fs_write: # 仅工作区,不允许 $HOME
- "${WORKSPACE}/**"
network_egress: [] # 空 = 不联网
attestation:
sigstore_bundle: ./skillsig.bundle
skillsig verify 把 manifest 的 declares.tools 当作白名单,扫描 SKILL.md 真正生效的
allowed-tools:凡是 actuals 里没在白名单中出现的条目,就是这次扫描标红 SCOPE-DRIFTED
的原因 —— 这正是 jqwik 那条 Bash(rm -rf ~/.claude/*) 走过来的路径。
对比:skillsig vs 既有方案
| 维度 | skillsig | awesome-list 人工 review | Sigstore / SLSA 单独用 | 平台自带(推测中) |
|---|---|---|---|---|
| 列出 1 494+ 个 Skill 的权限差异 | ✓ | — | — | partial |
对 (model, tools, fs_write, net) 这个 tuple 做声明 | ✓ | — | — | partial |
在 update 之后检测权限漂移 | ✓ | — | — | — |
| Sigstore keyless 签名 | ✓(m2 上线) | — | ✓ | partial |
| 跨宿主(Cursor / Codex / Gemini / Antigravity) | ✓ 格式可移植 | partial | ✓ | — |
| 中国大陆可用 | ✓(CI 内签名 + 离线 verify) | ✓ | partial(Fulcio 联通问题) | — |
说句公道话:awesome-claude-skills 和 antigravity-awesome-skills 在 发现 这一层做得比 skillsig 完整得多;skillsig 不替代它们,而是补上后续的 信任 这一层。
配置一览
skillsig verify 默认零配置,下面这几项可按需打开:
| 配置 | 类型 | 默认 | 含义 |
|---|---|---|---|
SKILLSIG_HOME | env | $HOME/.skillsig | 锁文件 / 临时凭据存放目录 |
--ci | flag | false | 出现 UNSIGNED 或 SCOPE-DRIFTED 时退出码非零,CI 用 |
--no-color | flag | false | 关闭 ANSI 上色,方便 diff |
attestation.sigstore_bundle | yaml | ./skillsig.bundle | manifest 指向的签名 bundle 路径 |
~/.skillsig/lock.yaml | yaml | 自动 | 每个 skill_id 上一次 TRUSTED 时的范围基线(m3) |
发布到 CI
GitHub Actions:
- name: verify installed skills have not drifted
run: |
go install github.com/SuperMarioYL/skillsig/cmd/skillsig@latest
skillsig verify --ci ./skills/
GitLab CI:
verify-skills:
image: golang:1.24
script:
- go install github.com/SuperMarioYL/skillsig/cmd/skillsig@latest
- skillsig verify --ci ./skills/
--ci 让任何一行 UNSIGNED 或 SCOPE-DRIFTED 都直接 fail。配合 --no-color
就能拿到稳定 diff 的纯文本输出。
路线图
- m1 — manifest schema + parser +
skillsig verify3-color 表 + jqwik fixture 复现 - m2 —
skillsig sign:ed25519 dev 模式 + Sigstore keyless OIDC 占位(接 sigstore-go) - m3 —
skillsig diff old/ new/+~/.skillsig/lock.yaml跨版本漂移 - v0.2 —
skillsig.cloud托管镜像 + 团队策略 + 飞书/Slack/微信群 webhook 告警 - v0.3 — runtime hook:在 host CLI 加载 Skill 之前把声明范围当成沙箱配置应用
之后的计划见 CHANGELOG.md。
付费版(v0.2)
OSS 这一半永远免费,verify 永远免费。但 v0.1 README 把付费路径写在显眼处,是因为
靠卖 skillsig.cloud 托管镜像 + 告警这一档来养仓库的迭代速度。
| 档位 | 价格 | 内容 |
|---|---|---|
| 个人 / OSS | ¥0 | skillsig verify / init / sign / diff、自托管签名、社区支持 |
| 团队 | ¥99/月(≤10 席) | skillsig.cloud 镜像、团队策略 YAML、微信群 / Slack webhook、订阅 awesome-list 漂移告警 |
| 企业 | ¥999/月 | SSO、本地化部署、审计日志、专属 SLA、签名身份审计 |
国际定价:$14/$140 USD。微信支付 + 支付宝 + Stripe 全部接,账号在 skillsig.cloud
开放白名单(v0.1 启动期为内测)。想列入早期客户可以 开 Issue 打招呼。
贡献 & 许可
- 想交个 fixture?把 SKILL.md 放到
testdata/skills/下,开 PR 即可。 - 想给 awesome-list 加
signed:字段?我们正在做样例 PR,欢迎一起。 - License: MIT,永远是 MIT,没有 CLA。
Share this
skillsig — 给 Claude Code Skill 做签名 + 权限漂移检测的命令行验证器。
jqwik 事件之后,Skill 装得越多越要把权限关进 manifest。
github.com/SuperMarioYL/skillsig