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