agentsclimarketplace

Ats resume matcher

Skill stevengonsalvez/ainb-toolkit/skills/ats-resume-matcher

Professional ATS (Applicant Tracking System) resume matching and scoring tool that operates with the precision of enterprise systems like Greenhouse, Lever, Workday, and Breezy HR. Use this skill when: (1) Matching a resume against a job description to calculate fit scores (2) Analyzing resume-JD alignment with detailed category breakdowns (3) Identifying gaps between candidate qualifications and job requirements (4) Getting actionable suggestions to improve resume match percentage (5) Preparing a resume for ATS optimization before job applications Supports PDF, DOCX, Markdown, and plain text inputs for both resumes and job descriptions.From its SKILL.md

Install
npx -y skills add stevengonsalvez/ainb-toolkit --skill ats-resume-matcher

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

11.2 KB, as published. Nobody here has run it

ATS Resume Matcher

Enterprise-grade resume-to-job-description matching with detailed scoring, gap analysis, and optimization suggestions.

Quick Start

When given a resume and job description:

  1. Extract and parse both documents
  2. Run the 7-category ATS analysis
  3. Output the structured match report
  4. Provide prioritized optimization suggestions

Input Handling

Supported Formats

FormatResumeJob Description
PDFYes (extract text)Yes
DOCXYes (extract text)Yes
MarkdownYesYes
Plain textYesYes
Pasted contentYesYes

Extraction Priority

  1. If file path provided → Read and extract text
  2. If pasted content → Parse directly
  3. If URL provided → Fetch and extract

ATS Matching Algorithm

Category Weights (Total: 100%)

CategoryWeightDescription
Hard Skills25%Technical skills, tools, technologies, languages
Experience20%Years of experience, seniority level, scope
Keywords15%Exact phrase matches, industry terminology
Job Titles12%Title alignment, progression, relevance
Soft Skills10%Leadership, communication, collaboration
Education10%Degrees, certifications, training
Industry8%Domain experience, sector knowledge

Scoring Methodology

For each category, calculate:

Category Score = (Matched Items / Required Items) × 100

Weighted Score = Category Score × Category Weight

Overall Match = Σ(All Weighted Scores)

Match Classification

Score RangeClassificationInterpretation
85-100%Excellent MatchStrong candidate, likely to pass ATS
70-84%Good MatchCompetitive candidate, minor gaps
55-69%Moderate MatchSome gaps, optimization recommended
40-54%Weak MatchSignificant gaps, major revision needed
0-39%Poor MatchRole mismatch or major skill gaps

Analysis Process

Step 1: Parse Job Description

Extract from JD:

  • Required skills (must-have)
  • Preferred skills (nice-to-have)
  • Experience requirements (years, level)
  • Education requirements (degree, field)
  • Certifications (required/preferred)
  • Job title keywords
  • Industry/domain terms
  • Soft skill indicators

Classify each requirement as:

  • REQUIRED - Explicitly stated as required/must-have
  • PREFERRED - Stated as preferred/nice-to-have/bonus
  • IMPLIED - Inferred from context

Step 2: Parse Resume

Extract from resume:

  • Technical skills (explicit and demonstrated)
  • Work experience (titles, duration, scope)
  • Education (degrees, institutions, dates)
  • Certifications (names, dates, status)
  • Achievements (quantified results)
  • Industry exposure (domains worked in)
  • Keywords (terminology used)

Step 3: Match Analysis

For each JD requirement, find resume evidence:

EXACT MATCH    → 100% credit (keyword appears exactly)
SYNONYM MATCH  → 85% credit (equivalent term used)
PARTIAL MATCH  → 50% credit (related but not equivalent)
TRANSFERABLE   → 30% credit (skill could apply)
NO MATCH       → 0% credit (not found)

Step 4: Generate Report

See output format below.

Output Format

Generate this exact structure:

# ATS Match Report

## Overall Score: [XX]% - [Classification]

