MCPInstall

resume-ats-optimizer

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

Installs
14K
Last 24h
+97
Trending rank
#2032
Security
Warn

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/paramchoudhary/resumeskills --skill resume-ats-optimizer
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads resume-ats-optimizer automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files.

Gen Agent Trust Hub PassSAFE ·The skill provides comprehensive instructions for optimizing resumes for Applicant Tracking Systems (ATS). It focuses on formatting, keyword optimization, and section headers to improve resume parsing and matching scores. No security risks or malicious patterns were detected.
Socket PassNo alerts
Snyk PassLOW ·Risk: LOW · No issues
Runlayer WarnMEDIUM ·1/1 file flagged
ZeroLeaks PassNONE ·Score: 93/100 · 2 sections analyzed

SKILL.md

The instructions your agent reads when the skill is triggered.

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@example.com | (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

FAQ

What does the resume-ats-optimizer skill do?

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

How do I install resume-ats-optimizer?

Run npx skills add https://github.com/paramchoudhary/resumeskills --skill resume-ats-optimizer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/resume-ats-optimizer/ (personal) or .claude/skills/resume-ats-optimizer/ (project).

Which AI agents can use resume-ats-optimizer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is resume-ats-optimizer safe to install?

Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk passed; Runlayer flagged items to review; ZeroLeaks passed. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains resume-ats-optimizer?

It is published by paramchoudhary in paramchoudhary/resumeskills. It has 14,028 recorded installs.

More from paramchoudhary/resumeskills

View all →

linkedin-profile-optimizer

paramchoudhary/resumeskills

Optimize LinkedIn profile for searchability, recruiter visibility, and engagement

Marketing & SEO12.1K installs

resume-bullet-writer

paramchoudhary/resumeskills

Transform weak resume bullets into achievement-focused statements with metrics and impact

Docs & Writing12K installs

resume-tailor

paramchoudhary/resumeskills

Customize resume for specific job postings while maintaining truthfulness

11.1K installs

tech-resume-optimizer

paramchoudhary/resumeskills

Optimize resumes for software engineering, PM, and technical roles

11K installs

job-description-analyzer

paramchoudhary/resumeskills

Analyze job postings, calculate match scores, identify gaps, and create application strategy

10.8K installs

resume-formatter

paramchoudhary/resumeskills

Ensure ATS-friendly formatting and create clean scannable layouts

10.4K installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs