borghei/Claude-Skills / personal-productivity/resume-tailor
resume-tailor
VerifiedTailor a resume to a job description by extracting keywords, scoring match, and rewriting bullets for impact. Use when applying to a role, optimizing for ATS keyword match, or customizing a cover letter.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.2 KB |
| assets/tailored_resume_template.md | markdown | 2.3 KB |
| references/ats_optimization_guide.md | markdown | 4.0 KB |
| references/bullet_rewrite_patterns.md | markdown | 3.5 KB |
| scripts/resume_matcher.py | script | 5.7 KB |
SKILL.md
View on GitHub---
name: resume-tailor
description: >
Tailor a resume to a job description by extracting keywords, scoring match,
and rewriting bullets for impact. Use when applying to a role, optimizing
for ATS keyword match, or customizing a cover letter.
license: MIT + Commons Clause
metadata:
version: 1.0.0
author: borghei
category: personal-productivity
domain: career
updated: 2026-05-04
python-tools: resume_matcher.py
tech-stack: ATS, job-search
tags:
- resume
- job-search
- ats
- keywords
- career
---
# Resume Tailor
Tailor a base resume to a specific job description with keyword-match scoring, gap analysis, and rewritten-bullet suggestions.
---
## Table of Contents
- [Keywords](#keywords)
- [Quick Start](#quick-start)
- [Core Workflows](#core-workflows)
- [Tools](#tools)
- [Reference Guides](#reference-guides)
- [Templates](#templates)
- [Best Practices](#best-practices)
- [Scope & Limitations](#scope--limitations)
---
## Keywords
resume, CV, job application, ATS, applicant tracking system, keyword match, resume tailoring, cover letter, job description, hiring, recruiter, career, job search, bullet rewrite, accomplishment, impact statement
---
## Clarify First
Before tailoring the resume, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.
- **Target job description:** the verbatim JD; it drives keyword extraction and the entire match score.
- **Base resume content:** your actual experience and bullets; without it there is nothing to score or rewrite.
- **Target seniority / title:** IC vs lead vs exec sets which keywords matter and the altitude of rewritten bullets.
- **Truth boundary:** which listed skills you genuinely have vs. aspirational, so additions are honest rather than keyword-stuffed.
Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.
---
## Quick Start
### Tailor a Resume in 5 Minutes
1. Save the job description as `jd.txt`
2. Save your base resume text as `resume.txt`
3. Run the matcher:
```bash
python scripts/resume_matcher.py resume.txt jd.txt
```
4. Review the keyword-gap report
5. Rewrite low-scoring bullets using `references/bullet_rewrite_patterns.md`
6. Cross-check the final resume against the rewritten template in `assets/tailored_resume_template.md`
---
## Core Workflows
### Workflow 1: Match Score and Keyword Gap
**Goal:** Get a quantitative score for how well the current resume matches a target job description before submitting.
**Steps:**
1. Capture the job description verbatim into `jd.txt`
2. Run: `python scripts/resume_matcher.py resume.txt jd.txt`
3. Review the score — anything below 70% means significant gaps
4. Read the missing-keywords list; classify each as (a) skills you have but did not list, (b) skills you do not have, (c) buzzwords that do not apply
5. Add (a) to the resume; ignore (c); be honest about (b)
**Expected Output:** A score, a kept-keyword list, and a missing-keyword list.
**Time Estimate:** 5-10 minutes per job description.
### Workflow 2: Bullet Rewrite for Impact
**Goal:** Convert task-oriented bullets ("responsible for…") into impact bullets that match recruiter and ATS expectations.
**Steps:**
1. Identify weak bullets — anything starting with "Responsible for" or "Helped with"
2. Apply the **CAR pattern** (Challenge, Action, Result) from `references/bullet_rewrite_patterns.md`
3. Quantify wherever possible (percentages, dollar amounts, time saved, scale)
4. Re-run the matcher to confirm score improvement
**Expected Output:** Bullet list rewritten in CAR format with metrics.
**Time Estimate:** 5 minutes per bullet.
### Workflow 3: Cover Letter Hooks
**Goal:** Pull the strongest 3-5 hooks from the resume that map directly to the top requirements in the job description.
**Steps:**
1. Run matcher in JSON mode: `python scripts/resume_matcher.py resume.txt jd.txt --json`
2. Take the top 5 matched keywords by relevance
3. For each, find the matching resume bullet
4. Use them as evidence sentences in the cover letter
**Expected Output:** 3-5 evidence sentences for the cover letter.
**Time Estimate:** 10 minutes.
---
## Tools
### resume_matcher.py
Reads a resume text file and a job description text file, returns:
- A **match score** (0-100) based on keyword overlap weighted by JD frequency
- A **kept keywords** list (in both resume and JD)
- A **missing keywords** list (in JD only)
- A **resume-only keywords** list (in resume but not JD — candidate to drop)
```bash
# Human-readable
python scripts/resume_matcher.py resume.txt jd.txt
# JSON for programmatic use
python scripts/resume_matcher.py resume.txt jd.txt --json
```
---
## Reference Guides
- **`references/bullet_rewrite_patterns.md`** — CAR pattern, action-verb library, quantification examples, weak-phrase blacklist
- **`references/ats_optimization_guide.md`** — How ATS parses resumes, formatting do's and don'ts, keyword density bounds
---
## Templates
- **`assets/tailored_resume_template.md`** — A bare resume skeleton with section ordering, length guidance, and keyword-placement notes. Fill in your content.
---
## Best Practices
- **Tailor every time.** A generic resume sent to ten roles performs worse than ten tailored versions.
- **Honesty over keyword stuffing.** Add only skills you actually have. Hiring managers can tell.
- **Keep one master resume.** Tailor variants from a single source of truth.
- **Two pages max.** Even for senior roles, two pages is the ceiling outside academia.
- **Plain text, single-column.** ATS systems still mishandle tables, graphics, and multi-column layouts.
---
## Scope & Limitations
**In Scope:**
- Keyword match scoring of a resume against a job description, weighted by JD frequency, with kept, missing and resume-only keyword lists (`resume_matcher.py`).
- Bullet rewrites with the CAR pattern, an action-verb library and a weak-phrase list in `references/bullet_rewrite_patterns.md`.
- ATS formatting guidance in `references/ats_optimization_guide.md` and a resume skeleton in `assets/tailored_resume_template.md`.
- Cover letter evidence sentences drawn from matched keywords.
**Out of Scope:**
- Parsing PDF or DOCX resumes. Both inputs are plain text files.
- Interview preparation (see `project-management/career/pm-interview-prep/` for product management roles).
- LinkedIn profile work (see `tools/linkedin/linkedin-profile-optimizer/`).
- Hiring-side screening and job description writing (see `hr-operations/talent-acquisition/`).
**Important Caveats:**
- The match score is keyword overlap. It does not reproduce any specific ATS, and real systems parse and weight fields differently.
- Synonyms and different phrasing count as misses, so the missing-keyword list needs human review.
- A higher score is not a better resume. Adding skills the candidate does not have raises the score and misrepresents the candidate.
---
## Integration Points
- Pairs with `personal-productivity/lead-researcher/` for prepping informational interviews
- Pairs with `marketing/copywriting/` for cover letter prose quality
- Used by `agents/personas/` workflows when authoring sample profiles
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |