skill-vetter
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese—
技能审查工具（Skill Vetter）
<!--zh
面向AI Agent技能的安全优先审查协议。安装任何技能前必须先进行审查。
技能安全审查（Skill Vetter）
适用场景
安装任何技能之前，必须先执行此审查流程。
-->
- 在从平台技能市场安装任何技能之前
- 在从skillhub安装外部技能之前
- 在运行GitHub仓库中的技能之前
- 在评估其他Agent分享的技能时
- 任何时候被要求安装来源不明的代码时
Skill Vetter
审查流程
—
第一步：来源核查
Security-first vetting protocol for AI agent skills. Never install a skill without vetting it first.
<!--zh需要确认的问题：
- 该技能来自何处？（平台市场 / skillhub / GitHub / 其他）
- 作者是否知名且可信？
- 它的下载量/Star数量有多少？
- 最近一次更新是什么时候？
- 是否有其他Agent的使用评价？
何时使用
第二步：预览安装到临时目录，读取所有文件
- 从平台技能市场添加技能之前
- 从 skillhub 安装外部技能之前
- 从 GitHub 仓库安装技能之前
- 评估其他 Agent 分享的技能时
- 任何被要求安装来路不明的代码时 -->
请勿先正式安装，先安装到临时目录进行审查。
根据来源选择对应的预览方式：
skillhub来源（支持指定临时目录）：
--dirbash
skillhub --dir /tmp/skillhub-preview/ install <slug>安装完成后，使用列出并逐一读取所有文件内容：
shell_execbash
undefinedWhen to Use
列出所有文件
- Before installing any skill from the platform skill market
- Before installing external skills from skillhub
- Before running skills from GitHub repositories
- When evaluating skills shared by other agents
- Anytime you are asked to install unknown code
<!--zh
shell_exec(command="find /tmp/skillhub-preview/<skill-name> -type f | sort")
审查协议
逐一读取（对每个文件执行）
第一步：来源核查
—
-->
shell_exec(command="cat /tmp/skillhub-preview/<skill-name>/SKILL.md")
shell_exec(command="cat /tmp/skillhub-preview/<skill-name>/scripts/<file>.py")
Vetting Protocol
... 依次读取所有脚本、配置、引用文件
Step 1: Source Check
—
<!--zh
需要确认的问题：
- 技能来自哪里？（平台市场 / skillhub / GitHub / 其他）
- 作者是否已知、可信？
- 下载量 / Star 数量如何？
- 最近更新时间？
- 是否有其他 Agent 的使用评价？
-->
Questions to answer:
- Where did this skill come from? (platform market / skillhub / GitHub / other)
- Is the author known or reputable?
- How many downloads or stars does it have?
- When was it last updated?
- Are there reviews from other agents?
如果审查通过，执行不带`--dir`的正式安装命令；无论结果如何，清理临时目录：
```bash
shell_exec(command="rm -rf /tmp/skillhub-preview/")平台技能市场 / 我的技能库来源（同样支持安装到临时目录）：
--dirbash
shell_exec(command="skillhub install-platform-me <code> --dir /tmp/skillhub-preview/")第二步：预览安装到临时目录，读取所有文件
or
不要先正式安装，先安装到临时目录进行审查。
根据来源选择对应的预览方式：
skillhub 来源（支持 指定临时目录）：
-->
--dirshell_exec(command="skillhub install-platform-market <code> --dir /tmp/skillhub-preview/")
安装后用`shell_exec`列出并逐一读取所有文件内容：
```bashStep 2: Preview Install to Temp Dir, Then Read All Files
列出所有文件
Do not install to the real skills directory yet. Install to a temp directory first for inspection.
Choose the preview method based on the source:
<!--zh
**skillhub 来源**（支持 `--dir` 指定临时目录）：
-->
skillhub source (supports for temp directory):
--dirbash
skillhub --dir /tmp/skillhub-preview/ install <slug>After install, use to list and read all files:
shell_execbash
undefinedshell_exec(command="find /tmp/skillhub-preview/<skill-name> -type f | sort")
列出所有文件
逐一读取
shell_exec(command="find /tmp/skillhub-preview/<skill-name> -type f | sort")
shell_exec(command="cat /tmp/skillhub-preview/<skill-name>/SKILL.md")
shell_exec(command="cat /tmp/skillhub-preview/<skill-name>/scripts/<file>.py")
逐一读取（对每个文件执行）
... 依次读取所有文件
shell_exec(command="cat /tmp/skillhub-preview/<skill-name>/SKILL.md")
shell_exec(command="cat /tmp/skillhub-preview/<skill-name>/scripts/<file>.py")
如果审查通过，执行不带`--dir`的正式安装命令；无论结果如何，清理临时目录：
```bash
shell_exec(command="rm -rf /tmp/skillhub-preview/")... 依次读取所有脚本、配置、引用文件
第三步：代码审查（必须执行）
<!--zh
审查通过后，执行不带 `--dir` 的正式安装命令；无论结果如何，清理临时目录：
-->
If approved, run the normal install without `--dir`. Either way, clean up the temp dir:
```bash
shell_exec(command="rm -rf /tmp/skillhub-preview/")Platform market / my skill library source (also supports for temp directory):
--dirbash
shell_exec(command="skillhub install-platform-me <code> --dir /tmp/skillhub-preview/")阅读技能目录下的所有文件。如果出现以下任何情况，立即拒绝安装：
出现以下情况立即拒绝：
─────────────────────────────────────────
- 使用curl/wget访问未知URL
- 向外部服务器发送数据
- 请求凭证、令牌或API密钥
- 无明确理由读取~/.ssh、~/.aws、~/.config
- 访问MEMORY.md、USER.md、SOUL.md、IDENTITY.md
- 对任何内容使用base64解码
- 使用eval()或exec()处理外部输入
- 修改工作区外的系统文件
- 未明确列出就安装软件包
- 调用网络时使用原始IP地址而非域名
- 混淆代码（压缩、编码或混淆处理）
- 请求提升权限或sudo权限
- 访问浏览器Cookie或会话
- 触碰凭证文件
─────────────────────────────────────────or
第四步：权限范围评估
shell_exec(command="skillhub install-platform-market <code> --dir /tmp/skillhub-preview/")
<!--zh
安装后用 `shell_exec` 列出并逐一读取所有文件内容：
-->
After install, use `shell_exec` to list and read all files:
```bash评估以下维度：
- 它需要读取哪些文件？
- 它需要写入哪些文件？
- 它会执行哪些命令？
- 是否需要网络访问？访问哪里？
- 权限范围是否与其声明的用途匹配（最小必要原则）？
列出所有文件
第五步：风险分级
shell_exec(command="find /tmp/skillhub-preview/<skill-name> -type f | sort")
| 风险级别 | 示例 | 处置方式 |
|---|---|---|
| 低（LOW） | 笔记、天气、格式化 | 基础审查后可安装 |
| 中（MEDIUM） | 文件操作、浏览器、外部API | 必须完整代码审查 |
| 高（HIGH） | 凭证操作、交易、系统命令 | 需要用户人工审批 |
| 极高（EXTREME） | 安全配置、root权限 | 禁止安装 |
逐一读取
审查报告格式
shell_exec(command="cat /tmp/skillhub-preview/<skill-name>/SKILL.md")
shell_exec(command="cat /tmp/skillhub-preview/<skill-name>/scripts/<file>.py")
审查完成后，输出以下格式的报告：
技能审查报告
=======================================
技能名称: [名称]
来源: [平台市场 / skillhub / GitHub / 其他]
作者: [用户名]
版本: [版本号]
---------------------------------------
指标:
- 下载量/Star数: [数量]
- 最近更新时间: [日期]
- 已审查文件数: [数量]
---------------------------------------
危险信号: [无 / 列出具体内容]
所需权限:
- 文件: [列出或“无”]
- 网络: [列出或“无”]
- 命令: [列出或“无”]
---------------------------------------
风险级别: [低 / 中 / 高 / 极高]
结论: [可安全安装 / 谨慎安装 / 禁止安装]
备注: [任何观察结果]
=======================================... 依次读取所有文件
信任层级
<!--zh
审查通过后，执行不带 `--dir` 的正式安装命令；无论结果如何，清理临时目录：
-->
If approved, run the normal install without `--dir`. Either way, clean up the temp dir:
```bash
shell_exec(command="rm -rf /tmp/skillhub-preview/")- 平台官方技能（通过平台市场发布）→ 较低审查强度（仍需审查）
- 高Star仓库（1000+） → 中等审查强度
- 已知作者 → 中等审查强度
- 新的/未知来源 → 最高审查强度
- 申请凭证的技能 → 必须经过用户人工审批
第三步：代码审查（必须执行）
基本原则
阅读技能目录下的所有文件。遇到以下任何情况，立即拒绝安装：
-->
- 没有任何技能值得为此牺牲安全性
- 有疑问时，不要安装
- 将高风险决策交给用户
- 记录审查内容，供后续参考
Step 3: Code Review (MANDATORY)
—
Read ALL files in the skill. Reject immediately if any of the following are present:
REJECT IMMEDIATELY IF YOU SEE:
─────────────────────────────────────────
- curl/wget to unknown URLs
- Sends data to external servers
- Requests credentials, tokens, or API keys
- Reads ~/.ssh, ~/.aws, ~/.config without clear reason
- Accesses MEMORY.md, USER.md, SOUL.md, IDENTITY.md
- Uses base64 decode on anything
- Uses eval() or exec() with external input
- Modifies system files outside the workspace
- Installs packages without listing them explicitly
- Network calls to raw IP addresses instead of domains
- Obfuscated code (compressed, encoded, or minified)
- Requests elevated or sudo permissions
- Accesses browser cookies or sessions
- Touches credential files
─────────────────────────────────────────—
第四步：权限范围评估
—
-->
—
Step 4: Permission Scope
—
<!--zh
评估以下维度：
- 需要读取哪些文件？
- 需要写入哪些文件？
- 会执行哪些命令？
- 是否需要网络访问？访问哪里？
- 权限范围是否与其声明的用途相匹配（最小必要原则）？
-->
Evaluate:
- What files does it need to read?
- What files does it need to write?
- What commands does it run?
- Does it need network access? To where?
- Is the scope minimal for its stated purpose?
—
第五步：风险分级
—
-->
—
Step 5: Risk Classification
—
<!--zh
| 风险级别 | 示例 | 处置方式 |
|---------|------|---------|
| LOW（低） | 笔记、天气、格式化 | 基础审查后可安装 |
| MEDIUM（中） | 文件操作、浏览器、外部 API | 必须完整代码审查 |
| HIGH（高） | 凭证操作、交易、系统命令 | 需要用户人工审批 |
| EXTREME（极高） | 安全配置、root 权限 | 禁止安装 |
-->
<!--zh
| Risk Level | Examples | Action |
|---|---|---|
| LOW | Notes, weather, formatting | Basic review, install OK |
| MEDIUM | File ops, browser, external APIs | Full code review required |
| HIGH | Credentials, trading, system commands | Human approval required |
| EXTREME | Security configs, root access | Do NOT install |
<!--zh
—
审查报告格式
—
审查完成后，输出以下格式的报告：
-->
—
Output Format
—
After vetting, produce this report:
SKILL VETTING REPORT
=======================================
Skill: [name]
Source: [platform market / skillhub / GitHub / other]
Author: [username]
Version: [version]
---------------------------------------
METRICS:
- Downloads/Stars: [count]
- Last Updated: [date]
- Files Reviewed: [count]
---------------------------------------
RED FLAGS: [None / list them]
PERMISSIONS NEEDED:
- Files: [list or "None"]
- Network: [list or "None"]
- Commands: [list or "None"]
---------------------------------------
RISK LEVEL: [LOW / MEDIUM / HIGH / EXTREME]
VERDICT: [SAFE TO INSTALL / INSTALL WITH CAUTION / DO NOT INSTALL]
NOTES: [Any observations]
=======================================<!--zh
—
信任层级
—
- 平台官方技能（平台市场发布）→ 较低审查强度（仍需审查）
- 高 Star 仓库（1000+） → 中等审查强度
- 已知作者 → 中等审查强度
- 新的 / 未知来源 → 最高审查强度
- 申请凭证的技能 → 必须经过用户人工审批 -->
—
Trust Hierarchy
—
- Official platform skills (published via platform market) — lower scrutiny (still review)
- High-star repos (1000+) — moderate scrutiny
- Known authors — moderate scrutiny
- New or unknown sources — maximum scrutiny
- Skills requesting credentials — human approval always required
<!--zh
—
基本原则
—
- 没有任何技能值得为此牺牲安全性
- 有疑问时，不要安装
- 高风险决策交给用户来做
- 记录你审查过的内容，供后续参考 -->
—
Principles
—
- No skill is worth compromising security
- When in doubt, do not install
- Escalate high-risk decisions to the user
- Document what you vet for future reference
—