Resume formatter

Ensure ATS-friendly formatting and create clean scannable layouts

How to use it

  1. Hit Copy SKILL.md — or use the Claude Code line below to get every file.
  2. Claude: ⋯ → Download .md, then Customize → Skills → Add → Upload skill.
    ChatGPT: make a Project and paste it into Instructions.
    Neither? Paste it at the top of a new chat — it works for that chat.
  3. Describe your job in plain words. The AI follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit Paramchoudhary/ResumeSkills/skills/resume-formatter#main ~/.claude/skills/resume-formatter

For one project only, change the path to .claude/skills/resume-formatter. This skill also uses Node.js — copying SKILL.md alone won't be enough. See the folder on GitHub.

Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Show the full text361 lines
resume-formatter/SKILL.md361 lines8.3 KBpushed 189d agoRawView on GitHub

Resume Formatter

When to Use This Skill

Use this skill when the user:

  • Needs help with resume layout and formatting
  • Has a messy or hard-to-read resume
  • Wants to ensure ATS compatibility through formatting
  • Needs a clean, professional design
  • Mentions: "format resume", "resume layout", "resume design", "clean resume", "professional format"

Core Capabilities

  • Structure resumes for optimal readability
  • Ensure ATS compatibility through formatting
  • Create visual hierarchy
  • Optimize white space and margins
  • Select appropriate fonts and sizes
  • Balance aesthetic appeal with functionality

Formatting Fundamentals

The Dual Audience Challenge

Your resume must work for:

  1. ATS (Applicant Tracking Systems) - Robots that parse text
  2. Human Readers - Recruiters who scan quickly

The Solution: Clean, simple formatting that satisfies both.

Document Setup

Page Length

  • Entry Level (0-5 years): 1 page
  • Mid-Level (5-15 years): 1-2 pages
  • Senior/Executive (15+ years): 2 pages (max 3 for executives)

Margins

  • Recommended: 0.5" - 1" all sides
  • Minimum: 0.5" (don't go smaller)
  • Maximum: 1" (don't waste space)

Font Selection

Safe, ATS-Friendly Fonts:

  • Sans-serif: Arial, Calibri, Helvetica, Verdana
  • Serif: Times New Roman, Georgia, Garamond

Font Sizes:

  • Name: 16-20pt
  • Section Headers: 12-14pt
  • Body Text: 10-12pt
  • Minimum readable: 10pt

Spacing

  • Line spacing: 1.0 to 1.15
  • Space after paragraphs: 6-12pt
  • Section spacing: 12-16pt between sections

ATS-Safe Formatting Rules

DO:

  • ✅ Use standard fonts
  • ✅ Use simple bullet points (•, -, *)
  • ✅ Use bold and italic sparingly
  • ✅ Use standard section headers
  • ✅ Save as .docx or text-based .pdf
  • ✅ Put contact info in body (not header)
  • ✅ Use single column layout
  • ✅ Use consistent formatting throughout

DON'T:

  • ❌ Use tables (except simple ones for contact info)
  • ❌ Use text boxes
  • ❌ Use columns (multi-column layouts)
  • ❌ Use headers/footers for important info
  • ❌ Use images or graphics
  • ❌ Use unusual fonts
  • ❌ Use skill bars or progress indicators
  • ❌ Use special characters or emojis
  • ❌ Use color for essential information

Section Organization

Standard Section Order

1. Contact Information
2. Professional Summary (optional)
3. Skills/Technical Skills
4. Professional Experience
5. Education
6. Certifications (if relevant)
7. Additional (volunteer, languages, etc.)

Section Header Formatting

ATS-Recognized Headers:

  • PROFESSIONAL EXPERIENCE or WORK EXPERIENCE
  • EDUCATION
  • SKILLS or TECHNICAL SKILLS
  • PROFESSIONAL SUMMARY or SUMMARY
  • CERTIFICATIONS
  • PROJECTS

Format Options:

PROFESSIONAL EXPERIENCE
━━━━━━━━━━━━━━━━━━━━━━

or

Professional Experience
_______________________

or

PROFESSIONAL EXPERIENCE

