resume-as-code ai claude-code onboarding developer-resume career

Turn Your Existing Resume into Resume as Code with an AI Agent

Hand your PDF, Word, or Markdown resume to an AI Agent, auto-generate gitresume.yaml, and start managing your resume with Git in five minutes.

Hao @ GitResume Hao @ GitResume

Want to start practicing Resume as Code with GitResume, but not sure where to begin?

A lot of people get stuck on the same thought:

Do I have to retype my entire PDF resume from scratch?

You don’t.

Your existing PDF, Word, or Markdown resume is the best data source you have. Today’s AI Agents can read those files directly, parse the contents, and migrate everything over to GitResume for you.

In other words, you don’t start from zero. Hand your resume to an AI, and in five minutes you can start managing your career with Git.

Why AI can pull this off

A resume is actually highly structured data: work experience, skills, education, projects, date ranges — it already has a fixed structure and involves no complex business logic. An AI Agent just needs to read your resume’s contents and output gitresume.yaml according to the schema, so Claude Code, Codex, and OpenCode can all handle it with ease.

A five-minute run-through

First-time setup: sign up for GitResume (GitHub login recommended), and have your AI Agent ready (we’ll use Claude Code here).

1. Sign in

Head to gitresume.co and sign in, preferably with your GitHub account.

GitResume login page offering both Login with GitHub and Login with Google

2. Create your repository from the official template

Open the official GitHub template, click Use this template in the top right to create your own repository, then clone it locally.

The gitresume-co/resume-template page on GitHub, with the Use this template button in the top right marked by a red arrow

Fill in a repository name and click Create repository, and GitHub will create your new repo from the template.

GitHub's Create a new repository page, creating a new repo from the gitresume-co/resume-template template

3. Grant access and create your project

Back in GitResume, in “Connect & Create Project,” click Grant Repository Access. You’ll be redirected to GitHub to authorize GitResume to access your repository (we recommend granting access only to the repo that holds your resume).

GitResume Project Setup page, with the Connect & Create Project section showing the Grant Repository Access button

After authorizing, return to Project Setup, select the repository you just created, and set the project name and slug. The slug becomes part of your public URL, for example: gitresume.co/@username/slug.

The Project Setup page after authorization, with the Connect & Create Project section listing selectable repositories

4. Let your AI Agent convert your resume

Drop your existing resume file (for example my-resume.pdf) into the project folder. This is where the magic happens, because the template already ships with AI guidance rules in AGENTS.md and CLAUDE.md.

Open your AI Agent in that folder. You don’t even need to explain the spec — just throw it a single line:

Convert my-resume.pdf into gitresume.yaml
Typing the prompt 'Convert my-resume.pdf into gitresume.yaml' into the Claude Code terminal

The AI Agent automatically reads the rules in the project, including GitResume’s schema, so you don’t have to explain anything else.

Claude Code automatically reading the resume schema definition from gitresume.co/schema

Once it’s done reading, it fills in the content according to the schema and reports back on what it did — whether each section is complete, and whether anything is missing or made up:

Claude Code reporting a summary of mapping the PDF content to the GitResume schema without fabricating numbers

After it generates the file, take a minute to check a few things:

  • Date formats are consistent (YYYY-MM)
  • No fabricated or exaggerated experience
  • Names, emails, and links are correct
  • Anything the AI marked as TODO has been filled in

Once it looks good, ask it to commit and push to GitHub.

Claude Code having committed and pushed to main, with the GitResume webhook set to automatically rebuild the PDF and web page

5. Download your PDF

After the push, GitResume builds automatically. Once the build finishes, you can download the PDF from the project page, preview the HTML version, or publish it to gitresume.co/@username/slug to share.

The GitResume project page, with the Builds section showing a Deployed build that can be previewed with View or downloaded as a PDF

And that’s it — your existing resume is now Resume as Code. From here on you never have to fuss over layout again; save your energy for the content that actually matters. The PDF GitResume produces uses a standard, universal layout that’s also friendly to ATS (applicant tracking systems).

Resume layout comparison: on the left, a two-column version with a photo that fails ATS parsing (red X); on the right, the clean single-column, ATS-friendly version GitResume produces (green check)

After you’ve moved it over

So how do you make it pay off?

If you already have a resume, you already have everything you need to start Resume as Code. All that’s left is to commit it into Git.

Git your resume →

Further Reading