External Skill Auditor 是一个面向第三方 Agent Skill 的审计工具,目标是在全局安装或把外部技能收录进仓库之前,将其作为需要信任的资产进行审查。
用途与范围:仅用于外部技能导入审查,不用于创建技能(skill-creator)、常规代码审查(honest-review)、依赖或应用安全扫描(security-scanner)以及宽泛的技能发现(discover-skills)。
主要模式:空参数时显示审计模式菜单;triage 对来源做信誉、注册表信号、安装语法与去重风险评估;inspect 审查本地暂存技能文件的前置元数据、hooks、脚本与命令风险;commands 提取并分类 shell 命令、包管理器调用与网络操作;provenance 检查来源 URL、所有者、许可证、提交/哈希与注册表一致性;decision 输出 install-now、inspect、keep-global、build-local 或 avoid 建议;scan 运行本地静态扫描器并解读 JSON 输出。自然语言描述会自动匹配最接近的模式。
审计流程要求先获取原始来源与安装命令,仅运行只读检查,例如:npx skills add <source> --list。阅读候选 SKILL.md 及所有引用文件后,检查 hooks、脚本、允许工具、命令替换、shell 片段、网络调用、环境变量访问、凭证存储与文件写入。本地暂存目录可运行:uv run python skills/external-skill-auditor/scripts/audit_external_skill.py <skill-dir>,脚本输出仅作初步信号,仍需人工判断命令是否被记录且符合用途。
关键限制:安装决策必须有 npx skills add <source> --list 证据;报告凭证问题需脱敏;除语法或静态检查外,审计期间不得运行候选脚本;来源元数据与 install 行为冲突时需阻断;每条候选必须归入唯一结果类别;需记录证据日期。完成编辑后需通过 uv run wagents validate、uv run wagents eval validate、uv run python audit.py skills/external-skill-auditor、uv run wagents package external-skill-auditor --dry-run 等校验。