Skip to main content

Common Errors


Missing Required Fields

Error: person.name is required

Solution: Add the name field under person:

person:
name: Your Name

Invalid Email Format

Error: person.email does not match format 'email'

Solution: Use a valid email address:

person:
email: your.name@example.com

Skill Level Out of Range

Error: level must be less than or equal to 100

Solution: Use a value between 0 and 100:

technicalSkills:
domains:
- name: Programming
competencies:
- name: Go
level: 85 # Must be 0-100

Invalid YAML Syntax

Error: Invalid YAML syntax

Solution: Check for common issues:

  • Consistent indentation (use spaces, not tabs)
  • Colons after field names
  • Properly closed quotes
  • Valid array/list syntax with -

Empty Required Arrays

Error: career.missions must contain at least 1 item

Solution: Add at least one item to the array:

career:
- companyName: Tech Corp
missions:
- position: Software Engineer
company: Tech Corp

Troubleshooting

Validation Passes but CV Looks Wrong

Validation only checks structure and data types, not visual output. Check:

  • Theme compatibility with your CV structure
  • Theme-specific requirements
  • Output format settings