mcpField
R
resume-ats-optimizer

resume-ats-optimizer

github.com/chasen-liaoDocuments38133 installsUpdated 3w ago
Repository

About resume-ats-optimizer

An ATS resume audit skill that reports parsing risks and, when a job description is available, keyword coverage and factual gaps. It acts as a quality gate after resume generation, separating presentation fixes from issues that require candidate confirmation without silently changing claims.

Key features

  1. 01Resume format and text extraction checks
  2. 02HTML and PDF parsing risk review
  3. 03Job-description keyword coverage report
  4. 04Presentation fixes separated from fact gaps
  5. 05Optional validation scripts

Use cases

  1. 01Checking a resume before submitting an application
  2. 02Comparing resume evidence with job-description keywords
  3. 03Reviewing parsing risks before exporting ATS-safe files

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/chasen-liao/resume-skills --skill resume-ats-optimizer

After installing, type/resume-ats-optimizerin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

ATS 简历审计器

将“更容易被解析”的建议与“保证通过筛选”明确区分,并保持候选人事实不变。

先读

读取 简历事实契约 与 写作规范中的 ATS 输出规则。若当前环境是源码仓库或已安装完整 npm 包 @chasen-liao/resume-skills,可用包内脚本自动检查:

python skills/resume-builder/scripts/validate_resume.py --html <resume.html> --mode ats
python skills/resume-builder/scripts/validate_resume.py --pdf <resume.pdf>

以上脚本随 npm 包发布(skills/resume-builder/scripts/)。在包目录下运行时用 node_modules/@chasen-liao/resume-skills/ 前缀替换 skills/;通过 npx skills add 仅安装 SKILL.md 的环境没有这些脚本,此时按下方工作流做结构化检查即可,不要把脚本路径当作必需步骤。

协作入口

这是母版生成后和 JD 定制版生成后的质量关卡。默认检查并报告解析风险与关键词/事实缺口,但不静默修改简历;用户确认后,才将呈现修复交回 resume-builder 或 jd-tailorer。

没有 JD 时只检查可解析性和结构;有 JD 时把“可直接改善的呈现问题”与“必须保留的真实能力缺口”分开报告。它不替代 JD 分析,也不决定是否投递。

工作流

  1. 检查输入格式、是否存在可提取文本、标准章节标题和正文阅读顺序。
  2. 对 HTML 检查图像承载文字、表格、复杂定位、页眉页脚、不可复制文本等风险;对 PDF 检查页数与文本提取。
  3. 从 JD 分析中读取关键词,按“已确认候选人事实中的精确匹配 / 相关表达 / 缺失”报告覆盖情况。
  4. 给出两类建议:呈现修复(可直接做)与事实缺口(只能追问或保留缺口)。
  5. 需要导出时,以同一事实源生成单栏、标准标题、普通文本的 ATS-safe HTML/PDF;不为提高匹配率增加技能。

输出格式

# ATS 审计报告
## 解析与格式
- 通过:…
- 风险:…
## 关键词覆盖
| 关键词 | JD 来源 | 简历证据 | 状态 |
## 建议
1. 可直接修复:…
2. 需要候选人确认:…

约束

  • “ATS-safe”表示降低已知解析风险,不代表任何具体系统一定读取正确。
  • 不使用图片、图表或视觉布局承载关键信息;不改变 claim 内容与证据状态。
  • 不以关键词堆砌替代可读的自然表达。

Comments

Markdown supported