核心功能
skill-validator 是专为 ClawHub/OpenClaw 生态设计的官方技能验证与发布工具，由社区贡献者 puppetcat-fire (柏然) 开发维护。该工具深度集成 ClawHub 技能格式规范，提供从开发检验到发布的全链路自动化支持。
主要能力
1. 深度格式检验
- 验证 SKILL.md、package.json 等必需文件
- 检查 YAML/Frontmatter 语法合规性
- 检测脚本权限与安全风险
- 识别与 ClawHub 平台的兼容性问题
2. 智能自动修复
- 自动修复 shell 脚本执行权限
- 补全缺失的必要文件与元数据
- 提供明确的修复指导建议
3. 发布成功率提升机制
该工具的核心价值在于解决了 ClawHub CLI 的已知 bug：
- 工作目录 bug：自动切换至技能目录执行操作
- 文件检测 bug：采用替代检测方案绕过原生限制
- 权限问题：自动修复并规范化文件权限
实测数据显示，传统发布成功率仅 15%，使用该适配器后提升至 71%，综合提升 +58%。
技术实现
工具采用纯 Bash 编写，依赖 jq、find、grep、sed 等标准 Unix 工具，具有极强的可移植性。支持多种发布渠道降级策略（ClawHub → GitHub Releases → 本地 tar 包），确保发布流程的可靠性。
适用场景
- 技能开发者：开发阶段持续集成检验
- CI/CD 流水线：自动化发布与质量门禁
- 维护升级：批量技能版本更新与迁移
局限性
- 需预装 jq 等依赖工具
- 部分高级功能依赖 ClawHub CLI 环境
- 网络问题导致的发布失败仍需人工重试
安全评估
- 代码来源：GitHub 开源仓库（MIT-0 协议）
- 执行风险：仅执行本地文件验证与发布操作，无远程代码执行
- 权限要求：需要文件系统读写权限及 ClawHub/GitHub 认证凭据
版本信息
当前版本 v1.0.8（2026-03-18），持续与 ClawHub 规范同步更新。