Use when tailoring a resume for a specific role, stack, level, or job description in any workspace. Best for creating a targeted resume variant from an existing markdown resume, optional evidence notes, and optional export styling without relying on a personal repo layout or companion CLI.
Use this skill when the user wants a reusable, workspace-agnostic resume tailoring workflow.
Default output is an ATS-safe resume variant in markdown. Export to .docx, .html, and .pdf only when the user asks for those artifacts or the workspace already supports them.
Gather what is available before editing:
If the user does not specify a resume path, search the workspace first. Common candidates are documented in references/source-discovery.md.
Use lightweight tailoring when the user gives:
Use deeper tailoring when the user gives:
Deeper tailoring still follows the same evidence discipline. The difference is stronger emphasis matching, keyword coverage, and bullet ordering.
Create a new variant next to the source resume with this basename pattern:
resume-<slug>.mdChange only the parts that should move for the target:
Keep chronology, employers, dates, and factual scope stable unless the user explicitly asks for a larger rewrite.
Use a stable lowercase hyphenated basename across artifacts:
resume-senior-backend.mdresume-senior-backend.docxresume-senior-backend.htmlresume-senior-backend.pdfPrefer short, role-shaped slugs. Avoid company names in the basename unless the user asks for employer-specific versions.
Use scripts/render_resume_outputs.py when the user wants deterministic .docx and .html output from markdown.
Example:
python3 /path/to/resume-tailor-generic/scripts/render_resume_outputs.py \
./resume-senior-backend.md \
--css ./resume.css
This writes adjacent outputs:
resume-senior-backend.docxresume-senior-backend.htmlIf pandoc is unavailable, stop at markdown and tell the user what is missing.
For PDF creation, print the generated HTML with Playwright or another browser-based print path when available. Use:
After tailoring or export:
Use pdfinfo and pdftotext when present. If those tools are missing, report the gap instead of guessing.
references/source-discovery.mdRead this when you need candidate filenames, ambiguity resolution rules, or default naming conventions for tailored outputs.
references/export-checks.mdRead this when you need a compact checklist for export behavior, PDF verification, or ATS-safe formatting constraints.
scripts/render_resume_outputs.pyDeterministic renderer for markdown to .docx and .html. It requires pandoc and does not create the PDF.