Resume ats optimizer

Optimize resumes for Applicant Tracking Systems, check ATS compatibility, and analyze keyword match

How to use it

  1. Hit Copy SKILL.md — or use the Claude Code line below to get every file.
  2. Claude: ⋯ → Download .md, then Customize → Skills → Add → Upload skill.
    ChatGPT: make a Project and paste it into Instructions.
    Neither? Paste it at the top of a new chat — it works for that chat.
  3. Describe your job in plain words. The AI follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit Paramchoudhary/ResumeSkills/skills/resume-ats-optimizer#main ~/.claude/skills/resume-ats-optimizer

For one project only, change the path to .claude/skills/resume-ats-optimizer. This skill also uses Node.js — copying SKILL.md alone won't be enough. See the folder on GitHub.

Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Show the full text320 lines
resume-ats-optimizer/SKILL.md320 lines9.0 KBpushed 189d agoRawView on GitHub

Resume ATS Optimizer

When to Use This Skill

Use this skill when the user wants to:

  • Optimize their resume for Applicant Tracking Systems (ATS)
  • Check if their resume will pass automated screening
  • Understand why their applications aren't getting responses
  • Mentions keywords like: "ATS", "not getting interviews", "resume not working", "optimize resume", "keyword optimization"

Also use when the user provides a resume file and mentions they're applying to jobs.

Core Capabilities

  • Parse resume and test ATS compatibility
  • Extract and analyze keywords against job descriptions
  • Identify formatting issues that break ATS parsers
  • Calculate match scores between resume and job postings
  • Suggest keyword additions and placements
  • Generate ATS-friendly formatting recommendations

The ATS Problem

75% of resumes are rejected by Applicant Tracking Systems before a human ever sees them. Companies use ATS to:

  • Filter out unqualified candidates automatically
  • Search for specific keywords from job requirements
  • Parse resumes into structured data
  • Rank candidates by keyword match percentage

Common reasons resumes fail ATS:

  1. Poor formatting (tables, columns, headers/footers)
  2. Missing keywords from job description
  3. Inconsistent section headers
  4. Non-standard fonts or special characters
  5. Text embedded in images
  6. Incorrect file format

ATS Compatibility Checklist

File Format

  • ✅ Use .docx or .pdf (not .pages, .odt)
  • ✅ PDF must be text-based, not scanned image
  • ✅ File name: "FirstName_LastName_Resume.pdf"

Font & Formatting

  • ✅ Standard fonts: Arial, Calibri, Georgia, Times New Roman
  • ✅ Font size: 10-12pt for body, 14-16pt for headers
  • ✅ No text boxes, tables, or columns
  • ✅ No headers/footers (put contact info in body)
  • ✅ No images, graphics, or charts
  • ✅ Consistent date formats (MM/YYYY)
  • ✅ Standard bullet points (•, -, *)

Section Headers

Use standard, recognizable headers:

  • ✅ "Professional Experience" or "Work Experience" (not "Where I've Been")
  • ✅ "Education" (not "Academic Background")
  • ✅ "Skills" (not "Core Competencies")
  • ✅ "Summary" or "Professional Summary"

Contact Information

John Smith
[email protected] | (555) 123-4567 | LinkedIn: linkedin.com/in/johnsmith
San Francisco, CA

NOT in header/footer, and avoid:

  • ❌ Tables for contact info
  • ❌ Special characters in email
  • ❌ Multiple phone numbers
  • ❌ Full mailing address (city/state is enough)

Keyword Optimization Process

Step 1: Extract Job Description Keywords

Identify three types of keywords:

Hard Skills (Technical)

  • Programming languages (Python, Java, SQL)
  • Tools and platforms (Salesforce, AWS, Excel)
  • Certifications (PMP, CPA, CFA)
  • Methodologies (Agile, Six Sigma, SDLC)

Soft Skills

  • Leadership, collaboration, communication
  • Problem-solving, analytical thinking
  • Project management, stakeholder management

Industry Terms

  • B2B, SaaS, e-commerce
  • Enterprise, SMB, mid-market
  • ARR, MRR, churn rate

Step 2: Match Analysis

For each keyword in job description:

  1. Check if exact phrase appears in resume
  2. Check for synonyms or variations
  3. Count frequency of mention
  4. Note location (summary, experience, skills)

Step 3: Calculate Match Score

Match Score = (Keywords Matched / Total Required Keywords) × 100

Example:
Job has 20 required keywords
Your resume has 15 of them
Match Score = 75%

Target: 80%+ for strong match

Step 4: Keyword Placement Strategy

Priority 1: Professional Summary (Top of Resume)

  • Include 5-8 most important keywords
  • Use naturally in 3-4 sentence paragraph
  • Example: "Data Scientist with 5+ years using Python, SQL, and machine learning to drive business insights..."

Priority 2: Skills Section

  • List keywords explicitly
  • Group by category if needed
  • Use exact phrasing from job description

Priority 3: Experience Bullets

  • Incorporate keywords into achievement statements
  • Don't force keywords unnaturally
  • Use variations throughout

Keyword Density Guidelines:

  • Critical keywords: Appear 2-4 times throughout resume
  • Important keywords: Appear 1-2 times
  • Don't keyword stuff - keep it natural
  • Vary phrasing (e.g., "led team" and "team leadership")

Analysis Output Format

When analyzing a resume, provide this structured report:

# ATS COMPATIBILITY REPORT

## Overall Score: [X]/100

### File Format Check ✅/❌
- Format: [DOCX/PDF]
- Text extraction: [Success/Failed]
- File size: [X KB/MB]

### Formatting Issues
✅ No tables or columns detected
❌ Contact info in header (move to body)
⚠️  Two different font sizes in skills section

### Keyword Analysis

JOB REQUIREMENTS vs YOUR RESUME:

**Critical Keywords (Must Have):**
✅ Project Management - Found 3x
✅ Agile/Scrum - Found 2x
❌ Stakeholder Management - MISSING (mentioned 5x in JD)
❌ Budget Management - MISSING (mentioned 3x in JD)

**Important Keywords:**
✅ Cross-functional teams - Found 1x
⚠️  "Risk management" - You have "risk mitigation" (close but not exact match)
✅ Process improvement - Found 2x

**Match Score: 65%**
Target: 80%+ recommended

### Recommended Changes

**1. Add Missing Keywords:**

In Professional Summary, change:
"Experienced project manager with proven track record..."

To:
"Experienced project manager with proven track record in stakeholder management and budget oversight..."

In Experience section, add bullet:
"Managed stakeholder communication across 3 departments and executive leadership team"
"Directed budget management for $2.5M project portfolio"

**2. Fix Formatting:**
- Move contact information from header to body of resume
- Make all skill section items same font size (currently 10pt and 11pt mixed)

**3. Strengthen Existing Keywords:**
Change "risk mitigation" to "risk management" for exact match

### Estimated New Match Score: 85%

Common ATS Failure Patterns

Pattern 1: Creative Formatting

❌ PROBLEM:
[Two-column layout with graphics]
[Skill bars and proficiency charts]
[Text in colored boxes]

✅ SOLUTION:
- Single column layout
- Text-only skills list
- Simple bullet points

Pattern 2: Unconventional Section Names

❌ PROBLEM:
"My Journey" (instead of Experience)
"What I Bring to the Table" (instead of Skills)
"Academic Pursuits" (instead of Education)

✅ SOLUTION:
Use standard headers ATS recognizes

Pattern 3: Missing Keywords

❌ PROBLEM:
Job requires: "Python, SQL, Data Visualization"
Resume says: "Programming, databases, making charts"

✅ SOLUTION:
Use exact terminology from job description

Pattern 4: Keyword Stuffing

❌ PROBLEM:
Skills: Python, Python programming, Python developer, Python expert, Python specialist, Advanced Python...

✅ SOLUTION:
Skills: Python, SQL, JavaScript, React, Node.js
(Then incorporate naturally in bullets)

Industry-Specific Considerations

Tech Resumes

  • Emphasize programming languages and frameworks
  • Include GitHub, portfolio links in Skills section (not header)
  • Certifications and courses matter highly

