Resume Generator

A professional resume generator skill for creating beautiful, print-ready resumes with multiple export formats (PDF, Word, HTML) and full Chinese character support.

Features

Multiple Export Formats: PDF, Word (.docx), and HTML
PDF Generation:
- Direct PDF generation using ReportLab
- HTML-to-PDF conversion (WeasyPrint, pdfkit, ReportLab, FPDF)
Word Export: Generate editable .docx files
Chinese Support: Full Chinese character rendering with system fonts
Multiple Templates: Modern, classic, and minimal styles
Auto Layout: Smart pagination and content organization
Professional Design: Clean typography with visual hierarchy
Flexible Input: Support YAML config, Markdown, and HTML

Installation

# Clone the repository
git clone https://github.com/yourusername/resume-generator.git

# Install dependencies
pip install reportlab pyyaml python-docx beautifulsoup4

# Optional: For better PDF quality from HTML
pip install weasyprint pdfkit

# Register with OpenClaw
openclaw skills install resume-generator

Quick Start

Method 1: Generate from YAML Config

# Generate from config file
python generate_resume.py --config resume_config.yaml --output resume.pdf

# Use specific template
python generate_resume.py --config config.yaml --template modern_blue --output resume.pdf

Method 2: Convert HTML to PDF

# Convert HTML resume to PDF
python scripts/resume_to_pdf.py input.html output.pdf

# Use specific template
python scripts/resume_to_pdf.py input.html output.pdf --template modern

Method 3: Convert HTML/Markdown to Word

# Convert HTML to Word
python scripts/resume_to_docx.py input.html output.docx

# Convert Markdown to Word
python scripts/resume_to_docx.py input.md output.docx --markdown

Method 4: Python API

from scripts.resume_pdf import ResumePDFGenerator

# Create generator
gen = ResumePDFGenerator(theme='modern_blue')

# Add content
gen.add_header(
    name="张三",
    title="高级工程师",
    phone="138-0000-0000",
    email="example@example.com",
    address="北京市海淀区示例路1号"
)

gen.add_section("工作经历", [
    {
        "title": "高级工程师",
        "org": "某某科技有限公司",
        "period": "2020-至今",
        "detail": "软件开发 · 系统架构设计"
    }
])

# Generate PDF
gen.save("resume.pdf")

Export Methods

1. Direct PDF Generation (ReportLab)

Best for programmatic resume creation from Python:

from scripts.resume_pdf import ResumePDFGenerator

gen = ResumePDFGenerator(theme='modern_blue')
gen.add_header(...)
gen.add_section(...)
gen.save("output.pdf")

2. HTML to PDF Conversion

Best for converting existing HTML resumes:

# Tries multiple PDF backends automatically
python scripts/resume_to_pdf.py resume.html output.pdf

# Supported backends (auto-detected):
# - WeasyPrint (best quality)
# - pdfkit (requires wkhtmltopdf)
# - ReportLab (fallback)
# - FPDF (fallback)

3. Markdown/Word Export

Best for creating editable documents:

# Markdown to Word
python scripts/resume_to_docx.py resume.md output.docx --markdown

# HTML to Word
python scripts/resume_to_docx.py resume.html output.docx

Templates

modern_blue

Deep blue color scheme (#1e3a5f)
Clean header with contact grid
Blue section dividers
Professional academic style

classic

Traditional black and white
Conservative layout
Standard section ordering

minimal

Ultra-clean design
Minimal color usage
Maximum content density

Configuration Format

name: "张三"
title: "高级工程师 · 某某科技有限公司"
contact:
  phone: "138-0000-0000"
  email: "example@example.com"
  address: "北京市海淀区示例路1号"

sections:
  - title: "工作经历"
    items:
      - title: "高级工程师"
        org: "某某科技有限公司"
        period: "2020-至今"
        detail: "软件开发 · 系统架构设计"
  
  - title: "教育背景"
    items:
      - title: "计算机科学硕士"
        org: "某某大学"
        period: "2010-2013"
        detail: "导师：某某教授"

  - title: "发表论文"
    type: "publications"
    items:
      - "[1] Author et al. Paper title[J]. Journal, Year."
      - "[2] ..."

API Reference

ResumePDFGenerator Class

class ResumePDFGenerator:
    def __init__(self, theme='modern_blue'):
        """Initialize with theme name."""
    
    def add_header(self, name, title, phone, email, address):
        """Add resume header."""
    
    def add_section(self, title, items):
        """Add a content section."""
    
    def add_publications(self, papers):
        """Add publications section."""
    
    def save(self, output_path):
        """Generate and save PDF."""

HTML to PDF Functions

from scripts.resume_to_pdf import generate_pdf

# Convert HTML file to PDF
generate_pdf('input.html', 'output.pdf', template='modern')

# Convert HTML string to PDF
html_content = "<h1>Name</h1><p>Content...</p>"
generate_pdf(html_content, 'output.pdf', template='classic')

HTML/Markdown to Word

from scripts.resume_to_docx import generate_docx, generate_docx_from_markdown

# HTML to Word
generate_docx('input.html', 'output.docx', template='modern')

# Markdown to Word
generate_docx_from_markdown('input.md', 'output.docx', template='classic')

Examples

See examples/ directory for complete resume samples:

example_resume.yaml - Academic researcher CV
academic_cv.yaml - Academic CV with publications
professional_resume.yaml - Industry resume
minimal_resume.yaml - One-page minimal design

Directory Structure

resume-generator/
├── SKILL.md              # Skill documentation
├── README.md             # Project readme
├── LICENSE               # MIT License
├── generate_resume.py    # Main CLI entry point
├── requirements.txt      # Python dependencies
├── scripts/
│   ├── resume_pdf.py     # Direct PDF generation (ReportLab)
│   ├── resume_to_pdf.py  # HTML to PDF conversion
│   └── resume_to_docx.py # HTML/Markdown to Word
├── examples/
│   └── example_resume.yaml
└── assets/
    └── templates/        # HTML templates

Advanced Usage

Custom Styling

from scripts.resume_pdf import ResumePDFGenerator

# Use custom colors
gen = ResumePDFGenerator(
    theme='modern_blue',
    primary_color='#1e3a5f',
    accent_color='#2c5282'
)

Multi-page Layout

The generator automatically handles pagination:

Header repeats on each page
Smart section breaks
Balanced content distribution

Batch Processing

# Generate multiple resumes
for file in configs/*.yaml; do
    python generate_resume.py --config "$file" --output "output/$(basename $file .yaml).pdf"
done

Troubleshooting

Chinese Characters Not Displaying

Ensure you have Chinese fonts installed:

macOS: /System/Library/Fonts/STHeiti Medium.ttc
Linux: Install fonts-wqy-microhei
Windows: SimHei or Microsoft YaHei

PDF Generation Fails

The skill will automatically fallback to HTML output if PDF libraries are unavailable. Open the HTML in browser and print to PDF.

Word Export Issues

Make sure python-docx is installed:

pip install python-docx beautifulsoup4

Dependencies

Required:

reportlab - PDF generation
pyyaml - YAML config parsing
python-docx - Word document generation
beautifulsoup4 - HTML parsing

Optional (for better PDF quality):

weasyprint - High-quality HTML to PDF
pdfkit - wkhtmltopdf wrapper

License

MIT License - See LICENSE file for details.

Contributing

Pull requests welcome! Please follow the existing code style and add tests for new features.