Skip to content
Back to search

resume-tailoring-skill

AI-powered resume tailoring skill for Claude Code

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/varunr89--resume-tailoring-skill/badge.svg)](/listings/varunr89--resume-tailoring-skill)

HTML

<a href="/listings/varunr89--resume-tailoring-skill"><img src="/api/listings/varunr89--resume-tailoring-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Option 1: Install from GitHub (Recommended)

1. **Clone the repository:**

   git clone https://github.com/varunr89/resume-tailoring-skill.git ~/.claude/skills/resume-tailoring

2. **Verify installation:**

   ls ~/.claude/skills/resume-tailoring

You should see: `SKILL.md`, `research-prompts.md`, `matching-strategies.md`, `branching-questions.md`, `README.md`

3. **Restart Claude Code** (if already running)

Option 2: Manual Installation

1. **Create the skill directory:**

   mkdir -p ~/.claude/skills/resume-tailoring

2. **Download the files:** - Download all files from this repository - Place them in `~/.claude/skills/resume-tailoring/`

3. **Verify installation:** - Open Claude Code - Type `/skills` to see available skills - `resume-tailoring` should appear in the list

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 444 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Resume Tailoring Skill
  2. > AI-powered resume generation that researches roles, surfaces undocumented experiences, and creates tailored resumes from your existing resume library.
  3. **Mission:** Your ability to get a job should be based on your experiences and capabilities, not on your resume writing skills.
  4. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  5. ## Table of Contents
  6. - [Overview](#overview)
  7. - [Installation](#installation)
  8. - [Prerequisites](#prerequisites)
  9. - [Quick Start](#quick-start)
  10. - [Key Features](#key-features)
  11. - [Architecture](#architecture)
  12. - [Usage Examples](#usage-examples)
  13. - [Contributing](#contributing)
  14. - [License](#license)
  15. ## Overview
  16. This Claude Code skill generates high-quality, tailored resumes optimized for specific job descriptions while maintaining factual integrity. It goes beyond simple keyword matching by:
  17. - **Multi-Job Batch Processing:** Process 3-5 similar jobs efficiently with shared experience discovery (NEW!)
  18. - **Deep Research:** Analyzes company culture, role requirements, and success profiles
  19. - **Experience Discovery:** Surfaces undocumented experiences through conversational branching interviews
  20. - **Smart Matching:** Uses confidence-scored content selection with transparent gap identification
  21. - **Multi-Format Output:** Generates professional MD, DOCX, PDF, and interview prep reports
  22. - **Self-Improving:** Library grows with each successful resume
  23. ## Installation
  24. ### Option 1: Install from GitHub (Recommended)
  25. 1. **Clone the repository:**
  26. ```bash
  27. git clone https://github.com/varunr89/resume-tailoring-skill.git ~/.claude/skills/resume-tailoring
  28. ```
  29. 2. **Verify installation:**
  30. ```bash
  31. ls ~/.claude/skills/resume-tailoring
  32. ```
  33. You should see: `SKILL.md`, `research-prompts.md`, `matching-strategies.md`, `branching-questions.md`, `README.md`
  34. 3. **Restart Claude Code** (if already running)
  35. ### Option 2: Manual Installation
  36. 1. **Create the skill directory:**
  37. ```bash
  38. mkdir -p ~/.claude/skills/resume-tailoring
  39. ```
  40. 2. **Download the files:**
  41. - Download all files from this repository
  42. - Place them in `~/.claude/skills/resume-tailoring/`
  43. 3. **Verify installation:**
  44. - Open Claude Code
  45. - Type `/skills` to see available skills
  46. - `resume-tailoring` should appear in the list
  47. ## Prerequisites
  48. **Required:**
  49. - Claude Code with skills enabled
  50. - Existing resume library (at least 1-2 resumes in markdown format)
  51. **Optional but Recommended:**
  52. - WebSearch capability (for company research)
  53. - `document-skills` plugin (for DOCX/PDF generation)
  54. - 10+ resumes in your library for best results
  55. **Resume Library Setup:**
  56. Create a `resumes/` directory in your project:
  57. ```bash
  58. mkdir -p ~/resumes
  59. ```
  60. Add your existing resumes in markdown format:
  61. ```
  62. ~/resumes/
  63. ├── Resume_Company1_Role1.md
  64. ├── Resume_Company2_Role2.md
  65. └── Resume_General_2024.md
  66. ```
  67. ## Quick Start
  68. ### Single Job Application
  69. **1. Invoke the skill in Claude Code:**
  70. ```
  71. "I want to apply for [Role] at [Company]. Here's the JD: [paste job description]"
  72. ```
  73. **2. The skill will automatically:**
  74. 1. Build library from existing resumes
  75. 2. Research company and role
  76. 3. Create optimized template (with checkpoint)
  77. 4. Offer branching experience discovery
  78. 5. Match content with confidence scores (with checkpoint)
  79. 6. Generate MD + DOCX + PDF + Report
  80. 7. Optionally update library
  81. **3. Review and approve:**
  82. - Checkpoints at key decision points
  83. - Full transparency on content matching
  84. - Option to revise or approve at each stage
  85. ### Multiple Jobs (Batch Mode - NEW!)
  86. **1. Provide multiple job descriptions:**
  87. ```
  88. "I want to apply for these 3 roles:
  89. 1. [Company 1] - [Role]: [JD or URL]
  90. 2. [Company 2] - [Role]: [JD or URL]
  91. 3. [Company 3] - [Role]: [JD or URL]"
  92. ```
  93. **2. The skill will:**
  94. 1. Detect multi-job intent and offer batch mode
  95. 2. Build library once (shared across all jobs)
  96. 3. Analyze gaps across ALL jobs (deduplicates common requirements)
  97. 4. Conduct single discovery session addressing all gaps
  98. 5. Process each job individually (research + tailoring)
  99. 6. Present all resumes for batch review
  100. **3. Time savings:**
  101. - Shared discovery session (ask once, not 3-5 times)
  102. - 11-27% faster than processing jobs sequentially
  103. - Same quality as single-job mode
  104. ## Files
  105. ### Core Implementation
  106. - `SKILL.md` - Main skill implementation with single-job and multi-job workflows
  107. - `multi-job-workflow.md` - Complete multi-job batch processing workflow
  108. - `research-prompts.md` - Company/role research templates
  109. - `matching-strategies.md` - Content scoring algorithms
  110. - `branching-questions.md` - Experience discovery patterns
  111. ### Documentation
  112. - `README.md` - This file
  113. - `MARKETPLACE.md` - Marketplace listing information
  114. - `SUBMISSION_GUIDE.md` - Skill submission guidelines
  115. ### Supporting Documentation (`docs/`)
  116. - `docs/schemas/` - Data structure schemas for batch processing
  117. - `batch-state-schema.md` - Batch state tracking structure
  118. - `job-schema.md` - Job object schema
  119. - `docs/plans/` - Design documents and implementation plans
  120. - `2025-11-04-multi-job-resume-tailoring-design.md` - Multi-job feature design
  121. - `2025-11-04-multi-job-implementation-summary.md` - Implementation summary
  122. - `docs/testing/` - Testing checklists
  123. - `multi-job-test-checklist.md` - Comprehensive multi-job test cases
  124. ## Key Features
  125. **🚀 Multi-Job Batch Processing (NEW!)**
  126. - Process 3-5 similar jobs efficiently
  127. - Shared experience discovery (ask once, apply to all)
  128. - Aggregate gap analysis with deduplication
  129. - Time savings: 11-27% faster than sequential processing
  130. - Incremental batches (add more jobs later)
  131. **🔍 Deep Research**
  132. - Company culture and values
  133. - Role benchmarking via LinkedIn
  134. - Success profile synthesis
  135. **💬 Branching Discovery**
  136. - Conversational experience surfacing
  137. - Dynamic follow-up questions
  138. - Surfaces undocumented work
  139. - Multi-job context awareness
  140. **🎯 Smart Matching**
  141. - Confidence-scored content selection
  142. - Transparent gap identification
  143. - Truth-preserving reframing
  144. **📄 Multi-Format Output**
  145. - Professional markdown
  146. - ATS-friendly DOCX
  147. - Print-ready PDF
  148. - Interview prep report
  149. **🔄 Self-Improving**
  150. - Library grows with each resume
  151. - Successful patterns reused
  152. - New experiences captured
  153. ## Architecture
  154. ### Single-Job Workflow
  155. ```
  156. Phase 0: Library Build (always first)
  157. ↓
  158. Phase 1: Research (JD + Company + Role)
  159. ↓
  160. Phase 2: Template (Structure + Titles)
  161. ↓ [CHECKPOINT]
  162. Phase 2.5: Experience Discovery (Optional, Branching)
  163. ↓
  164. Phase 3: Assembly (Matching + Scoring)
  165. ↓ [CHECKPOINT]
  166. Phase 4: Generation (MD + DOCX + PDF + Report)
  167. ↓ [USER REVIEW]
  168. Phase 5: Library Update (Conditional)
  169. ```
  170. ### Multi-Job Workflow (NEW!)
  171. ```
  172. Phase 0: Intake & Batch Initialization
  173. ↓
  174. Phase 1: Aggregate Gap Analysis (deduplicates across all jobs)
  175. ↓
  176. Phase 2: Shared Experience Discovery (ask once, apply to all)
  177. ↓
  178. Phase 3: Per-Job Processing (research + template + matching + generation for each)
  179. ↓
  180. Phase 4: Batch Finalization (review all resumes, update library)
  181. ```
  182. **Time Savings:**
  183. - 3 jobs: ~40 min vs ~45 min sequential (11% savings)
  184. - 5 jobs: ~55 min vs ~75 min sequential (27% savings)
  185. See `multi-job-workflow.md` for complete details.
  186. ## Design Philosophy
  187. **Truth-Preserving Optimization:**
  188. - NEVER fabricate experience
  189. - Intelligently reframe and emphasize
  190. - Transparent about gaps
  191. **Holistic Person Focus:**
  192. - Surface undocumented experiences
  193. - Value volunteer work, side projects
  194. - Build around complete background
  195. **User Control:**
  196. - Checkpoints at key decisions
  197. - Options, not mandates
  198. - Can adjust or go back
  199. ## Usage Examples
  200. ### Example 1: Internal Role Transfer
  201. ```
  202. USER: "I want to apply for Principal PM role in 1ES team at Microsoft.
  203. Here's the JD: [paste]"
  204. RESULT:
  205. - Found 29 existing resumes
  206. - Researched Microsoft 1ES team culture
  207. - Featured PM2 Azure Eng Systems experience
  208. - Discovered: VS Code extension, AI side projects
  209. - 92% JD coverage, 75% direct matches
  210. - Generated tailored resume + interview prep report
  211. ```
  212. ### Example 2: Career Transition
  213. ```
  214. USER: "I'm a TPM transitioning to ecology PM. JD: [paste]"
  215. RESULT:
  216. - Reframed "Technical Program Manager" → "Program Manager, Environmental Systems"
  217. - Surfaced volunteer conservation work
  218. - Identified graduate research in environmental modeling
  219. - 65% JD coverage with clear gap analysis
  220. - Cover letter recommendations provided
  221. ```
  222. ### Example 3: Career Gap Handling
  223. ```
  224. USER: "I have a 2-year gap from starting a company. JD: [paste]"
  225. RESULT:
  226. - Included startup as legitimate role
  227. - Surfaced: fundraising, product development, team building
  228. - Framed gap as entrepreneurial experience
  229. - Generated resume showing initiative and diverse skills
  230. ```
  231. ### Example 4: Multi-Job Batch (NEW!)
  232. ```
  233. USER: "I want to apply for these 3 TPM roles:
  234. 1. Microsoft 1ES Principal PM
  235. 2. Google Cloud Senior TPM
  236. 3. AWS Container Services Senior PM"
  237. RESULT:
  238. - Detected multi-job mode, user confirmed
  239. - Built library once (29 resumes)
  240. - Gap analysis: 14 total gaps, 8 unique after deduplication
  241. - Shared discovery: 30-min session surfaced 5 new experiences
  242. * Kubernetes CI/CD for nonprofits
  243. * Azure migration for university lab
  244. * Cross-functional leadership examples
  245. - Processed 3 jobs: 85%, 88%, 78% JD coverage
  246. - Time: 40 minutes vs 45 minutes sequential (11% savings)
  247. - All 3 resumes + batch summary generated
  248. ```
  249. ### Example 5: Incremental Batch Addition (NEW!)
  250. ```
  251. WEEK 1: User processes 3 jobs (Microsoft, Google, AWS) in 40 minutes
  252. WEEK 2:
  253. USER: "I found 2 more jobs at Stripe and Meta. Add them to my batch?"
  254. RESULT:
  255. - Loaded existing batch with 5 previously discovered experiences
  256. - Incremental gap analysis: only 3 new gaps (vs 14 original)
  257. - Quick 10-min discovery session for new gaps only
  258. - Processed 2 additional jobs: 82%, 76% coverage
  259. - Time: 20 minutes (vs 30 if starting from scratch)
  260. - Total: 5 jobs, 8 experiences discovered
  261. ```
  262. ## Usage Patterns
  263. **Internal role (same company):**
  264. - Features most relevant internal experience
  265. - Uses internal terminology
  266. - Leverages organizational knowledge
  267. **External role (new company):**
  268. - Deep company research
  269. - Cultural fit emphasis
  270. - Risk mitigation
  271. **Career transition:**
  272. - Title reframing
  273. - Transferable skill emphasis
  274. - Bridge domain gaps
  275. **With career gaps:**
  276. - Gaps as valuable experience
  277. - Alternative activities highlighted
  278. - Truthful, positive framing
  279. ## Testing
  280. ### Single-Job Tests
  281. See Testing Guidelines section in SKILL.md (lines 1244-1320)
  282. **Key test scenarios:**
  283. - Happy path (full workflow)
  284. - Minimal library (2 resumes)
  285. - Research failures (obscure company)
  286. - Experience discovery value
  287. - Title reframing accuracy
  288. - Multi-format generation
  289. ### Multi-Job Tests (NEW!)
  290. See `docs/testing/multi-job-test-checklist.md` for comprehensive test cases
  291. **Key multi-job scenarios:**
  292. - Happy path (3 similar jobs)
  293. - Diverse jobs (low overlap detection)
  294. - Incremental batch addition
  295. - Pause/resume functionality
  296. - Individual vs batch review
  297. - Express mode processing
  298. - Error handling and graceful degradation
  299. **Run tests:**
  300. ```bash
  301. cd ~/.claude/skills/resume-tailoring
  302. # Single-job: Follow test procedures in SKILL.md Testing Guidelines section
  303. # Multi-job: Follow docs/testing/multi-job-test-checklist.md
  304. ```
  305. ## Contributing
  306. Contributions are welcome! Please follow these guidelines:
  307. 1. **Fork the repository**
  308. 2. **Create a feature branch:** `git checkout -b feature/amazing-feature`
  309. 3. **Make your changes:**
  310. - Update `SKILL.md` for implementation changes
  311. - Add tests if applicable
  312. - Update README if architecture changes
  313. 4. **Commit with descriptive messages:** `git commit -m "feat: add amazing feature"`
  314. 5. **Push to your fork:** `git push origin feature/amazing-feature`
  315. 6. **Open a Pull Request**
  316. **Before submitting:**
  317. - Run regression tests (see Testing section in SKILL.md)
  318. - Ensure all phases work end-to-end
  319. - Update documentation
  320. ## Troubleshooting
  321. **Skill not appearing:**
  322. - Verify files are in `~/.claude/skills/resume-tailoring/`
  323. - Restart Claude Code
  324. - Check SKILL.md has valid YAML frontmatter
  325. **Research phase failing:**
  326. - Check WebSearch capability is enabled
  327. - Skill will gracefully fall back to JD-only analysis
  328. **DOCX/PDF generation failing:**
  329. - Ensure `document-skills` plugin is installed
  330. - Skill will fall back to markdown-only output
  331. **Low match confidence:**
  332. - Try the Experience Discovery phase
  333. - Consider adding more resumes to your library
  334. - Review gap handling recommendations
  335. ## License
  336. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  337. ## Acknowledgments
  338. - Built for Claude Code skills framework
  339. - Designed with truth-preserving optimization principles
  340. - Inspired by the belief that job opportunities should be based on capabilities, not resume writing skills
  341. ## Support
  342. - **Issues:** [GitHub Issues](https://github.com/varunr89/resume-tailoring-skill/issues)
  343. - **Discussions:** [GitHub Discussions](https://github.com/varunr89/resume-tailoring-skill/discussions)
  344. ## Roadmap
  345. - [ ] Cover letter generation integration
  346. - [ ] LinkedIn profile optimization
  347. - [ ] Interview preparation Q&A generation
  348. - [ ] Multi-language resume support
  349. - [ ] Custom industry templates

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.