Business/Finance

  • Focus on software proficiency (Excel, SAP, Salesforce)
  • Certifications critical (CPA, CFA, PMP)
  • Industry keywords (P&L, ROI, KPI)

Healthcare

  • Licenses and certifications required
  • Specific systems (Epic, Cerner, MEDITECH)
  • Compliance keywords (HIPAA, Joint Commission)

Marketing

  • Platform expertise (HubSpot, Salesforce, Google Analytics)
  • Channel keywords (SEO, PPC, email marketing)
  • Metrics and results-driven language

Edge Cases & Special Situations

Career Changers

  • Focus on transferable skills
  • Use keywords from TARGET industry, not just current
  • May need two resume versions for ATS

Recent Graduates

  • Education section becomes priority for keywords
  • Include relevant coursework, projects
  • Internships count as experience - use those keywords

Executive Level

  • ATS still matters for senior roles
  • Focus on strategic keywords
  • Include board experience, P&L size, team size

Gaps in Employment

  • Use years only (not months) if it helps
  • Include freelance/consulting with keywords
  • Volunteer work can include relevant keywords

Implementation Checklist

When helping user optimize for ATS:

  1. ✅ Scan current resume for ATS compatibility issues
  2. ✅ Analyze job description for required keywords
  3. ✅ Calculate current match score
  4. ✅ Identify specific missing keywords
  5. ✅ Suggest exact placements for new keywords
  6. ✅ Flag formatting problems
  7. ✅ Provide before/after examples
  8. ✅ Re-score after suggested changes
  9. ✅ Verify file format and naming
  10. ✅ Test with ATS simulator if possible

Success Metrics

After optimization, the resume should:

  • Score 80%+ match for target job descriptions
  • Pass ATS parsing test (all sections recognized)
  • Have zero formatting errors
  • Include all critical keywords 2-4x each
  • Read naturally (not keyword-stuffed)
  • Be ready to submit immediately
