mcpField
V
validate-skill

validate-skill

github.com/youdotcom-oss测试与质量9744 次安装今天更新
代码仓库

关于 validate-skill

validate-skill 是用于检查技能目录是否符合 AgentSkills 规范的命令行工具，适合创建技能、审查相关 PR 或发布前验证。它检查必填字段、命名规则和目录名称，并可输出 JSON 结果。

主要功能

  1. 01验证一个或多个技能目录
  2. 02检查必填 frontmatter 字段
  3. 03检查名称格式与目录名匹配
  4. 04支持 JSON 格式结果

适用场景

  1. 01创建新技能后检查目录结构
  2. 02审查修改技能的 PR
  3. 03发布技能前验证命名与字段

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/youdotcom-oss/agent-skills --skill validate-skill

安装后在 Claude Code 中输入/validate-skill确认已加载。

详细介绍

验证技能

用途

此技能可根据 AgentSkills 规范验证技能目录。使用它可确保技能具有正确的 frontmatter、必需字段，并遵循命名约定。

适用场景：

  • 在任意 Agent 的技能目录（.claude/skills/、.cursor/skills/ 等）中创建新技能
  • 审查修改技能的 PR
  • 发布前验证技能结构

脚本

validate-skill.ts

验证一个或多个技能目录。

bunx @plaited/development-skills validate-skill [paths...]

参数：

  • paths：要验证的路径（默认为当前 Agent 的技能目录）

选项：

  • --json：以 JSON 格式输出结果

示例：

# Validate skills in current directory's .claude/skills/
bunx @plaited/development-skills validate-skill .claude/skills

# Validate Cursor skills
bunx @plaited/development-skills validate-skill .cursor/skills

# Validate a specific skill
bunx @plaited/development-skills validate-skill .claude/skills/typescript-lsp

# Validate multiple paths with JSON output
bunx @plaited/development-skills validate-skill .claude/skills .cursor/skills --json

验证规则

必需字段
  • name：技能名称（小写字母、数字和连字符）
  • description：技能的简要说明
命名约定
  • 名称必须为小写
  • 只能使用字母、数字和连字符
  • 不能以连字符开头或结尾
  • 不能包含连续的连字符
  • 最长 64 个字符
  • 目录名称必须与技能名称一致
可选字段
  • license：许可证标识符
  • compatibility：运行时要求
  • allowed-tools：允许使用的工具列表，以逗号分隔
  • metadata：用于补充元数据的键值对

输出格式

人类可读（默认）
✓ .claude/skills/typescript-lsp
✓ .cursor/skills/my-skill
✗ .claude/skills/invalid-skill
  ERROR: Missing required field in frontmatter: 'description'

2/3 skills valid
JSON（--json）
[
  {
    "valid": true,
    "path": ".cursor/skills/my-skill",
    "errors": [],
    "warnings": [],
    "properties": {
      "name": "my-skill",
      "description": "..."
    }
  }
]

相关技能

  • typescript-lsp - 结构良好且包含脚本的技能示例
  • code-documentation - TypeScript/JavaScript 代码的 TSDoc 标准

评论

支持 Markdown