Skip to content
Back to search

ats-resume-tailor

SkillWorks with Claude CodeGitHub

Agent Skill: generate ATS-friendly CVs tailored to a job posting from a living career profile, with claim verification and no fabrication.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ludodelot--ats-resume-tailor/badge.svg)](/listings/ludodelot--ats-resume-tailor)

HTML

<a href="/listings/ludodelot--ats-resume-tailor"><img src="/api/listings/ludodelot--ats-resume-tailor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code (personal skill):

git clone https://github.com/ludodelot/ats-resume-tailor ~/.claude/skills/ats-resume-tailor

Other agents: copy the folder to your agent's skills location, or reference `SKILL.md` from `AGENTS.md`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 8 lines
  1. {
  2. "name": "ats-resume-tailor",
  3. "version": "0.2.0",
  4. "description": "Agent Skill: generate ATS-friendly CVs tailored to a job posting from a living career profile, with claim verification and no fabrication.",
  5. "author": { "name": "Ludovic Delot", "url": "https://github.com/ludodelot" },
  6. "license": "MIT",
  7. "keywords": ["ats", "resume", "cv", "job-application", "agent-skill", "claude-code", "career"]
  8. }
README.md · README · 135 lines
  1. <div align="center">
  2. <img src="assets/banner.svg" alt="ATS Resume Tailor: tailored CVs from your real experience, no fabrication" width="100%">
  3. # ATS Resume Tailor
  4. **Generate ATS-friendly CVs and resumes tailored to each job posting, from your real career profile. Every claim verified. No fabrication, no keyword tricks.**
  5. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  6. [![Agent Skill](https://img.shields.io/badge/Agent%20Skill-SKILL.md-3DDC97)](SKILL.md)
  7. [![Python 3](https://img.shields.io/badge/python-3.9%2B-3776AB?logo=python&logoColor=white)](scripts)
  8. [![Zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](scripts)
  9. [![CI](https://github.com/ludodelot/ats-resume-tailor/actions/workflows/ci.yml/badge.svg)](https://github.com/ludodelot/ats-resume-tailor/actions)
  10. [![Local only](https://img.shields.io/badge/privacy-local%20only-success)](#privacy)
  11. [![Claims verified](https://img.shields.io/badge/claims-verified-3DDC97)](#how-it-works)
  12. [Install](#install) · [How it works](#how-it-works) · [Quick start](#quick-start) · [Scripts](#scripts) · [FAQ](#faq)
  13. </div>
  14. ---
  15. Generic CVs miss keywords. Generic AI CVs invent things. **ATS Resume Tailor** is an [Agent Skill](https://docs.claude.com) for Claude Code, Codex and Cursor that keeps one private **master career profile** of everything you have really done. For each job it selects, rewrites and scores only what is true, and refuses to add what is not.
  16. ## Features
  17. - **Living career profile.** Grows from old CVs (PDF/DOCX), GitHub repos, LinkedIn export and performance reviews.
  18. - **Job analysis.** Extracts required vs preferred keywords from a job description.
  19. - **Transparent match score.** A documented rubric with matched terms and honest gaps, before and after tailoring.
  20. - **Claim verification.** Every bullet points to an accomplishment id. Numbers, skills, titles, companies and dates are checked against your profile. Any mismatch fails the build.
  21. - **ATS-safe output.** Single column, standard headings, real text. HTML, Markdown and PDF.
  22. - **Format checker.** Flags missing contact info, non-standard headings, multi-column layouts, decorative glyphs and page count.
  23. - **Region presets.** US/UK, EU, DACH and LatAm conventions for photo and personal data.
  24. - **Word and JSON Resume export.** A dependency-free `.docx` writer and a JSON Resume converter.
  25. - **Skills taxonomy.** Aliases (JS = JavaScript, K8s = Kubernetes, PostgreSQL under SQL) so synonyms count as matches. Extend `references/skills_taxonomy.json`.
  26. - **Profile merge.** New CVs or repos add evidence without duplicating it, and conflicts are flagged, never overwritten.
  27. - **Application log.** Which evidence went into which application.
  28. ## How it works
  29. <img src="assets/pipeline.svg" alt="Sources feed profile.json. A job posting is scored against it. The agent drafts cv.json, validate_claims.py rejects mismatches and sends the draft back, verified drafts are rendered to HTML, Markdown, PDF or DOCX and format-checked." width="100%">
  30. The gate is the point. Each bullet cites an accomplishment id, and the validator compares numbers, skills, titles, companies and dates with your profile:
  31. <img src="assets/evidence-trace.svg" alt="A bullet citing acc-acme-1 passes because 35% and 12 exist in the evidence. A bullet claiming a team of 20 has no source and is blocked with exit code 1." width="100%">
  32. ## Install
  33. Claude Code (personal skill):
  34. ```bash
  35. git clone https://github.com/ludodelot/ats-resume-tailor ~/.claude/skills/ats-resume-tailor
  36. ```
  37. Other agents: copy the folder to your agent's skills location, or reference `SKILL.md` from `AGENTS.md`.
  38. ## Quick start
  39. With your agent: *"Use ats-resume-tailor. Build my profile from `~/old_cv.pdf` and my GitHub `<user>`, then tailor a CV for this job: `<paste the posting>`."*
  40. Try the scripts on the bundled fake data:
  41. ```bash
  42. python3 scripts/extract_keywords.py examples/job.example.txt --profile examples/profile.example.json > /tmp/kw.json
  43. python3 scripts/score_match.py /tmp/kw.json examples/profile.example.json --cv examples/cv.example.json
  44. python3 scripts/validate_claims.py examples/cv.example.json examples/profile.example.json
  45. python3 scripts/render_cv.py examples/cv.example.json --out /tmp/cv --region us
  46. python3 scripts/check_ats_format.py /tmp/cv/cv.pdf
  47. ```
  48. ## The honesty guarantee
  49. | The skill will | The skill will never |
  50. |---|---|
  51. | Reword true experience with the job's own terminology | Invent skills, tools, numbers, titles or employers |
  52. | Reorder and select your most relevant evidence | Hide white text or stuff keywords |
  53. | Report gaps and ask if you really have the skill | Add a requirement just because the posting lists it |
  54. | Trace every bullet to a profile source | Send your profile anywhere |
  55. ## Scripts
  56. Python 3, standard library. Optional tools in the last column.
  57. | Script | Purpose | Optional |
  58. |---|---|---|
  59. | [`ingest_sources.py`](scripts/ingest_sources.py) | PDF, DOCX, GitHub, LinkedIn to readable sources | `pdftotext` or `pypdf`, `python-docx` |
  60. | [`extract_keywords.py`](scripts/extract_keywords.py) | Required and preferred keywords from a posting | |
  61. | [`score_match.py`](scripts/score_match.py) | Transparent match score and gaps | |
  62. | [`validate_claims.py`](scripts/validate_claims.py) | Verify every bullet against the profile | |
  63. | [`render_cv.py`](scripts/render_cv.py) | HTML, Markdown, PDF | `weasyprint` or Chrome |
  64. | [`export_docx.py`](scripts/export_docx.py) | ATS-safe Word file, no dependencies | |
  65. | [`export_jsonresume.py`](scripts/export_jsonresume.py) | Convert to the JSON Resume schema | |
  66. | [`merge_profile.py`](scripts/merge_profile.py) | Merge new evidence without duplicates, flag conflicts | |
  67. | [`log_application.py`](scripts/log_application.py) | Log each application and the evidence it used | |
  68. | [`check_ats_format.py`](scripts/check_ats_format.py) | Heuristic ATS parseability check | `pdftotext` or `pypdf` |
  69. ## Repository layout
  70. ```
  71. SKILL.md agent instructions (the skill)
  72. scripts/ deterministic steps
  73. references/ ATS facts vs myths, schemas, scoring, bullet writing, region rules
  74. examples/ fake profile, job posting and CV
  75. evals/ test cases
  76. tests/ unit tests (stdlib unittest)
  77. assets/ banner and social preview
  78. ```
  79. ## Privacy
  80. `profile/`, `jobs/` and `out/` are git-ignored. Nothing leaves your machine, except the GitHub username you choose to ingest, which is sent to the public GitHub API. Job postings and PDFs are treated as data, never as instructions.
  81. ## FAQ
  82. **Does it guarantee I pass an ATS?** No tool can. Real ATS scoring is proprietary. The match score is a proxy, and [`references/ats-facts.md`](references/ats-facts.md) separates evidence from myth.
  83. **PDF or DOCX?** Both parse fine when they contain real text, and the skill exports both. Avoid scanned images, columns, tables, text boxes and header/footer contact info.
  84. **Can it write cover letters?** No. This skill is focused on CVs.
  85. **What if the job needs a skill I don't have?** It reports the gap and asks whether you actually have it. It does not add it on its own.
  86. **Which regions are supported?** Presets for US/UK, EU, DACH and LatAm, documented in [`references/region-rules.md`](references/region-rules.md). Confirm local norms for your target country.
  87. ## Related topics
  88. ATS resume optimizer, tailored CV generator, AI resume builder, applicant tracking system, job description keyword extraction, resume keyword matching, JSON Resume, resume parser check, Claude Code skills, career profile.
  89. ## Contributing
  90. Issues and pull requests are welcome: new region presets, ESCO/O*NET skill mapping, a DOCX renderer, more parser tests.
  91. ## License
  92. [MIT](LICENSE) © Ludovic Delot

Version history

  • v0.2.011/21/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.