convez.ai
MCP Server
SuperMarioYL

skillsig

SuperMarioYL/skillsig

Ver no GitHub
InicialPluginScore · de 0 a 100

Signed manifest + scope-drift detector for Claude Code skills.

Instalação

$npx convez-ai SuperMarioYL/skillsig

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 semanas
Versão
v0.12.0
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

English | 简体中文

skillsig 是给 Claude Code Skill 做签名 + 权限漂移检测的命令行验证器。 在 claude skills update 把更广的权限静悄悄拉进来之前,先在 CI 里把它拦住。

目录


为什么需要它

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 秒。

发布之后这里会嵌入:

[![asciicast](https://asciinema.org/a/PLACEHOLDER.svg)](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 既有方案

维度skillsigawesome-list 人工 reviewSigstore / 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_HOMEenv$HOME/.skillsig锁文件 / 临时凭据存放目录
--ciflagfalse出现 UNSIGNED 或 SCOPE-DRIFTED 时退出码非零,CI 用
--no-colorflagfalse关闭 ANSI 上色,方便 diff
attestation.sigstore_bundleyaml./skillsig.bundlemanifest 指向的签名 bundle 路径
~/.skillsig/lock.yamlyaml自动每个 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 verify 3-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¥0skillsig 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
Ver o original no GitHub

Bom para

Relacionados