resume-formatter
Ensure ATS-friendly formatting and create clean scannable layouts
Install / Use
npx skills add Paramchoudhary/ResumeSkills --skill resume-formatterInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of resume-formatter
resume-formatter scores 85/100 on our quality scale, 2608th of 4,698 Development & Engineering skills we index.
Its SKILL.md is 8.2 KB long, well organised into 61 sections with 13 code examples: a thorough specification that gives an agent plenty to work with.
With 2,444 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 5 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-04 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
resume-formatter compared with similar skills
All 4 of these similar skills score higher than resume-formatter; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| resume-formatter (this skill)by Paramchoudhary | 85 | 2.4k | 5mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install resume-formatter?
- Run
npx skills add Paramchoudhary/ResumeSkills --skill resume-formatter. The install tabs above show the steps for each supported agent. - Which AI agents does resume-formatter work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is resume-formatter safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is resume-formatter still maintained?
- The repository was last updated about 5 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: 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
- 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:
- ATS (Applicant Tracking Systems) - Robots that parse text
- 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
john.smith@email.com | (555) 123-4567 | linkedin.com/in/johnsmith
San Francisco, CA
Alternative Format
JOHN SMITH
San Francisco, CA
john.smith@email.com | (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
- Name - Largest, most prominent
- Section Headers - Clear divisions
- Job Titles/Company Names - Easy to scan
- 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
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
