Skill Author 是一个编写 Claude Code skill 的规范与模板。它说明 skill 是位于 .claude/skills/<skill-name>/SKILL.md 的 markdown 文件,通过 Skill 工具或 CLAUDE.md 引用加载,是给 Claude 执行的 runbook,而非提示词或 README。目录采用 kebab-case 小写命名,用最短且无歧义的名称。
主要能力:规定 YAML frontmatter 的 name、description、user-invocable、argument-hint、allowed-tools 字段及写法要求;规定章节顺序:一行目的标题、When to Use、Prerequisites、Core Workflow、Decision Tables、Error Handling、Critical Rules;要求使用真实命令与真实 flag、编号步骤、决策表、可视化的 gotcha,并明确“何时不要使用”。
使用方式:按模板编写 SKILL.md,frontmatter 示例如 name、description、user-invocable: true、allowed-tools: Read, Write, Bash, Glob, Grep;先决条件用 bash 代码块给出验证命令;工作流分步写命令;多路径用表格;常见失败单独列出。
限制:不得把 skill 写成用户说明或示例集;不得用伪代码或“取决于”等模糊表述;gotcha 不能埋在正文里;需说明不适用场景;错误处理只覆盖非显而易见的失败模式。资料未提供收费、价格、平台或效果信息。