用途:按 AgentSkills 规范校验一个或多个技能目录,确保技能具备正确的 frontmatter、必填字段并符合命名约定。适用场景包括:在任意 agent 的技能目录(如 .claude/skills/、.cursor/skills/)中创建新技能时;审查修改技能的 PR 时;发布前验证技能结构时。
主要能力与校验规则:必填字段为 name(小写、字母数字加连字符)与 description(技能简述)。命名约定要求小写、仅字母数字与连字符、不以连字符开头或结尾、不含连续连字符、最长 64 字符,且目录名必须与技能名一致。可选字段包括 license、compatibility、allowed-tools(逗号分隔)与 metadata(键值对)。
使用方式:命令为 bunx @plaited/development-skills validate-skill [paths...]。paths 为待校验路径,默认使用当前 agent 的技能目录。选项 --json 以 JSON 输出结果。示例:bunx @plaited/development-skills validate-skill .claude/skills;bunx @plaited/development-skills validate-skill .cursor/skills;bunx @plaited/development-skills validate-skill .claude/skills/typescript-lsp;bunx @plaited/development-skills validate-skill .claude/skills .cursor/skills --json。
输出:默认人类可读,显示每个技能的通过或错误(如缺少必填字段 description)并汇总通过数量;使用 --json 时输出数组,每项包含 valid、path、errors、warnings、properties。
限制:资料未提供收费、价格、平台、效果等其它信息;仅覆盖上述校验规则与用法。