Skip to content

Repository files navigation

Resume

A one-page Typst resume with JSON-backed content, a shared parser-friendly renderer, controlled extraction fixtures, and project-local Codex review skills.

Authoritative artifacts

  • will_cygan_resume-data.json contains the resume content.
  • will_cygan_resume.typ loads the JSON and invokes the shared renderer.
  • tests/fixtures/golden-resume/golden-resume-template.typ is the renderer.
  • will_cygan_resume.pdf is the final artifact to inspect.

Supporting work history lives in work-experience/. It is raw evidence and may contain additional, draft, or in-flight material not present in the final resume.

Build and validate

Install Typst, Poppler, Tika, qpdf, and uv for the complete local workflow. The pinned Source Sans 3 font cuts are already under fonts/source-sans-3/.

just compile
just page-budget
just extraction-check
just test

Use just dev for a watched local preview.

Validation plans

Use one ordered validation plan for change acceptance; GitHub Actions runs the same full plan. The individual just commands above remain available when diagnosing a specific failed check.

Change scope Command Ordered checks
Resume content just validate-content compile, page budget, extraction check
Shared renderer just validate-renderer content checks, Golden compile/provenance, Golden deep check, Golden stress matrix
Repository-wide / CI just validate-full content checks, tests, Golden compile/provenance, Golden deep check, Golden stress matrix

The plan reports where to inspect durable local evidence after a failure: artifact provenance is under .extraction/artifact-provenance/, extraction reports are under .extraction/, and Golden evidence is under .extraction/golden-resume*/. These are local mechanical checks; they do not establish commercial ATS behavior or hiring outcomes.

Project-local Codex skills

  • $resume-review reviews and tailors content against documented evidence.
  • $resume-parsability evaluates PDF extraction, field associations, structure, links, fonts, and controlled layout behavior.

The parsability checks are local evidence. They do not reproduce a commercial ATS, certify screen-reader behavior, or predict hiring outcomes.

Golden Resume

The controlled reference bundle lives under tests/fixtures/golden-resume/. It includes anonymous data, source, a reviewed oracle, a compiled PDF, a stress manifest, and the shared renderer.

just golden-check
just golden-stress

Reports and rendered evidence are written beneath .extraction/, which is gitignored.

About

Open Source Resume built with Typst

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages