@claw-dev/validator

OpenClaw 技能验证器 - 检查 SKILL.md 格式和结构

🚀 功能

• 验证 SKILL.md frontmatter 格式
• 检查必需字段（name, description, metadata）
• 验证 metadata 结构
• 检查描述长度
• 比对技能名与目录名
• 批量验证目录中的所有技能

📦 安装

npx @claw-dev/validator

📖 使用

验证单个 SKILL.md

claw-validate path/to/SKILL.md

验证目录中的所有技能

claw-validate path/to/skills/

显示详细信息

claw-validate -v

🔍 检查内容

必须满足（ERROR）

• ✅ SKILL.md 文件存在
• ✅ Frontmatter 格式正确（--- 包裹）
• ✅ 包含 name 字段
• ✅ 包含 description 字段
• ✅ 包含 metadata 字段
• ✅ metadata.openclaw 存在
• ✅ metadata JSON 格式正确

建议满足（WARNING）

• ⚠️ metadata.openclaw.emoji 存在
• ⚠️ metadata.openclaw.requires 存在
• ⚠️ 描述长度在 10-100 字符之间
• ⚠️ 技能名与目录名匹配
• ⚠️ 有文档内容

📊 输出示例

成功

🔍 验证: my-skill/SKILL.md

  ✓ SKILL.md 格式正确 ✨

==================================================
✓ 验证通过

有问题

🔍 验证: my-skill/SKILL.md

  ✗ 缺少必需字段: description
  ⚠️ metadata.openclaw.emoji 缺失（建议添加表情符号）

==================================================
✗ 验证失败

🎨 与 claw-starter 配合

# 1. 生成技能
npx @claw-dev/starter create my-skill

# 2. 验证
claw-validate my-skill/SKILL.md

📝 规则说明

Frontmatter 格式

---
name: MySkill
description: 技能描述
metadata:
  {
    "openclaw": { "emoji": "🤖", "requires": {} }
  }
---

描述长度建议

• 最少：10 字符
• 最多：100 字符

目录名匹配

目录名应该与 name 字段一致，避免混淆。

🤝 贡献

欢迎提交 Issue 和 PR！

📄 许可证

MIT © 梦心

Made with 🌙 by 梦心