SuperAPI AI 工具集

skill-create

智能体与模型

查看项目

更新于 10-16 06:19

技能介绍

用途:对某个 Agent Skill 目录做结构、元数据与可维护性审查,对照 Cursor 官方「Creating Skills」约定(与内置 create-skill 指南一致)。默认若用户用 @ 指向目录,则以该目录为审查目标;否则先确认路径。

主要能力:检查根级 SKILL.md 是否存在,记录 references/、scripts/、agents/ 等子目录;校验 frontmatter 中 name(全小写、仅字母数字与连字符、≤64 字符)和 description(非空、≤1024 字符、第三人称、含 WHAT 与 WHEN 及可检索触发词);评估正文体量(宜 ≤500 行,过长应拆到 references/*.md);检查链接引用是否一层深度;若存在 scripts/,检查用途、调用方式、执行或仅供参考的说明以及正斜杠路径;扫描反模式,如 Windows 反斜杠路径、等价工具罗列无默认项、硬编码易过期日期、术语不一致;对 agents/openai.yaml 等扩展项检查其与 SKILL.md 的 name/能力描述是否一致、是否在正文被提及。

使用方式:提供技能目录路径后运行审查,工具按步骤列目录、读 frontmatter、读正文体量、检查链接与脚本、扫描反模式,并输出固定小节的中文报告:结论(合规/基本合规需小改/需重点修订)、符合项、问题与建议(分严重与一般)、可选后续(满分优先做的 1–3 件事)。不替用户改稿,除非明确要求修改。

限制:主要面向 Cursor 技能编写约定;具体输出格式与执行环境暂未提供;不负责自动修复内容。