Manage multiple resumes, with each getting its own dedicated website.

Automatically generate a professional resume with a proper PDF version, hosted for free via GitHub Pages.

Powered by: JSONResume + Engineering Theme + GH Pages + Claude Code (AI authoring)

Behold...

Every resume.json becomes its own hosted site — clean, ATS-friendly, PDF-downloadable.

...and it deploys itself on every push:

Features

• AI Authoring - Generate a JD-tailored resume with Claude Code, backed by a [VERIFY] honesty gate so nothing fabricated ever ships. (jump to it ↓)
• Multi-Resume Support - Manage multiple resumes for different job roles in one place.
• One Source of Truth - Just edit the resume.json for the resume you want to change.
• Automated Deployment - Websites are generated and deployed on every resume push.
• Live Websites - Each resume is hosted with GitHub Pages for free in its own repository.
• Download PDF - A print optimized version is available as downloadable PDF.
• Clean Theme - Minimal, readable and optimized to ATS standards.

Instructions

1. Fork this repo

   

2. Enable Actions

   

3. Create a Personal Access Token

   

4. Add a new actions secret

   

5. Create codespaces

   

6. Copy the sample resume

   Run below command in the codespace terminal:

   cp resumes/sample resumes/google/ -r

   

7. Edit your resume & Push the changes

   

   💡 Skip the hand-editing. Instead of writing resume.json yourself, let Claude Code tailor it from a job description — see AI Authoring below.

---

All done! You'll be able to access your live site at https://<github_username>.github.io/google-resume

Check your Actions tab to see if its running correctly.

AI Authoring (Recommended)

This is the fastest way to fill in step 6–7 above: instead of hand-editing resume.json, let Claude Code turn a job description into a tailored resume for you. It works great right inside Codespaces — no API key needed — and ships with two skills and an enforced honesty policy.

Skill	What it does
intake-profile	Build profile/master.json — your full, truthful career history — by interviewing you or importing an old PDF/CV/LinkedIn export.
tailor-resume	Turn a job description + your master into a pruned, JD-ranked resumes/<company>/resume.json.

1. Build your master profile once. Run the intake-profile skill. It either interviews you or imports an old PDF/CV/LinkedIn export into profile/master.json — your full, truthful career history. (See profile/master.example.json for the shape.)

2. Tailor to a job. Run the tailor-resume skill with the job description. It writes resumes/<company>/resume.json as a ranked, JD-focused view of your master, and reports any gaps between the JD and your experience.

3. Honesty gate. The skills never invent facts. Anything plausible but unconfirmed is tagged [VERIFY]; npm run validate (run automatically in CI) fails until you confirm or remove it — so nothing unverified is ever published.

4. Push as usual. Pushing resumes/<company>/resume.json triggers the normal build and deploy.

See examples/ for a full worked example (master profile → JD → tailored resume). Validate any resume locally with npm run validate.

Advanced (Optional)

Want to preview your resume before pushing?

Get NodeJS first

1. Install dependencies:

   npm install
   npx playwright install chromium

2. To build a specific resume, run the build-resume.sh script with the FILE_PATH environment variable:

   FILE_PATH=resumes/data-scientist ./scripts/build-resume.sh

You’ll find the generated index.html, resume.html, and resume.pdf inside the resumes/data-scientist/ folder.

Summary

1. You make a copy of the resumes/sample directory to a new one (e.g. resumes/google/).
2. You modify the resume.json file in this resumes/google/ with your actual details.
3. You push your code to GitHub so GitHub Actions automatically builds the site and PDF.
4. The output is deployed to a separate resume repository (e.g., google-resume) with GitHub Pages enabled.
5. If you delete any resume folder, the corresponding repository is also deleted.

This lets you keep your resumes repository separate from the live resume websites.

Happy Job Hunting!