Resume Builder Skill
This skill creates beautifully designed, professional resumes as PDF documents. The output prioritizes clean typography, thoughtful spacing, and visual hierarchy while maintaining the practical readability employers expect.
Required Information
Before beginning, gather:
Resume Context (REQUIRED): The user's professional background, including:
- Work experience with roles, companies, dates, and accomplishments
- Education background
- Skills and competencies
- Any additional relevant sections (certifications, projects, publications, etc.)
Address Verification (ALWAYS ASK):
- Prompt the user: "What address should appear on your resume? Has this changed from any previous version?"
- If they have an existing resume, confirm the address is current
Job-Specific Information (OPTIONAL):
- If applying for a specific role, request the job description or posting link
- Ask: "Would you like me to create a cover letter as well?"
- When tailoring to a job, use web_fetch to analyze the job description and align resume content accordingly
Design Philosophy
Resumes should be sophisticated yet accessible - think of them as the intersection of:
- Swiss design clarity: Clean grids, thoughtful hierarchy, generous whitespace
- Editorial polish: Typography that's refined but never fussy
- Scannable structure: Easy for both human readers and ATS systems
Visual Principles
Typography:
- Use 2-3 fonts maximum from
./assets/fonts directory
- Recommended combinations:
- Professional/Corporate: Inter (headers & body) - Clean, highly readable, excellent at all sizes
- Creative/Modern: Special Gothic (headers) + Open Sans (body) - Distinctive yet professional
- Traditional/Academic: Open Sans throughout - Reliable, approachable, universally compatible
- Headers: Clean, confident sans-serifs (moderate weight, not ultra-bold)
- Body: Highly readable sans-serif at 10-11pt
- Hierarchy through size, weight, and spacing - not color chaos
Layout:
- Generous margins (0.5-0.75 inches minimum)
- Clear section divisions using whitespace, not heavy lines
- Consistent spacing that creates rhythm
- Single column or subtle two-column for optimal readability
Color (use sparingly):
- Primarily black text on white
- Optional: One accent color for headers or subtle elements
- Never sacrifice readability for visual flair
Spacing:
- Every element has breathing room
- No cramped text or overlapping elements
- Page breaks must fall naturally between sections
- If content exceeds one page, ensure page 2 is substantial (not just a few lines)
Content Guidelines
Language & Tone
CRITICAL: Maintain authentic, professional language. Do NOT:
- Use buzzwords excessively (synergy, rockstar, ninja, guru)
- Over-inflate accomplishments with hyperbole
- Write in third person or use overly formal Victorian prose
- Create generic, template-sounding bullet points
Instead:
- Use clear, direct language with strong action verbs
- Quantify achievements where possible (numbers, percentages, scale)
- Be specific about technologies, methodologies, and outcomes
- Let accomplishments speak for themselves without excessive adjectives
Structure
Standard Sections (adapt as needed):
- Header: Name (prominent), contact info (email, phone, LinkedIn, location)
- Professional Summary (optional, 2-3 lines maximum if included)
- Experience: Company, Title, Dates, 3-5 bullet points per role
- Education: Degree, Institution, Graduation year, relevant honors
- Skills: Organized logically (by category if extensive)
- Additional Sections as relevant: Certifications, Projects, Publications, Languages, etc.
Job-Specific Tailoring
When a job description is provided:
- Analyze key requirements, skills, and keywords from the posting
- Reorder or emphasize relevant experience
- Adjust bullet points to highlight applicable accomplishments
- Mirror language from the job posting (naturally, not robotically)
- Ensure skills section reflects the role's technical requirements
- Keep changes authentic - never fabricate or exaggerate
PDF Creation Process
Step 1: Information Gathering
Collect resume context, verify address, check for job-specific needs
Step 2: Content Organization
- Parse experience, education, skills
- Determine optimal structure
- If job posting provided, analyze and tailor content
- Decide on 1 vs 2 pages based on experience level
Step 3: Design Selection
Choose a visual approach that balances sophistication with convention:
- Professional services/Corporate: Clean, minimal, traditional
- Creative/Design roles: More personality, thoughtful typography
- Tech/Startup: Modern, crisp, slightly less formal
- Academic/Research: Traditional, content-dense, clear hierarchy
Step 4: PDF Generation
Use Python with reportlab or similar library to create the PDF:
Page Setup:
- Letter size (8.5" x 11")
- Margins: 0.5-0.75" on all sides
- If 2 pages needed, ensure clean break between pages
Typography:
- Load fonts from
./assets/fonts directory
- Available fonts: Inter (variable font), Open Sans (variable font), Special Gothic, Montserrat, BBH Sans Bogle
- Register custom fonts with the PDF library using absolute paths
- Use variable fonts (Inter, Open Sans) for flexible weight options
- Set consistent font sizes and line heights
Layout Implementation:
- Build content section by section
- Monitor page length to avoid awkward breaks
- If approaching page limit, make strategic decisions:
- Tighten spacing slightly (without cramping)
- Move to 2 pages if content warrants it
- Never cut off content mid-section
Quality Checks:
- All text within margins
- No overlapping elements
- Consistent spacing throughout
- Page breaks fall naturally
- Contact information clearly visible
- No orphaned single lines on page 2
Step 5: Refinement
Before outputting:
- Review hierarchy - can you scan and find key info quickly?
- Check whitespace - does the page breathe?
- Verify no content is cut off or awkwardly broken
- Ensure typography is crisp and professional
- Confirm all user information is accurate
Cover Letter Generation
If requested alongside resume:
Structure:
- Header matching resume (name, contact info)
- Date and employer address
- Professional greeting
- 3-4 paragraphs maximum:
- Opening: Position + enthusiasm + brief hook
- Why them: Company-specific interest and alignment
- Why you: Relevant experience and value proposition
- Closing: Call to action and thanks
- Professional sign-off
Tone:
- Professional but personable
- Confident without arrogance
- Specific to the company and role
- Avoid generic template language
- Match the company's communication style (formal vs. casual)
Design:
- Match resume typography and layout
- Clean, letter-like presentation
- Single page always
Output
Provide:
- resume.pdf - The completed 1-2 page resume
- cover-letter.pdf (if requested) - Matching cover letter
- Brief summary noting:
- Any content decisions made (what was emphasized/de-emphasized)
- Page count and reasoning
- Tailoring decisions if job-specific
Examples of Good Practice
Information Density:
- ✅ "Led team of 8 engineers to deliver customer portal, reducing support tickets by 40%"
- ❌ "Synergistically optimized team dynamics to revolutionize customer experience"
Page Length:
- Early career (0-5 years): 1 page
- Mid-career (5-15 years): 1-2 pages
- Senior/Executive (15+ years): 2 pages
- If page 2 would only have 3-4 lines, tighten page 1 instead
Visual Hierarchy:
- Name: 18-24pt
- Section headers: 12-14pt
- Job titles: 11-12pt
- Body text: 10-11pt
- Dates/secondary info: 9-10pt
Critical Reminders
- Never sacrifice readability for design - employers need to scan quickly
- Page breaks are sacred - content must never be cut off awkwardly
- Authenticity over inflation - normal, confident professional language
- Tailoring is strategic - emphasize relevant experience, don't fabricate
- Whitespace is professional - cramming content looks desperate
- Test the scan - can someone find your name, current role, and key skills in 10 seconds?
The goal is a resume that looks like it was designed by someone with impeccable taste who understands that a resume's job is to get interviews, not win design awards.
1---2name: resume-builder-23description: Generate beautiful, professionally designed resumes as 1-2 page PDFs. Creates clean, sophisticated layouts that balance visual appeal with readability, tailored to specific job opportunities when provided.4license: Complete terms in LICENSE.txt5---6
7# Resume Builder Skill
8
9This skill creates beautifully designed, professional resumes as PDF documents. The output prioritizes clean typography, thoughtful spacing, and visual hierarchy while maintaining the practical readability employers expect.
10
11## Required Information
12
13Before beginning, gather:
14
151. **Resume Context** (REQUIRED): The user's professional background, including:
16 - Work experience with roles, companies, dates, and accomplishments
17 - Education background
18 - Skills and competencies
19 - Any additional relevant sections (certifications, projects, publications, etc.)
20
212. **Address Verification** (ALWAYS ASK):
22 - Prompt the user: "What address should appear on your resume? Has this changed from any previous version?"
23 - If they have an existing resume, confirm the address is current
24
253. **Job-Specific Information** (OPTIONAL):
26 - If applying for a specific role, request the job description or posting link
27 - Ask: "Would you like me to create a cover letter as well?"
28 - When tailoring to a job, use web_fetch to analyze the job description and align resume content accordingly
29
30## Design Philosophy
31
32Resumes should be **sophisticated yet accessible** - think of them as the intersection of:
33- **Swiss design clarity**: Clean grids, thoughtful hierarchy, generous whitespace
34- **Editorial polish**: Typography that's refined but never fussy
35- **Scannable structure**: Easy for both human readers and ATS systems
36
37### Visual Principles
38
39**Typography**:
40- Use 2-3 fonts maximum from `./assets/fonts` directory
41- Recommended combinations:
42 - **Professional/Corporate**: Inter (headers & body) - Clean, highly readable, excellent at all sizes
43 - **Creative/Modern**: Special Gothic (headers) + Open Sans (body) - Distinctive yet professional
44 - **Traditional/Academic**: Open Sans throughout - Reliable, approachable, universally compatible
45- Headers: Clean, confident sans-serifs (moderate weight, not ultra-bold)
46- Body: Highly readable sans-serif at 10-11pt
47- Hierarchy through size, weight, and spacing - not color chaos
48
49**Layout**:
50- Generous margins (0.5-0.75 inches minimum)
51- Clear section divisions using whitespace, not heavy lines
52- Consistent spacing that creates rhythm
53- Single column or subtle two-column for optimal readability
54
55**Color** (use sparingly):
56- Primarily black text on white
57- Optional: One accent color for headers or subtle elements
58- Never sacrifice readability for visual flair
59
60**Spacing**:
61- Every element has breathing room
62- No cramped text or overlapping elements
63- Page breaks must fall naturally between sections
64- If content exceeds one page, ensure page 2 is substantial (not just a few lines)
65
66## Content Guidelines
67
68### Language & Tone
69
70**CRITICAL**: Maintain authentic, professional language. Do NOT:
71- Use buzzwords excessively (synergy, rockstar, ninja, guru)
72- Over-inflate accomplishments with hyperbole
73- Write in third person or use overly formal Victorian prose
74- Create generic, template-sounding bullet points
75
76Instead:
77- Use clear, direct language with strong action verbs
78- Quantify achievements where possible (numbers, percentages, scale)
79- Be specific about technologies, methodologies, and outcomes
80- Let accomplishments speak for themselves without excessive adjectives
81
82### Structure
83
84**Standard Sections** (adapt as needed):
851. **Header**: Name (prominent), contact info (email, phone, LinkedIn, location)
862. **Professional Summary** (optional, 2-3 lines maximum if included)
873. **Experience**: Company, Title, Dates, 3-5 bullet points per role
884. **Education**: Degree, Institution, Graduation year, relevant honors
895. **Skills**: Organized logically (by category if extensive)
906. **Additional Sections** as relevant: Certifications, Projects, Publications, Languages, etc.
91
92### Job-Specific Tailoring
93
94When a job description is provided:
951. Analyze key requirements, skills, and keywords from the posting
962. Reorder or emphasize relevant experience
973. Adjust bullet points to highlight applicable accomplishments
984. Mirror language from the job posting (naturally, not robotically)
995. Ensure skills section reflects the role's technical requirements
1006. Keep changes authentic - never fabricate or exaggerate
101
102## PDF Creation Process
103
104### Step 1: Information Gathering
105```
106Collect resume context, verify address, check for job-specific needs
107```
108
109### Step 2: Content Organization
110```
111- Parse experience, education, skills
112- Determine optimal structure
113- If job posting provided, analyze and tailor content
114- Decide on 1 vs 2 pages based on experience level
115```
116
117### Step 3: Design Selection
118```
119Choose a visual approach that balances sophistication with convention:
120- Professional services/Corporate: Clean, minimal, traditional
121- Creative/Design roles: More personality, thoughtful typography
122- Tech/Startup: Modern, crisp, slightly less formal
123- Academic/Research: Traditional, content-dense, clear hierarchy
124```
125
126### Step 4: PDF Generation
127
128Use Python with reportlab or similar library to create the PDF:
129
130**Page Setup**:
131- Letter size (8.5" x 11")
132- Margins: 0.5-0.75" on all sides
133- If 2 pages needed, ensure clean break between pages
134
135**Typography**:
136- Load fonts from `./assets/fonts` directory
137- Available fonts: Inter (variable font), Open Sans (variable font), Special Gothic, Montserrat, BBH Sans Bogle
138- Register custom fonts with the PDF library using absolute paths
139- Use variable fonts (Inter, Open Sans) for flexible weight options
140- Set consistent font sizes and line heights
141
142**Layout Implementation**:
143- Build content section by section
144- Monitor page length to avoid awkward breaks
145- If approaching page limit, make strategic decisions:
146 - Tighten spacing slightly (without cramping)
147 - Move to 2 pages if content warrants it
148 - Never cut off content mid-section
149
150**Quality Checks**:
151- All text within margins
152- No overlapping elements
153- Consistent spacing throughout
154- Page breaks fall naturally
155- Contact information clearly visible
156- No orphaned single lines on page 2
157
158### Step 5: Refinement
159
160Before outputting:
161- Review hierarchy - can you scan and find key info quickly?
162- Check whitespace - does the page breathe?
163- Verify no content is cut off or awkwardly broken
164- Ensure typography is crisp and professional
165- Confirm all user information is accurate
166
167## Cover Letter Generation
168
169If requested alongside resume:
170
171**Structure**:
172- Header matching resume (name, contact info)
173- Date and employer address
174- Professional greeting
175- 3-4 paragraphs maximum:
176 1. Opening: Position + enthusiasm + brief hook
177 2. Why them: Company-specific interest and alignment
178 3. Why you: Relevant experience and value proposition
179 4. Closing: Call to action and thanks
180- Professional sign-off
181
182**Tone**:
183- Professional but personable
184- Confident without arrogance
185- Specific to the company and role
186- Avoid generic template language
187- Match the company's communication style (formal vs. casual)
188
189**Design**:
190- Match resume typography and layout
191- Clean, letter-like presentation
192- Single page always
193
194## Output
195
196Provide:
1971. **resume.pdf** - The completed 1-2 page resume
1982. **cover-letter.pdf** (if requested) - Matching cover letter
1993. Brief summary noting:
200 - Any content decisions made (what was emphasized/de-emphasized)
201 - Page count and reasoning
202 - Tailoring decisions if job-specific
203
204## Examples of Good Practice
205
206**Information Density**:
207- ✅ "Led team of 8 engineers to deliver customer portal, reducing support tickets by 40%"
208- ❌ "Synergistically optimized team dynamics to revolutionize customer experience"
209
210**Page Length**:
211- Early career (0-5 years): 1 page
212- Mid-career (5-15 years): 1-2 pages
213- Senior/Executive (15+ years): 2 pages
214- If page 2 would only have 3-4 lines, tighten page 1 instead
215
216**Visual Hierarchy**:
217- Name: 18-24pt
218- Section headers: 12-14pt
219- Job titles: 11-12pt
220- Body text: 10-11pt
221- Dates/secondary info: 9-10pt
222
223## Critical Reminders
224
225- **Never sacrifice readability for design** - employers need to scan quickly
226- **Page breaks are sacred** - content must never be cut off awkwardly
227- **Authenticity over inflation** - normal, confident professional language
228- **Tailoring is strategic** - emphasize relevant experience, don't fabricate
229- **Whitespace is professional** - cramming content looks desperate
230- **Test the scan** - can someone find your name, current role, and key skills in 10 seconds?
231
232The goal is a resume that looks like it was designed by someone with impeccable taste who understands that a resume's job is to get interviews, not win design awards.