工程· Claude / GPT-4o
Anthropic Skill 骨架(SKILL.md + references)
给一个工作流意图,产出符合 anthropics/skills 规范的 SKILL.md 文件,包含 frontmatter + 触发条件 + steps + references 引用。
Claude CodeSkillAnthropic
提示词
你是熟悉 anthropics/skills 仓库的资深 Skill 工程师。请基于我给的工作流意图,生成一个符合规范的 SKILL.md 骨架。
规范要求(必须遵守):
1. 文件开头是 YAML frontmatter,只有两个字段:
- `name`: kebab-case,简短(< 30 字符)
- `description`: 一段长描述。**必须**包含三部分:做什么 / 何时触发 / 触发关键词。description 越详细,Claude 触发越准。
2. 正文 Markdown,结构如下:
- `# {Name}` 大标题
- 1-2 段简短介绍
- `## When to use` —— 列出明确的触发场景和反例(when NOT to use)
- `## Workflow` —— 步骤化的执行流程,带子标题
- `## References` —— 引用的资源(如果有的话,列在 `references/` 子目录)
- `## Examples` —— 至少 1 个具体输入 + 期望输出
3. 语气:第二人称对 Claude 说话,不要"用户应该"
4. 长度 < 150 行(简短的 skill 反而更好用)
产出:
1. 完整的 SKILL.md 文件内容
2. references/ 子目录建议(给 2-3 个文件名 + 用途)
3. 测试 prompt(用来验证 Claude 真的会触发这个 skill)
工作流意图:
{{用一段话描述你想让 Claude 自动做的事,例如:"每次我在写新博客 MDX 时,自动按统一格式生成 frontmatter"}}
用法
写完 SKILL.md 后,放到 ~/.claude/skills/{name}/SKILL.md,Claude Code 自动加载。
测试触发:用模型给的"测试 prompt"在新 session 跑一遍,确认 Claude 真的调用了这个 skill(可以从 Tool calls 里看到 Read 了 SKILL.md)。
改写思路
- 企业 / Team Skill → 在约束加 "skill 需要被 dev/staff 多人复用,所以写清楚 assumptions 和 constraints"
- MCP-integrating Skill → 加约束 "需要调用 specific MCP tool,在 Workflow 里明确 MCP 工具名"
- 教学型 Skill(给新人) → 加约束 "Workflow 步骤越细越好,每步给反例"
坑点
- AI 写出来的
description经常太短/泛,关键是放具体触发关键词,例如 "trigger on: 用户提到 'new blog post' / 'write a blog' / '新建博客' / 'MDX'" - 不要在 SKILL.md 里堆资源,把样板代码 / 长 reference 放 references/ 子目录,SKILL.md 提一句 "see references/X.md"
- 注意:已有的官方 Anthropic skills (见 /hub/skills) 是最好的样板