**Resume**: [filename or "Provided content"]
**Position**: [Job title from JD]
**Company**: [Company name if available]
**Analysis Date**: [Current date]

---

## Score Breakdown

| Category | Score | Weight | Weighted | Status |
|----------|-------|--------|----------|--------|
| Hard Skills | XX% | 25% | X.X | [✓/⚠/✗] |
| Experience | XX% | 20% | X.X | [✓/⚠/✗] |
| Keywords | XX% | 15% | X.X | [✓/⚠/✗] |
| Job Titles | XX% | 12% | X.X | [✓/⚠/✗] |
| Soft Skills | XX% | 10% | X.X | [✓/⚠/✗] |
| Education | XX% | 10% | X.X | [✓/⚠/✗] |
| Industry | XX% | 8% | X.X | [✓/⚠/✗] |
| **TOTAL** | | **100%** | **XX.X** | |

Status: ✓ = 70%+, ⚠ = 50-69%, ✗ = <50%

---

## Detailed Analysis

### Hard Skills (XX%)

**Matched (X/Y required)**:
- ✓ [Skill] - Found: "[evidence from resume]"
- ✓ [Skill] - Found: "[evidence from resume]"

**Partial Matches**:
- ⚠ [Required skill] → [Related skill found] (XX% credit)

**Missing**:
- ✗ [Skill] - REQUIRED - Not found
- ✗ [Skill] - PREFERRED - Not found

### Experience (XX%)

**Requirements**:
- Required: [X] years in [domain]
- Found: [Y] years in [domain]
- Match: [Exceeds/Meets/Below] requirement

**Seniority Alignment**:
- Required level: [Senior/Mid/Junior]
- Demonstrated level: [Senior/Mid/Junior]
- Gap: [None/Minor/Significant]

**Scope Match**:
- Required: [team size, budget, scale from JD]
- Demonstrated: [evidence from resume]

### Keywords (XX%)

**Exact Matches (X/Y)**:
- ✓ "[keyword]" - Found [X] times
- ✓ "[keyword]" - Found [X] times

**Missing High-Value Keywords**:
- ✗ "[keyword]" - Appears [X] times in JD
- ✗ "[keyword]" - Industry-standard term

### Job Titles (XX%)

**Title Progression Analysis**:
| Your Title | Target Title | Alignment |
|------------|--------------|-----------|
| [Current] | [JD Title] | XX% |

**Title Keywords**:
- ✓ [Matched title keyword]
- ✗ [Missing title keyword]

### Soft Skills (XX%)

**Demonstrated**:
- ✓ [Soft skill] - Evidence: "[quote from resume]"

**Required but Missing**:
- ✗ [Soft skill] - Add evidence of this skill

### Education (XX%)

**Degree Match**:
- Required: [Degree] in [Field]
- Found: [Degree] in [Field]
- Status: [Meets/Exceeds/Below/Alternative]

**Certifications**:
- ✓ [Cert name] - Matches requirement
- ✗ [Required cert] - Not found

### Industry (XX%)

**Domain Experience**:
- Required: [Industry/Domain]
- Found: [Industries in resume]
- Relevance: [Direct/Adjacent/Transferable]

---

## Gap Summary

### Critical Gaps (Address First)
1. **[Gap]** - Impact: High - [Brief explanation]
2. **[Gap]** - Impact: High - [Brief explanation]

### Important Gaps
1. **[Gap]** - Impact: Medium - [Brief explanation]

### Minor Gaps
1. **[Gap]** - Impact: Low - [Brief explanation]

---

## Optimization Suggestions

### High Impact (Estimated +X-Y% improvement)