1---
2name: resume-ats-optimizer
3description: Optimize resumes for Applicant Tracking Systems, check ATS compatibility, and analyze keyword match
4---
5 
6# Resume ATS Optimizer
7 
8## When to Use This Skill
9 
10Use this skill when the user wants to:
11- Optimize their resume for Applicant Tracking Systems (ATS)
12- Check if their resume will pass automated screening
13- Understand why their applications aren't getting responses
14- Mentions keywords like: "ATS", "not getting interviews", "resume not working", "optimize resume", "keyword optimization"
15 
16Also use when the user provides a resume file and mentions they're applying to jobs.
17 
18## Core Capabilities
19 
20- Parse resume and test ATS compatibility
21- Extract and analyze keywords against job descriptions
22- Identify formatting issues that break ATS parsers
23- Calculate match scores between resume and job postings
24- Suggest keyword additions and placements
25- Generate ATS-friendly formatting recommendations
26 
27## The ATS Problem
28 
2975% of resumes are rejected by Applicant Tracking Systems before a human ever sees them. Companies use ATS to:
30- Filter out unqualified candidates automatically
31- Search for specific keywords from job requirements
32- Parse resumes into structured data
33- Rank candidates by keyword match percentage
34 
35Common reasons resumes fail ATS:
361. Poor formatting (tables, columns, headers/footers)
372. Missing keywords from job description
383. Inconsistent section headers
394. Non-standard fonts or special characters
405. Text embedded in images
416. Incorrect file format
42 
43## ATS Compatibility Checklist
44 
45### File Format
46- ✅ Use .docx or .pdf (not .pages, .odt)
47- ✅ PDF must be text-based, not scanned image
48- ✅ File name: "FirstName_LastName_Resume.pdf"
49 
50### Font & Formatting
51- ✅ Standard fonts: Arial, Calibri, Georgia, Times New Roman
52- ✅ Font size: 10-12pt for body, 14-16pt for headers
53- ✅ No text boxes, tables, or columns
54- ✅ No headers/footers (put contact info in body)
55- ✅ No images, graphics, or charts
56- ✅ Consistent date formats (MM/YYYY)
57- ✅ Standard bullet points (•, -, *)
58 
59### Section Headers
60Use standard, recognizable headers:
61- ✅ "Professional Experience" or "Work Experience" (not "Where I've Been")
62- ✅ "Education" (not "Academic Background")
63- ✅ "Skills" (not "Core Competencies")
64- ✅ "Summary" or "Professional Summary"
65 
66### Contact Information
67```
68John Smith
69[email protected] | (555) 123-4567 | LinkedIn: linkedin.com/in/johnsmith
70San Francisco, CA
71```
72 
73NOT in header/footer, and avoid:
74- ❌ Tables for contact info
75- ❌ Special characters in email
76- ❌ Multiple phone numbers
77- ❌ Full mailing address (city/state is enough)
78 
79## Keyword Optimization Process
80 
81### Step 1: Extract Job Description Keywords
82 
83Identify three types of keywords:
84 
85**Hard Skills (Technical)**
86- Programming languages (Python, Java, SQL)
87- Tools and platforms (Salesforce, AWS, Excel)
88- Certifications (PMP, CPA, CFA)
89- Methodologies (Agile, Six Sigma, SDLC)
90 
91**Soft Skills**
92- Leadership, collaboration, communication
93- Problem-solving, analytical thinking
94- Project management, stakeholder management
95 
96**Industry Terms**
97- B2B, SaaS, e-commerce
98- Enterprise, SMB, mid-market
99- ARR, MRR, churn rate
100 
101### Step 2: Match Analysis
102 
103For each keyword in job description:
1041. Check if exact phrase appears in resume
1052. Check for synonyms or variations
1063. Count frequency of mention
1074. Note location (summary, experience, skills)
108 
109### Step 3: Calculate Match Score
110 
111```
112Match Score = (Keywords Matched / Total Required Keywords) × 100
113 
114Example:
115Job has 20 required keywords
116Your resume has 15 of them
117Match Score = 75%
118 
119Target: 80%+ for strong match
120```
121 
122### Step 4: Keyword Placement Strategy
123 
124**Priority 1: Professional Summary (Top of Resume)**
125- Include 5-8 most important keywords
126- Use naturally in 3-4 sentence paragraph
127- Example: "Data Scientist with 5+ years using Python, SQL, and machine learning to drive business insights..."
128 
129**Priority 2: Skills Section**
130- List keywords explicitly
131- Group by category if needed
132- Use exact phrasing from job description
133 
134**Priority 3: Experience Bullets**
135- Incorporate keywords into achievement statements
136- Don't force keywords unnaturally
137- Use variations throughout
138 
139**Keyword Density Guidelines:**
140- Critical keywords: Appear 2-4 times throughout resume
141- Important keywords: Appear 1-2 times
142- Don't keyword stuff - keep it natural
143- Vary phrasing (e.g., "led team" and "team leadership")
144 
145## Analysis Output Format
146 
147When analyzing a resume, provide this structured report:
148 
149```markdown
150# ATS COMPATIBILITY REPORT
151 
152## Overall Score: [X]/100
153 
154### File Format Check ✅/❌
155- Format: [DOCX/PDF]
156- Text extraction: [Success/Failed]
157- File size: [X KB/MB]
158 
159### Formatting Issues
160✅ No tables or columns detected
161❌ Contact info in header (move to body)
162⚠️ Two different font sizes in skills section
163 
164### Keyword Analysis
165 
166JOB REQUIREMENTS vs YOUR RESUME:
167 
168**Critical Keywords (Must Have):**
169✅ Project Management - Found 3x
170✅ Agile/Scrum - Found 2x
171❌ Stakeholder Management - MISSING (mentioned 5x in JD)
172❌ Budget Management - MISSING (mentioned 3x in JD)
173 
174**Important Keywords:**
175✅ Cross-functional teams - Found 1x
176⚠️ "Risk management" - You have "risk mitigation" (close but not exact match)
177✅ Process improvement - Found 2x
178 
179**Match Score: 65%**
180Target: 80%+ recommended
181 
182### Recommended Changes
183 
184**1. Add Missing Keywords:**
185 
186In Professional Summary, change:
187"Experienced project manager with proven track record..."
188 
189To:
190"Experienced project manager with proven track record in stakeholder management and budget oversight..."
191 
192In Experience section, add bullet:
193"Managed stakeholder communication across 3 departments and executive leadership team"
194"Directed budget management for $2.5M project portfolio"
195 
196**2. Fix Formatting:**
197- Move contact information from header to body of resume
198- Make all skill section items same font size (currently 10pt and 11pt mixed)
199 
200**3. Strengthen Existing Keywords:**
201Change "risk mitigation" to "risk management" for exact match
202 
203### Estimated New Match Score: 85%
204```
205 
206## Common ATS Failure Patterns
207 
208### Pattern 1: Creative Formatting
209```
210❌ PROBLEM:
211[Two-column layout with graphics]
212[Skill bars and proficiency charts]
213[Text in colored boxes]
214 
215✅ SOLUTION:
216- Single column layout
217- Text-only skills list
218- Simple bullet points
219```
220 
221### Pattern 2: Unconventional Section Names
222```
223❌ PROBLEM:
224"My Journey" (instead of Experience)
225"What I Bring to the Table" (instead of Skills)
226"Academic Pursuits" (instead of Education)
227 
228✅ SOLUTION:
229Use standard headers ATS recognizes
230```
231 
232### Pattern 3: Missing Keywords
233```
234❌ PROBLEM:
235Job requires: "Python, SQL, Data Visualization"
236Resume says: "Programming, databases, making charts"
237 
238✅ SOLUTION:
239Use exact terminology from job description
240```
241 
242### Pattern 4: Keyword Stuffing
243```
244❌ PROBLEM:
245Skills: Python, Python programming, Python developer, Python expert, Python specialist, Advanced Python...
246 
247✅ SOLUTION:
248Skills: Python, SQL, JavaScript, React, Node.js
249(Then incorporate naturally in bullets)
250```
251 
252## Industry-Specific Considerations
253 
254### Tech Resumes
255- Emphasize programming languages and frameworks
256- Include GitHub, portfolio links in Skills section (not header)
257- Certifications and courses matter highly
258 
259### Business/Finance
260- Focus on software proficiency (Excel, SAP, Salesforce)
261- Certifications critical (CPA, CFA, PMP)
262- Industry keywords (P&L, ROI, KPI)
263 
264### Healthcare
265- Licenses and certifications required
266- Specific systems (Epic, Cerner, MEDITECH)
267- Compliance keywords (HIPAA, Joint Commission)
268 
269### Marketing
270- Platform expertise (HubSpot, Salesforce, Google Analytics)
271- Channel keywords (SEO, PPC, email marketing)
272- Metrics and results-driven language
273 
274## Edge Cases & Special Situations
275 
276### Career Changers
277- Focus on transferable skills
278- Use keywords from TARGET industry, not just current
279- May need two resume versions for ATS
280 
281### Recent Graduates
282- Education section becomes priority for keywords
283- Include relevant coursework, projects
284- Internships count as experience - use those keywords
285 
286### Executive Level
287- ATS still matters for senior roles
288- Focus on strategic keywords
289- Include board experience, P&L size, team size
290 
291### Gaps in Employment
292- Use years only (not months) if it helps
293- Include freelance/consulting with keywords
294- Volunteer work can include relevant keywords
295 
296## Implementation Checklist
297 
298When helping user optimize for ATS:
299 
3001. ✅ Scan current resume for ATS compatibility issues
3012. ✅ Analyze job description for required keywords
3023. ✅ Calculate current match score
3034. ✅ Identify specific missing keywords
3045. ✅ Suggest exact placements for new keywords
3056. ✅ Flag formatting problems
3067. ✅ Provide before/after examples
3078. ✅ Re-score after suggested changes
3089. ✅ Verify file format and naming
30910. ✅ Test with ATS simulator if possible
310 
311## Success Metrics
312 
313After optimization, the resume should:
314- Score 80%+ match for target job descriptions
315- Pass ATS parsing test (all sections recognized)
316- Have zero formatting errors
317- Include all critical keywords 2-4x each
318- Read naturally (not keyword-stuffed)
319- Be ready to submit immediately
320 

Discussion

Alternatives

Also in Job hunting