New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Ensure ATS-friendly formatting and create clean scannable

Resume formatter

by Paramchoudhary · MIT license · ★ 2,406 on GitHub · updated Jun 19

Resume formatter cover

Ensure ATS-friendly formatting and create clean scannable layouts

---
name: resume-formatter
description: Ensure ATS-friendly formatting and create clean scannable layouts
---

# 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

Overview

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"

Manual install (npx, ZIP)
Claude Codenpx skills add Paramchoudhary/ResumeSkills --skill resume-formatter -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/Paramchoudhary/ResumeSkills/tar.gz/74ae19e7c62b \ | tar -xz -C ~/.claude/skills --strip-components=2 ResumeSkills-74ae19e7c62b/skills/resume-formatter
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/324f84bf9e13772e05be/resume-formatter.zip" -OutFile "$env:TEMP\resume-formatter.zip"; Expand-Archive "$env:TEMP\resume-formatter.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md8.3 KB
Read the files here
Paramchoudhary/74ae19e1 file
SKILL.md
Show the full text361 lines

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

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 
View all files on GitHub →

Details

Updated
Jun 19, 2026
License
MIT
Stars on the repo
★ 2,406
Checked
Source
Paramchoudhary/ResumeSkills ↗
Creator
Paramchoudhary · 20 listings
View creator

Similar skills

See all →
SkillResume a paused experiment/ar:ar-resume — Resume Experimentalirezarezvani/claude-skills · by alirezarezvaniResume a paused experiment. Checkout the experiment branch, read results history, continue iterating. Use when the user runs /ar:ar-resume or asks to pick up a previously started autoresearch experiment.★ 26.3k GitHub starsSkillComet Classic workflow entryComet Classic — OpenSpec + Superpowersrpamis/comet · by rpamisComet Classic workflow entry. Use when the user explicitly invokes /comet-classic, asks to start or resume Classic, or resume-probe returns auto_resume for one unambiguously recoverable active Classic change.★ 3.1k GitHub starsSkillFormat CVs for academic positions with publications, grantsAcademic CV builderParamchoudhary/ResumeSkills · by ParamchoudharyFormat CVs for academic positions with publications, grants, and teaching★ 2.4k GitHub starsPromptA prompt for reviewing resumesAct as a resume reviewerf/prompts.chat · by AxA prompt for reviewing resumes in the context of a specific job opening.New listingPromptFind 80%+ matching [job sector] roles postedCustomizable job scannerf/prompts.chat · by Scott MalinFind 80%+ matching [job sector] roles posted within the specified window (default: last 14 days)New listingPromptThis was created to help with my job search but I planMaster Skills & Experience Summary Generatorf/prompts.chat · by Scott MalinThis was created to help with my job search but I plan on using it once done. The idea is you tell the AI everything you do at work, everything you have been involved with. Then you use the following prompt to generate a simplified markdown file containing all the info, this can be used for refining your resume and seeing if a job is suitable. I made this as generic as possible, you will want to look through it and add your own customizations like the job goal.New listing

More from Paramchoudhary