如何为Claude Code编写自己的AI技能?ResumeSkills开发者指南与SKILL.md格式详解
【免费下载链接】ResumeSkillsA collection of AI agent skills focused on resume optimization, job applications, and career development. Built for job seekers, career changers, and professionals who want Claude Code to help with resume writing, ATS optimization, interview prep, and strategic job search.项目地址: https://gitcode.com/gh_mirrors/re/ResumeSkills
ResumeSkills 是一个专为 Claude Code 打造的 AI 技能(Skill)集合,包含 20 个聚焦简历优化、ATS 适配、面试准备的技能文件。它用纯 Markdown 文件教会 AI 助手如何完成求职任务——而这正是我们学习"如何为 Claude Code 编写 AI 技能"的绝佳教材。本文带你拆解它的 SKILL.md 格式,教你从零写出自己的技能文件。
什么是 AI 技能(Skill)?
简单来说:Skill 就是一个 Markdown 文件,用来给 AI Agent 注入特定任务的专业知识和工作流。
当你把技能文件放进项目的技能目录后,Claude Code 就能在识别到相关任务时,自动套用正确的框架和最佳实践。ResumeSkills 的 20 个技能全部位于 skills/ 目录下,每个技能独占一个文件夹,只包含一个 SKILL.md 文件:
| 技能 | 用途 |
|---|---|
| resume-ats-optimizer | 让简历通过 ATS 系统筛选 |
| resume-bullet-writer | 把弱描述改写成带数据的成就 |
| job-description-analyzer | 计算简历与岗位的匹配度 |
| interview-prep-generator | 生成 STAR 故事与模拟面试 |
💡 这些技能不只适用于 Claude Code,还支持 Cursor、Windsurf、Gemini CLI 等 30+ 款 AI 助手。
SKILL.md 三段式结构:打开任意技能文件看明白
打开任意一个技能文件,你会发现它们都遵循同一套结构。以 skills/resume-bullet-writer/SKILL.md 为例:
第一部分:YAML 前置信息(Frontmatter)
文件开头用---包裹的元数据是技能的"身份证":
--- name: resume-bullet-writer description: Transform weak resume bullets into achievement-focused statements with metrics and impact ---- name:技能唯一标识,通常与文件夹名一致;
- description:一句话说明技能做什么,AI 靠它判断"这个任务该不该用我"。
第二部分:触发条件(When to Use This Skill)
这是技能最关键的章节——告诉 AI什么时候激活自己。优秀技能会列出三类触发信号:
- 用户明确诉求:如"优化简历的 ATS 兼容性";
- 关键词信号:如用户提到 "ATS"、"没有面试回复"、"optimize resume";
- 上下文信号:如"用户上传了简历文件并提到正在投简历"。
参考 skills/resume-ats-optimizer/SKILL.md 的写法,把触发条件写得越具体,AI 的技能调度越精准。
第三部分:核心能力(Core Capabilities)
用简短的要点列表说明技能能做什么,例如"解析简历并测试 ATS 兼容性"、"计算简历与岗位的匹配分数"等。这是给 AI 的能力边界说明书。
技能正文怎么写?六大内容模块
除开头三段外,ResumeSkills 的官方贡献规范(见 CONTRIBUTING.md)要求正文尽量覆盖以下模块:
| 模块 | 作用 | 示例 |
|---|---|---|
| 背景与问题(Overview & Context) | 说明为什么要用这个技能 | "75% 的简历在人类看到前就被 ATS 拒绝" |
| 框架与方法(Frameworks) | 提供可复用的方法论 | X-Y-Z 公式、STAR 法则 |
| 分步流程(Step-by-step Process) | 指导 AI 按序执行 | "第 1 步:提取岗位关键词" |
| 输出要求(Output Format) | 规范交付物格式 | 匹配度评分报告模板 |
| 前后对比示例(Before/After) | 让效果一目了然 | 弱描述 → 带指标的成就句 |
| 检查清单(Checklist) | 收尾自检 | ATS 兼容性检查表 |
一个高质量技能通常 200~400 行,ResumeSkills 全部 20 个技能合计约 7000 行,平均每个技能 300 多行,信息密度很高。
从零编写自己的技能:完整步骤
步骤 1:确定技能边界
一个好技能只解决一类问题。参考 CONTRIBUTING.md 中欢迎的新技能方向:行业专属简历(医疗、法律、公益)、特定职能(销售、工程细分)、跨国求职等。
步骤 2:创建文件夹与文件
在 skills/ 目录下新建your-skill-name/SKILL.md,命名用短横线小写风格,如healthcare-resume-optimizer。
步骤 3:按标准模板填充内容
CONTRIBUTING.md 中给出了官方推荐的结构:
# Skill Name ## When to Use This Skill [触发条件:用户提到 X 关键词时使用] ## Core Capabilities [技能能力要点列表] ## [主体内容章节] - 背景与上下文 - 框架与方法 - 分步流程 - 输出格式要求 - 前后对比示例 - 边界情况与特殊情况 - 实施检查清单步骤 4:质量自检
对照项目官方的 Do / Don't 清单(CONTRIBUTING.md):
- ✅ 指令具体、可执行,附带真实案例
- ✅ 有前后对比、检查清单和框架
- ✅ 用真实简历测试过效果
- ❌ 避免模糊笼统的表述
- ❌ 不引用版权内容、不写过时做法
步骤 5:安装并测试
# 方式一:通过 skills 命令安装(全局可用) npx skills add Paramchoudhary/ResumeSkills -g -y # 方式二:手动放入技能目录 git clone https://gitcode.com/gh_mirrors/re/ResumeSkills mkdir -p ~/.cursor/skills cp -r ResumeSkills/skills/* ~/.cursor/skills/安装后直接用自然语言验证:"优化我的简历 ATS 兼容性",观察 AI 是否按你写的流程执行。
想贡献新技能?提交流程一览
- 先提 Issue 讨论想法,听取维护者反馈;
- Fork 仓库,按 CONTRIBUTING.md 的格式规范编写;
- 用真实场景充分测试;
- 提交 PR,标题清晰(如 "Add healthcare-resume-optimizer skill"),并在描述中说明做了什么、为什么、如何测试的。
小改动(错别字、措辞优化)可以直接 Fork 后提 PR。
总结
为 Claude Code 编写 AI 技能并不神秘,核心就三件事:YAML 前置信息定义身份、触发条件定义时机、结构化正文定义方法。ResumeSkills 的 skills/ 目录是最好的实战教材——挑一个最贴近你需求技能的 SKILL.md 精读一遍,你就已经掌握了一半的写法。祝你写出第一个被 AI 精准调用的技能!🚀
【免费下载链接】ResumeSkillsA collection of AI agent skills focused on resume optimization, job applications, and career development. Built for job seekers, career changers, and professionals who want Claude Code to help with resume writing, ATS optimization, interview prep, and strategic job search.项目地址: https://gitcode.com/gh_mirrors/re/ResumeSkills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考