Contact Information Layout

Recommended Format

JOHN SMITH
[email protected] | (555) 123-4567 | linkedin.com/in/johnsmith
San Francisco, CA

Alternative Format

JOHN SMITH
San Francisco, CA
[email protected] | (555) 123-4567
LinkedIn: linkedin.com/in/johnsmith | GitHub: github.com/johnsmith

What to Include

  • ✅ Full name
  • ✅ Professional email
  • ✅ Phone number
  • ✅ City, State (no full address needed)
  • ✅ LinkedIn URL
  • ✅ Portfolio/GitHub (if relevant)

What to Exclude

  • ❌ Full street address
  • ❌ Photo
  • ❌ Date of birth
  • ❌ Marital status
  • ❌ Multiple phone numbers
  • ❌ Personal social media

Experience Section Formatting

Standard Format

COMPANY NAME | City, ST
Job Title | Month Year - Month Year

• Achievement bullet with metrics and results
• Achievement bullet with metrics and results
• Achievement bullet with metrics and results

Alternative Format

Job Title
COMPANY NAME, City, ST                    Month Year - Month Year

• Achievement bullet with metrics and results
• Achievement bullet with metrics and results

Date Formatting

  • Consistent format: Use same format throughout
  • Recommended: Month Year (Jan 2020 - Present)
  • Also acceptable: MM/YYYY (01/2020 - Present)
  • Avoid: Full dates (January 15, 2020)

Bullet Point Guidelines

  • Length: 1-2 lines each
  • Format: Start with action verb, end with result
  • Quantity: 3-6 bullets per role (more for recent, fewer for old)
  • Symbol: Use standard bullets (•, -, *)

Skills Section Formatting

Option 1: Simple List

SKILLS
Python, JavaScript, SQL, React, Node.js, AWS, Docker, Git, Agile, JIRA

Option 2: Categorized

TECHNICAL SKILLS
Languages: Python, JavaScript, TypeScript, SQL
Frameworks: React, Node.js, Django, Flask
Tools: AWS, Docker, Kubernetes, Git, Jenkins

Option 3: Columns (Careful with ATS)

SKILLS
Languages        Frameworks       Tools
Python           React            AWS
JavaScript       Node.js          Docker
SQL              Django           Git

Note: Multi-column layouts may cause ATS issues. Test before using.

Education Section Formatting

Standard Format

EDUCATION
Bachelor of Science in Computer Science
University of California, Berkeley | 2018
GPA: 3.8/4.0 (include if 3.5+)

With Honors/Details

EDUCATION
MBA, Finance & Strategy | Stanford Graduate School of Business | 2020
• Graduated with Distinction
• Relevant Coursework: Corporate Finance, M&A Strategy

Visual Hierarchy Principles

Hierarchy Order

  1. Name - Largest, most prominent
  2. Section Headers - Clear divisions
  3. Job Titles/Company Names - Easy to scan
  4. Bullet Points - The details

Creating Hierarchy

  • Use font SIZE to create levels
  • Use BOLD for emphasis (names, titles, headers)
  • Use CAPS for section headers
  • Use consistent spacing to separate sections

White Space Management

