SkillHub 上传资料包预检器

对指定的 Skill 文件夹或 ZIP 做只读预检，输出“可上传”或必须修复的问题清单。不要修改原始资料包；修复前先向用户说明问题和目标文件。

使用方法

检查 ZIP：

python scripts/validate_skillhub_package.py "C:\\path\\to\\skill.zip"

检查未打包的 Skill 文件夹：

python scripts/validate_skillhub_package.py "C:\\path\\to\\skill-folder"

需要机器可读报告时添加 --json。退出码为 0 表示没有错误，1 表示存在阻止上传的错误。

检查规则

• 必须包含根目录 SKILL.md。
• 文件数量不得超过 200，总大小不得超过 10 MB。
• ZIP 内路径必须使用 /；禁止反斜杠、绝对路径、盘符路径和 ..。
• SKILL.md 必须有 YAML frontmatter，且包含合规的 name 与非空 description。
• 提醒移除 __MACOSX、.DS_Store、Thumbs.db 等无关文件。
• 在文本文件中提示疑似 API Key、Token、私钥或硬编码密码；提示不代表一定泄露，必须人工确认。

处理结果

• 错误：阻止上传，先修复再重新打包。
• 警告：通常能上传，但应在公开前确认。
• 通过：仅表示通过本地预检，不代表平台一定审核通过，也不替代平台安全扫描。

不要扫描用户未明确指定的目录，不要上传扫描内容，不要把真实密钥显示在报告中。

资源

scripts/validate_skillhub_package.py 使用 Python 标准库运行，不需要安装额外依赖。