1. **[Suggestion title]**
   - Current: [What's in resume now]
   - Recommended: [What to add/change]
   - Where: [Which section to modify]
   - Example: "[Specific wording to consider]"

2. **[Suggestion title]**
   - Current: [What's in resume now]
   - Recommended: [What to add/change]
   - Where: [Which section to modify]
   - Example: "[Specific wording to consider]"

### Medium Impact (Estimated +X-Y% improvement)

1. **[Suggestion]**
   - [Details]

### Quick Wins (Estimated +X-Y% improvement)

1. **[Suggestion]** - [One-line actionable item]
2. **[Suggestion]** - [One-line actionable item]

---

## ATS Compatibility Notes

**Formatting Issues**:
- [Any detected formatting issues that might cause ATS parsing problems]

**Keyword Density**:
- Top JD keywords not in resume: [list]
- Recommendation: [specific advice]

**Section Headers**:
- [Any non-standard headers that ATS might not recognize]

---

## Confidence Level

Analysis confidence: [High/Medium/Low]
- [Reason for confidence level]

Keyword Matching Rules

Skill Synonyms

Apply these common equivalences:

JD TermAlso Accept
JavaScriptJS, ECMAScript, ES6+
PythonPython3, Py
Machine LearningML, Deep Learning, AI/ML
Amazon Web ServicesAWS, Amazon Cloud
Google Cloud PlatformGCP, Google Cloud
Microsoft AzureAzure, MS Azure
Continuous IntegrationCI, CI/CD
Continuous DeploymentCD, CI/CD
KubernetesK8s, K8
PostgreSQLPostgres, PSQL
MongoDBMongo
React.jsReact, ReactJS
Node.jsNode, NodeJS
TypeScriptTS
GraphQLGQL
REST APIRESTful, REST
AgileScrum, Kanban, Agile/Scrum
Project ManagementPM, Program Management
People ManagementTeam Leadership, Engineering Management

Experience Level Mapping

JD RequirementAcceptable Range
Entry level0-2 years
Junior1-3 years
Mid-level3-5 years
Senior5-8 years
Staff/Principal8-12 years
Director10+ years
VP/Head12+ years

Education Equivalences

RequirementAlso Accept
Bachelor's requiredMaster's, PhD
Master's preferredPhD, Bachelor's + 2 years
CS degreeRelated technical degree + experience
MBABusiness degree + experience

Suggestion Generation Rules

Prioritization

Generate suggestions in this priority order:

  1. Missing REQUIRED skills - Highest impact
  2. Experience gaps - High impact
  3. Missing exact keywords - Medium-high impact
  4. Missing certifications - Medium impact
  5. Soft skill evidence - Medium impact
  6. Keyword optimization - Low-medium impact
  7. Formatting improvements - Low impact

Suggestion Quality

Each suggestion must be:

  • Specific - Not generic advice
  • Actionable - Clear what to do
  • Evidenced - Based on actual gap found
  • Realistic - Achievable without lying

Example Suggestion Patterns

For missing skill:

Add [SKILL] to your skills section. Based on your experience with
[RELATED SKILL], you may have exposure to this. If you have any
experience, add a bullet point like: "Utilized [SKILL] for [USE CASE]"

For keyword gap:

The JD mentions "[KEYWORD]" [X] times. Consider incorporating this
terminology in your [SECTION]. For example, change "[CURRENT PHRASING]"
to "[SUGGESTED PHRASING WITH KEYWORD]"

For experience gap:

The role requires [X] years of [DOMAIN] experience. Your resume shows
[Y] years. Emphasize your [RELEVANT EXPERIENCE] and quantify impact
to demonstrate equivalent depth.

Edge Cases

When Resume > JD Requirements

  • Still note as "Exceeds" not 100%+
  • Flag potential overqualification concerns
  • Suggest tailoring to avoid rejection

When JD is Vague

  • Note confidence as "Medium" or "Low"
  • Make reasonable inferences
  • List assumptions made

When Resume Has Non-Standard Format

  • Extract what's possible
  • Note any parsing limitations
  • Provide best-effort analysis

References

For detailed information, see:

Keep looking

Skills are one crate of 608,666. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.