Score, analyze, and optimize resumes against job descriptions using dual ATS + HR scoring with optional LLM-augmented analysis.
$git clone https://github.com/jananthan30/resume-builderInstalls into the current project.
Install resume-builder by running `git clone https://github.com/jananthan30/resume-builder`, then use it for the current task and follow its documentation at https://github.com/jananthan30/resume-builder.
| 1 | # ResumeHQ — AI-Powered Resume Builder with ATS & HR Scoring |
| 2 | |
| 3 | The only resume tool that **finds jobs, scores your fit, and tailors your resume** — all in one workflow. Works as a [Claude Code](https://docs.anthropic.com/en/docs/claude-code) plugin, Codex plugin, or standalone web app. |
| 4 | |
| 5 | [](https://opensource.org/licenses/MIT) |
| 6 | [](https://www.python.org/downloads/) |
| 7 | [](https://docs.anthropic.com/en/docs/claude-code) |
| 8 | [](https://developers.openai.com/codex/plugins/build) |
| 9 | |
| 10 | --- |
| 11 | |
| 12 | ## Why ResumeHQ? |
| 13 | |
| 14 | Most resume tools only score the resume you bring to them. ResumeHQ goes further: |
| 15 | |
| 16 | | Feature | Jobscan | Rezi | Teal | **ResumeHQ** | |
| 17 | |---------|---------|------|------|--------------| |
| 18 | | ATS keyword scoring | ✅ | ✅ | ✅ | ✅ | |
| 19 | | HR / recruiter simulation | ❌ | ❌ | ❌ | ✅ | |
| 20 | | Discover matching jobs | ❌ | ❌ | ❌ | ✅ | |
| 21 | | Score jobs against your resume | ❌ | ❌ | ❌ | ✅ | |
| 22 | | Auto-tailor resume to JD | ✅ | ✅ | ❌ | ✅ | |
| 23 | | ATS-compliant DOCX output | ❌ | ✅ | ❌ | ✅ | |
| 24 | | Application tracker | ❌ | ❌ | ✅ | ✅ | |
| 25 | | Works in Claude Code / claude.ai / Codex | ❌ | ❌ | ❌ | ✅ | |
| 26 | | Open source | ❌ | ❌ | ❌ | ✅ | |
| 27 | |
| 28 | --- |
| 29 | |
| 30 | ## What This Does |
| 31 | |
| 32 | You paste a job description (or search for jobs). The system: |
| 33 | |
| 34 | 1. **Discovers** matching jobs from live job boards — scored and ranked by fit with your resume |
| 35 | 2. **Analyzes** the JD — extracts keywords, required skills, domain, seniority level |
| 36 | 3. **Tailors** your master resume — rewrites bullets, reorders sections, matches terminology |
| 37 | 4. **Scores** the result with two independent engines (ATS + HR simulation) |
| 38 | 5. **Iterates** automatically until scores hit targets (ATS 75-85%, HR 70%+) |
| 39 | 6. **Generates** production-ready DOCX files (resume + cover letter) |
| 40 | 7. **Tracks** every application in an Excel spreadsheet |
| 41 | |
| 42 | All of this runs in **parallel** — scoring happens in the background while the resume is being written, cover letters generate simultaneously, and DOCX files are created in parallel. ~50% faster than sequential execution. |
| 43 | |
| 44 | --- |
| 45 | |
| 46 | ## Quick Start — 3 Steps |
| 47 | |
| 48 | Works with **Claude Code** (CLI/IDE), **Codex** (CLI/app/IDE), and **claude.ai** (web/Projects). |
| 49 | |
| 50 | **Step 1: Install the plugin** |
| 51 | |
| 52 | Claude Code: |
| 53 | |
| 54 | ```bash |
| 55 | /plugin marketplace add jananthan30/Resume-Builder |
| 56 | /plugin install resume-builder |
| 57 | ``` |
| 58 | |
| 59 | Codex from a local checkout: |
| 60 | |
| 61 | ```bash |
| 62 | codex plugin marketplace add . |
| 63 | ``` |
| 64 | |
| 65 | Then restart Codex and install **Resume Builder** from the **Resume Builder Local** marketplace. |
| 66 | |
| 67 | **Step 2: Run the setup wizard** |
| 68 | |
| 69 | ``` |
| 70 | /resume-builder:setup |
| 71 | ``` |
| 72 | |
| 73 | This walks you through everything: |
| 74 | - Checks if Python is installed (tells you where to download it if not) |
| 75 | - Installs all dependencies automatically (`pip install -r requirements.txt`) |
| 76 | - Creates your `config.json` with your name, email, phone, LinkedIn |
| 77 | - Optionally links a Pro account for unlimited cloud scoring |
| 78 | - Optionally sets up the LLM scorer (Claude API key) |
| 79 | |
| 80 | **Step 3: Start building resumes** |
| 81 | |
| 82 | ``` |
| 83 | /resume-builder:resume [paste a job description here] |
| 84 | ``` |
| 85 | |
| 86 | Or find jobs first: |
| 87 | |
| 88 | ``` |
| 89 | /resume-builder:find-jobs Senior Data Scientist in New York |
| 90 | ``` |
| 91 | |
| 92 | --- |
| 93 | |
| 94 | ## Slash Commands (8) |
| 95 | |
| 96 | | Command | What It Does | |
| 97 | |---------|-------------| |
| 98 | | `/resume-builder:setup` | One-time setup wizard (installs Python deps, creates config, links Pro account) | |
| 99 | | `/resume-builder:job-fit [JD]` | Quick GO/NO-GO job fit score before tailoring | |
| 100 | | `/resume-builder:resume [JD]` | Full application: tailored resume + cover letter + scoring + DOCX + tracking | |
| 101 | | `/resume-builder:tailor-resume [JD]` | Resume only (no cover letter) | |
| 102 | | `/resume-builder:cover-letter [JD]` | Cover letter only | |
| 103 | | `/resume-builder:find-jobs [title] [location]` | Discover and score matching jobs from live job boards | |
| 104 | | `/resume-builder:batch-resume` | Process multiple job descriptions in parallel | |
| 105 | | `/resume-builder:writing-coach [file]` | Audit and rewrite resume bullets using 10 writing rules | |
| 106 | |
| 107 | If running locally (cloned repo), use short names: `/resume`, `/tailor-resume`, `/find-jobs`, etc. |
| 108 | |
| 109 | ### What Works Without Setup |
| 110 | |
| 111 | Even before running `/resume-builder:setup`, these commands work immediately (they're prompt-driven workflows — no Python needed): |
| 112 | |
| 113 | | Command | Works immediately? | With setup? | |
| 114 | |---------|-------------------|-------------| |
| 115 | | `/resume-builder:job-fit` | Yes — heuristic fit analysis | + scorer-backed knockout detection | |
| 116 | | `/resume-builder:resume` | Yes — the assistant writes the resume | + automated ATS/HR scoring and DOCX output | |
| 117 | | `/resume-builder:cover-letter` | Yes — the assistant writes the letter | + DOCX output | |
| 118 | | `/resume-builder:writing-coach` | Yes — full writing audit | Same | |
| 119 | | `/resume-builder:find-jobs` | Yes — shows results (no score) | + ATS/HR fit scoring per job | |
| 120 | | `/resume-builder:setup` | Yes — runs the setup wizard | N/A | |
| 121 | | MCP scoring tools |