123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229
---
name: resume-builder
description: Build and produce a professional resume as a polished, correctly formatted .docx file. Use this skill whenever the user asks to create, update, tailor, or convert a resume. Always produces a .docx output using the docx npm package with the canonical formatting spec below. Never output resume content as plain text or markdown — always produce the file.
---
# Resume Builder
Produces a professional resume as a correctly formatted `.docx` file using the `docx` npm package.
---
## 2025/2026 Formatting Best Practices
This skill enforces layout rules grounded in modern resume standard practices:
- **Clean Single-Column Layout**: Multi-column layouts often confuse Applicant Tracking Systems (ATS) and make reading flow irregular. Single-column is canonical.
- **Arial Typography**: Standard Sans-Serif font ensures compatibility across all operating systems, screen reader software, and parser systems.
- **Optimized Margins**: Set at ~0.625" (900 DXA) to balance document density. It provides enough room for content while keeping adequate white space.
- **F-Shape Scan Support**: Visual layout highlights headers with a bottom border and uses clean indents so readers scan the top (summary/core skills) and bottom (education/notable projects) efficiently.
- **No Unicode Bullet Characters**: Bullet points use Word's native numbering config rather than raw bullet characters, preventing encoding issues in ATS databases.
---
## First-Run Calibration (Required Before Generating)
Ask these four questions in a single message before producing any code. Do not proceed until you have these answers:
1. **Personal Information**: Name, Location (City, State), Phone, Email, and LinkedIn profile link.
2. **Resume Length Target**: How long would you like your resume to be? (e.g., 1 page, 1.5 pages, 2 pages, etc.). Formatting rules remain constant, but block spacing will adjust to fit your target length.
3. **Local File Output Path**: Where would you like the final `.docx` file saved on your system? (Provide an absolute folder path or filename).
4. **Primary Content**: Paste your current resume, profile text, or career history.
---
## Canonical Formatting Spec
| Property | Value |
|---|---|
| Font | Arial (all elements) |
| Body text size | 20 half-points (10pt) |
| Section header size | 21 half-points (10.5pt) |
| Name size | 26 half-points (13pt) |
| Page size | US Letter: 12240 × 15840 DXA |
| Margins | 900 DXA all sides (~0.625") |
| Section header spacing | before: 140, after: 50 |
| Section header border | bottom single sz=6 color=000000 space=1 |
| Body paragraph spacing | after: 80 |
| Job header spacing | before: 120, after: 30 |
| Competency row spacing | after: 45 |
| Bullet indent | left: 440, hanging: 220 |
| Sub-bullet indent | left: 800, hanging: 220 |
| Contact line spacing | after: 100 |
---
## Document Structure
```
NAME (centered, bold, 26hp)
Contact line (centered, 20hp, after=100)
PROFESSIONAL SUMMARY (section header)
Summary paragraph (after=80)
CORE COMPETENCIES (section header)
Bold label + normal text rows (after=45 each)
WORK EXPERIENCE (section header)
Job title | Company (italic) | Location | Dates (before=120, after=30)
• Bold action verb + rest of bullet (after=24)
◦ Sub-bullets for nested items (after=20)
EDUCATION (section header)
University name (bold) + location + date
Degree line (italic)
NOTABLE PROJECTS (section header)
• Bold project name — description
```
---
## Node.js Build Pattern
```javascript
const {
Document, Packer, Paragraph, TextRun, AlignmentType,
LevelFormat, BorderStyle
} = require('docx');
const fs = require('fs');
const FONT = "Arial";
const SZ_BODY = 20;
const SZ_SECTION = 21;
const SZ_NAME = 26;
// Section header with bottom border
const sectionHeader = (text) => new Paragraph({
children: [new TextRun({ text, bold: true, size: SZ_SECTION, font: FONT })],
spacing: { before: 140, after: 50 },
border: { bottom: { style: BorderStyle.SINGLE, size: 6, color: "000000", space: 1 } },
});
// Name (centered)
const nameP = (name) => new Paragraph({
alignment: AlignmentType.CENTER,
children: [new TextRun({ text: name, bold: true, size: SZ_NAME, font: FONT })],
spacing: { before: 0, after: 0 },
});
// Contact line (centered)
const contactP = (text) => new Paragraph({
alignment: AlignmentType.CENTER,
children: [new TextRun({ text, size: SZ_BODY, font: FONT })],
spacing: { before: 0, after: 100 },
});
// Body paragraph
const bodyPara = (text, spacingAfter = 80) => new Paragraph({
children: [new TextRun({ text, size: SZ_BODY, font: FONT })],
spacing: { before: 0, after: spacingAfter },
});
// Competency row: "Bold label: " + normal text
const compLine = (boldLabel, rest) => new Paragraph({
children: [
new TextRun({ text: boldLabel, bold: true, size: SZ_BODY, font: FONT }),
new TextRun({ text: rest, size: SZ_BODY, font: FONT }),
],
spacing: { before: 0, after: 45 },
});
// Job header: Bold title | Italic company | italic location | italic dates
const jobHeader = (title, company, location, dates) => new Paragraph({
children: [
new TextRun({ text: title, bold: true, size: SZ_BODY, font: FONT }),
new TextRun({ text: " | ", size: SZ_BODY, font: FONT }),
new TextRun({ text: company, italics: true, size: SZ_BODY, font: FONT }),
new TextRun({ text: " | " + location + " | " + dates, italics: true, size: SZ_BODY, font: FONT }),
],
spacing: { before: 120, after: 30 },
});
// Top-level bullet: bold start + normal rest
const boldBullet = (boldPart, rest = "") => new Paragraph({
numbering: { reference: "bullets", level: 0 },
children: [
new TextRun({ text: boldPart, bold: true, size: SZ_BODY, font: FONT }),
...(rest ? [new TextRun({ text: rest, size: SZ_BODY, font: FONT })] : []),
],
spacing: { before: 0, after: 24 },
});
// Sub-bullet (indented, open circle)
const boldSubBullet = (boldPart, rest = "") => new Paragraph({
numbering: { reference: "sub-bullets", level: 0 },
children: [
new TextRun({ text: boldPart, bold: true, size: SZ_BODY, font: FONT }),
...(rest ? [new TextRun({ text: rest, size: SZ_BODY, font: FONT })] : []),
],
spacing: { before: 0, after: 20 },
});
const doc = new Document({
numbering: {
config: [
{
reference: "bullets",
levels: [{
level: 0,
format: LevelFormat.BULLET,
text: "\u2022",
alignment: AlignmentType.LEFT,
style: { paragraph: { indent: { left: 440, hanging: 220 } } },
}],
},
{
reference: "sub-bullets",
levels: [{
level: 0,
format: LevelFormat.BULLET,
text: "\u25E6",
alignment: AlignmentType.LEFT,
style: { paragraph: { indent: { left: 800, hanging: 220 } } },
}],
},
],
},
sections: [{
properties: {
page: {
size: { width: 12240, height: 15840 },
margin: { top: 900, right: 900, bottom: 900, left: 900 },
},
},
children: [ /* content here */ ],
}],
});
Packer.toBuffer(doc).then(buf => {
fs.writeFileSync("output_path_here", buf);
console.log("Done");
});
```
## Recommended Workflow: Interview, Formatting, and Manual Review
This tool focuses on automated formatting and structural layout. To ensure high-quality content, we suggest the following approach:
1. **AI Interview**: Get interviewed by your AI of choice to help extract, refine, and organize your experience, projects, and achievements into a clean raw text profile.
2. **Run this Skill**: Use this formatting skill to take that text base and compile it into a correctly structured `.docx` file.
3. **Manual Customization**: Open the resulting Word document and manually refine the bullet points so they sound authentic to your voice, verify all details, and ensure absolute accuracy.
## Contact Info
Format the contact line dynamically based on calibration answers:
`City, State Zip | Phone Number | Email Address | LinkedIn Profile`
---
## Pre-flight Checklist
- [ ] Font is Arial throughout (no Calibri, no Times)
- [ ] Body text is 20 half-points (10pt)
- [ ] Margins are 900 DXA (~0.625")
- [ ] Section headers have bottom border
- [ ] Bullets use numbering config (never unicode bullets as raw TextRun)
- [ ] Sub-bullets use separate `sub-bullets` reference at left=800
- [ ] Job headers: bold title, italic company/location/dates