Good White Space:

  • Between sections (clear separation)
  • After headings (visual breathing room)
  • Between bullets (don't cram)
  • Around margins (frame the content)

Bad White Space:

  • Huge gaps between sections
  • Inconsistent spacing
  • Half-empty pages
  • Excessive margins eating space

Common Formatting Mistakes

Mistake 1: Wall of Text

Problem: Dense paragraphs with no bullets Solution: Use bullet points, keep paragraphs short

Mistake 2: Inconsistent Formatting

Problem: Different fonts, sizes, or styles throughout Solution: Pick one format and stick to it

Mistake 3: Trying to Be Creative

Problem: Fancy designs that break ATS Solution: Save creativity for portfolio, not resume

Mistake 4: Too Much Information

Problem: Cramming everything onto one page Solution: Edit ruthlessly, prioritize relevance

Mistake 5: Not Enough Information

Problem: Half-page resume with massive margins Solution: Add detail, reduce margins (to 0.5")

File Format Guidelines

For Online Applications

  • .docx - Best for ATS parsing
  • .pdf - Good if created from Word (not scanned)

For Email/Direct Send

  • .pdf - Preserves formatting

File Naming

FirstName_LastName_Resume.pdf
JohnSmith_Resume_ProductManager.pdf

Avoid:

  • resume_final_v2_updated_FINAL.docx
  • resume (1).pdf
  • Untitled document.docx

Output Format

When formatting a resume:

# RESUME FORMATTING REVIEW

## Current Issues
- [ ] [Issue 1]
- [ ] [Issue 2]
- [ ] [Issue 3]

## Recommended Changes

### Document Setup
- Margins: [Current] → [Recommended]
- Font: [Current] → [Recommended]
- Font sizes: [Current] → [Recommended]

### Section Order
**Current:** [Current order]
**Recommended:** [New order and why]

### Visual Improvements
- [Specific change 1]
- [Specific change 2]

### ATS Compatibility Fixes
- [Fix 1]
- [Fix 2]

## Before/After Preview

### Before:
[Description or example of current formatting]

### After:
[Description or example of improved formatting]

Quick Formatting Checklist

Before submitting any resume:

  • ✅ One page (or two if warranted)
  • ✅ Standard font (10-12pt body)
  • ✅ Consistent formatting throughout
  • ✅ Clear section headers
  • ✅ Appropriate white space
  • ✅ No tables, text boxes, or columns
  • ✅ Contact info in body (not header)
  • ✅ Saved as .docx or .pdf
  • ✅ Proper file name
  • ✅ Proofread for consistency
1---
2name: resume-formatter
3description: Ensure ATS-friendly formatting and create clean scannable layouts
4---
5 
6# Resume Formatter
7 
8## When to Use This Skill
9 
10Use this skill when the user:
11- Needs help with resume layout and formatting
12- Has a messy or hard-to-read resume
13- Wants to ensure ATS compatibility through formatting
14- Needs a clean, professional design
15- Mentions: "format resume", "resume layout", "resume design", "clean resume", "professional format"
16 
17## Core Capabilities
18 
19- Structure resumes for optimal readability
20- Ensure ATS compatibility through formatting
21- Create visual hierarchy
22- Optimize white space and margins
23- Select appropriate fonts and sizes
24- Balance aesthetic appeal with functionality
25 
26## Formatting Fundamentals
27 
28### The Dual Audience Challenge
29 
30Your resume must work for:
311. **ATS (Applicant Tracking Systems)** - Robots that parse text
322. **Human Readers** - Recruiters who scan quickly
33 
34**The Solution:** Clean, simple formatting that satisfies both.
35 
36## Document Setup
37 
38### Page Length
39- **Entry Level (0-5 years):** 1 page
40- **Mid-Level (5-15 years):** 1-2 pages
41- **Senior/Executive (15+ years):** 2 pages (max 3 for executives)
42 
43### Margins
44- **Recommended:** 0.5" - 1" all sides
45- **Minimum:** 0.5" (don't go smaller)
46- **Maximum:** 1" (don't waste space)
47 
48### Font Selection
49 
50**Safe, ATS-Friendly Fonts:**
51- **Sans-serif:** Arial, Calibri, Helvetica, Verdana
52- **Serif:** Times New Roman, Georgia, Garamond
53 
54**Font Sizes:**
55- **Name:** 16-20pt
56- **Section Headers:** 12-14pt
57- **Body Text:** 10-12pt
58- **Minimum readable:** 10pt
59 
60### Spacing
61- **Line spacing:** 1.0 to 1.15
62- **Space after paragraphs:** 6-12pt
63- **Section spacing:** 12-16pt between sections
64 
65## ATS-Safe Formatting Rules
66 
67### DO:
68- ✅ Use standard fonts
69- ✅ Use simple bullet points (•, -, *)
70- ✅ Use bold and italic sparingly
71- ✅ Use standard section headers
72- ✅ Save as .docx or text-based .pdf
73- ✅ Put contact info in body (not header)
74- ✅ Use single column layout
75- ✅ Use consistent formatting throughout
76 
77### DON'T:
78- ❌ Use tables (except simple ones for contact info)
79- ❌ Use text boxes
80- ❌ Use columns (multi-column layouts)
81- ❌ Use headers/footers for important info
82- ❌ Use images or graphics
83- ❌ Use unusual fonts
84- ❌ Use skill bars or progress indicators
85- ❌ Use special characters or emojis
86- ❌ Use color for essential information
87 
88## Section Organization
89 
90### Standard Section Order
91 
92```
931. Contact Information
942. Professional Summary (optional)
953. Skills/Technical Skills
964. Professional Experience
975. Education
986. Certifications (if relevant)
997. Additional (volunteer, languages, etc.)
100```
101 
102### Section Header Formatting
103 
104**ATS-Recognized Headers:**
105- PROFESSIONAL EXPERIENCE or WORK EXPERIENCE
106- EDUCATION
107- SKILLS or TECHNICAL SKILLS
108- PROFESSIONAL SUMMARY or SUMMARY
109- CERTIFICATIONS
110- PROJECTS
111 
112**Format Options:**
113```
114PROFESSIONAL EXPERIENCE
115━━━━━━━━━━━━━━━━━━━━━━
116 
117or
118 
119Professional Experience
120_______________________
121 
122or
123 
124PROFESSIONAL EXPERIENCE
125```
126 
127## Contact Information Layout
128 
129### Recommended Format
130```
131JOHN SMITH
132[email protected] | (555) 123-4567 | linkedin.com/in/johnsmith
133San Francisco, CA
134```
135 
136### Alternative Format
137```
138JOHN SMITH
139San Francisco, CA
140[email protected] | (555) 123-4567
141LinkedIn: linkedin.com/in/johnsmith | GitHub: github.com/johnsmith
142```
143 
144### What to Include
145- ✅ Full name
146- ✅ Professional email
147- ✅ Phone number
148- ✅ City, State (no full address needed)
149- ✅ LinkedIn URL
150- ✅ Portfolio/GitHub (if relevant)
151 
152### What to Exclude
153- ❌ Full street address
154- ❌ Photo
155- ❌ Date of birth
156- ❌ Marital status
157- ❌ Multiple phone numbers
158- ❌ Personal social media
159 
160## Experience Section Formatting
161 
162### Standard Format
163```
164COMPANY NAME | City, ST
165Job Title | Month Year - Month Year
166 
167• Achievement bullet with metrics and results
168• Achievement bullet with metrics and results
169• Achievement bullet with metrics and results
170```
171 
172### Alternative Format
173```
174Job Title
175COMPANY NAME, City, ST Month Year - Month Year
176 
177• Achievement bullet with metrics and results
178• Achievement bullet with metrics and results
179```
180 
181### Date Formatting
182- **Consistent format:** Use same format throughout
183- **Recommended:** Month Year (Jan 2020 - Present)
184- **Also acceptable:** MM/YYYY (01/2020 - Present)
185- **Avoid:** Full dates (January 15, 2020)
186 
187### Bullet Point Guidelines
188- **Length:** 1-2 lines each
189- **Format:** Start with action verb, end with result
190- **Quantity:** 3-6 bullets per role (more for recent, fewer for old)
191- **Symbol:** Use standard bullets (•, -, *)
192 
193## Skills Section Formatting
194 
195### Option 1: Simple List
196```
197SKILLS
198Python, JavaScript, SQL, React, Node.js, AWS, Docker, Git, Agile, JIRA
199```
200 
201### Option 2: Categorized
202```
203TECHNICAL SKILLS
204Languages: Python, JavaScript, TypeScript, SQL
205Frameworks: React, Node.js, Django, Flask
206Tools: AWS, Docker, Kubernetes, Git, Jenkins
207```
208 
209### Option 3: Columns (Careful with ATS)
210```
211SKILLS
212Languages Frameworks Tools
213Python React AWS
214JavaScript Node.js Docker
215SQL Django Git
216```
217 
218**Note:** Multi-column layouts may cause ATS issues. Test before using.
219 
220## Education Section Formatting
221 
222### Standard Format
223```
224EDUCATION
225Bachelor of Science in Computer Science
226University of California, Berkeley | 2018
227GPA: 3.8/4.0 (include if 3.5+)
228```
229 
230### With Honors/Details
231```
232EDUCATION
233MBA, Finance & Strategy | Stanford Graduate School of Business | 2020
234• Graduated with Distinction
235• Relevant Coursework: Corporate Finance, M&A Strategy
236```
237 
238## Visual Hierarchy Principles
239 
240### Hierarchy Order
2411. **Name** - Largest, most prominent
2422. **Section Headers** - Clear divisions
2433. **Job Titles/Company Names** - Easy to scan
2444. **Bullet Points** - The details
245 
246### Creating Hierarchy
247- Use font SIZE to create levels
248- Use **BOLD** for emphasis (names, titles, headers)
249- Use CAPS for section headers
250- Use consistent spacing to separate sections
251 
252## White Space Management
253 
254### Good White Space:
255- Between sections (clear separation)
256- After headings (visual breathing room)
257- Between bullets (don't cram)
258- Around margins (frame the content)
259 
260### Bad White Space:
261- Huge gaps between sections
262- Inconsistent spacing
263- Half-empty pages
264- Excessive margins eating space
265 
266## Common Formatting Mistakes
267 
268### Mistake 1: Wall of Text
269**Problem:** Dense paragraphs with no bullets
270**Solution:** Use bullet points, keep paragraphs short
271 
272### Mistake 2: Inconsistent Formatting
273**Problem:** Different fonts, sizes, or styles throughout
274**Solution:** Pick one format and stick to it
275 
276### Mistake 3: Trying to Be Creative
277**Problem:** Fancy designs that break ATS
278**Solution:** Save creativity for portfolio, not resume
279 
280### Mistake 4: Too Much Information
281**Problem:** Cramming everything onto one page
282**Solution:** Edit ruthlessly, prioritize relevance
283 
284### Mistake 5: Not Enough Information
285**Problem:** Half-page resume with massive margins
286**Solution:** Add detail, reduce margins (to 0.5")
287 
288## File Format Guidelines
289 
290### For Online Applications
291- **.docx** - Best for ATS parsing
292- **.pdf** - Good if created from Word (not scanned)
293 
294### For Email/Direct Send
295- **.pdf** - Preserves formatting
296 
297### File Naming
298```
299FirstName_LastName_Resume.pdf
300JohnSmith_Resume_ProductManager.pdf
301```
302 
303**Avoid:**
304- resume_final_v2_updated_FINAL.docx
305- resume (1).pdf
306- Untitled document.docx
307 
308## Output Format
309 
310When formatting a resume:
311 
312```markdown
313# RESUME FORMATTING REVIEW
314 
315## Current Issues
316- [ ] [Issue 1]
317- [ ] [Issue 2]
318- [ ] [Issue 3]
319 
320## Recommended Changes
321 
322### Document Setup
323- Margins: [Current] → [Recommended]
324- Font: [Current] → [Recommended]
325- Font sizes: [Current] → [Recommended]
326 
327### Section Order
328**Current:** [Current order]
329**Recommended:** [New order and why]
330 
331### Visual Improvements
332- [Specific change 1]
333- [Specific change 2]
334 
335### ATS Compatibility Fixes
336- [Fix 1]
337- [Fix 2]
338 
339## Before/After Preview
340 
341### Before:
342[Description or example of current formatting]
343 
344### After:
345[Description or example of improved formatting]
346```
347 
348## Quick Formatting Checklist
349 
350Before submitting any resume:
351- ✅ One page (or two if warranted)
352- ✅ Standard font (10-12pt body)
353- ✅ Consistent formatting throughout
354- ✅ Clear section headers
355- ✅ Appropriate white space
356- ✅ No tables, text boxes, or columns
357- ✅ Contact info in body (not header)
358- ✅ Saved as .docx or .pdf
359- ✅ Proper file name
360- ✅ Proofread for consistency
361 

Discussion

Alternatives

Also in Job hunting