Skip to content
Back to search

ats-optimized-resume-agent-skill

This is an agent skill for coding agents like Claude code to use to tailor your resume, avoiding AI-generated wordings and automatically generate a concise and completely well-formatted resume in Docx for you.

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/sankaiai--ats-optimized-resume-agent-skill/badge.svg)](/listings/sankaiai--ats-optimized-resume-agent-skill)

HTML

<a href="/listings/sankaiai--ats-optimized-resume-agent-skill"><img src="/api/listings/sankaiai--ats-optimized-resume-agent-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.

Choose one of the five methods below. All of them let you pick between **global** (available in all your projects) or **project-based** (current project only).

---

Method 0 — Agent-Assisted (fastest)

Copy one of the prompts below and paste it directly into your coding agent (Claude Code, Cursor, Windsurf, etc.). Your agent will detect your OS and run the install automatically.

**Global install — available in all your projects (recommended):**

Please install the build-tailored-resume Claude Code skill for me globally. Clone the repo at https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git into a temporary directory, then run the install script with the user/global flag — install.sh --user on Mac/Linux, or install.ps1 -Scope user on Windows. After install, confirm it works by running resume-skill --help.

**Project-level install — current project only:**

Please install the build-tailored-resume Claude Code skill for this project only. Clone the repo at https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git into a temporary directory, then run the install script with the project flag. On Mac/Linux run: install.sh --project --project-path="$(pwd)". On Windows run: powershell.exe -ExecutionPolicy Bypass -File install.ps1 -Scope project -ProjectPath "$(pwd)". After install, confirm it works by running resume-skill --help.

Then invoke it:

/build-tailored-resume

---

Method 1 — Direct Clone

Clone the repository directly into your skills directory. Requires two commands: one to clone, one to install the Python CLI.

**Global — all projects:**

Mac / Linux:

git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git ~/.claude/skills/build-tailored-resume
pip install ~/.claude/skills/build-tailored-resume/renderer

Windows (PowerShell):

git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git "$HOME\.claude\skills\build-tailored-resume"
pip install "$HOME\.claude\skills\build-tailored-resume\renderer"

**Project-level — current project only:**

Mac / Linux:

git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git .claude/skills/build-tailored-resume
pip install .claude/skills/build-tailored-resume/renderer

Windows (PowerShell):

git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git ".claude\skills\build-tailored-resume"
pip install ".claude\skills\build-tailored-resume\renderer"

Then invoke it:

/build-tailored-resume

---

Method 2 — Install Script (recommended for most users)

**Step 1 — Download**

git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git
cd ats-optimized-resume-agent-skill

**Step 2 — Run the script**

Mac / Linux:

chmod +x install.sh
./install.sh

Windows (PowerShell):

.\install.ps1

Both scripts ask you to choose a scope:

[1] User    — available in ALL your projects (recommended)
[2] Project — current project only, shared with your team via git
[3] Local   — current project only, NOT committed to git

You can also skip the prompt by passing the scope directly:

./install.sh --user       # Mac/Linux
./install.sh --project
./install.sh --local

.\install.ps1 -Scope user      # Windows
.\install.ps1 -Scope project
.\install.ps1 -Scope local

Then invoke it:

/build-tailored-resume

---

Method 3 — Manual Install

**Step 1 — Download**

git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git
cd ats-optimized-resume-agent-skill

**Step 2 — Install the Python CLI**

pip install renderer/

**Step 3 — Copy SKILL.md to the right location**

**Global — available in all your projects:**

# Mac/Linux
mkdir -p ~/.claude/skills/build-tailored-resume
cp SKILL.md ~/.claude/skills/build-tailored-resume/SKILL.md
# Windows (PowerShell)

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.

.claude-plugin/marketplace.json · Manifest · 31 lines

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

  1. {
  2. "name": "resume-skill-marketplace",
  3. "owner": {
  4. "name": "SankaiAI",
  5. "email": "your-email@example.com"
  6. },
  7. "metadata": {
  8. "description": "Community marketplace for the resume-skill Claude Code plugin",
  9. "version": "0.1.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "resume-skill",
  14. "description": "Transforms a master resume and job description into a tailored, ATS-optimized Word document (.docx) with human-sounding bullets and deterministic table-based layout.",
  15. "version": "0.1.0",
  16. "source": {
  17. "source": "github",
  18. "repo": "SankaiAI/ats-optimized-resume-agent-skill",
  19. "ref": "main"
  20. },
  21. "author": {
  22. "name": "SankaiAI"
  23. },
  24. "homepage": "https://github.com/SankaiAI/ats-optimized-resume-agent-skill#readme",
  25. "repository": "https://github.com/SankaiAI/ats-optimized-resume-agent-skill",
  26. "license": "MIT",
  27. "keywords": ["resume", "docx", "ats", "job-search", "career"],
  28. "category": "productivity"
  29. }
  30. ]
  31. }
README.md · README · 1,021 lines

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

  1. [English](#english) | [中文](#chinese)
  2. ---
  3. <a id="english"></a>
  4. # resume-skill — build-tailored-resume
  5. A Claude Code skill that transforms a master resume and a target job description into a polished, tailored Word document (.docx).
  6. Once installed, invoke it in Claude Code with:
  7. ```
  8. /build-tailored-resume
  9. ```
  10. ---
  11. ## ⚡ For AI Coding Agents — Read This First
  12. > **If you are an AI coding agent (Claude Code, Cursor, Windsurf, OpenClaw, or similar):**
  13. > The user wants to install this repository as a usable skill. This skill requires both a `SKILL.md` copy and a Python CLI install (`python-docx`, `lxml`). Run the single command below that matches the user's OS and scope — the install script handles both steps automatically.
  14. >
  15. > **Claude Code — Mac / Linux (global, all projects):**
  16. > ```bash
  17. > git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume && chmod +x /tmp/build-tailored-resume/install.sh && /tmp/build-tailored-resume/install.sh --user
  18. > ```
  19. >
  20. > **Claude Code — Mac / Linux (project-level, current project only):**
  21. > ```bash
  22. > git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume && chmod +x /tmp/build-tailored-resume/install.sh && /tmp/build-tailored-resume/install.sh --project
  23. > ```
  24. >
  25. > **Claude Code — Windows (global, all projects):**
  26. > ```powershell
  27. > git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git $env:TEMP\build-tailored-resume; & "$env:TEMP\build-tailored-resume\install.ps1" -Scope user
  28. > ```
  29. >
  30. > **Claude Code — Windows (project-level, current project only):**
  31. > ```bash
  32. > git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume && powershell.exe -ExecutionPolicy Bypass -File /tmp/build-tailored-resume/install.ps1 -Scope project -ProjectPath "$(pwd)"
  33. > ```
  34. >
  35. > **OpenClaw or other agents — Mac / Linux (global):**
  36. > ```bash
  37. > git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume && chmod +x /tmp/build-tailored-resume/install.sh && /tmp/build-tailored-resume/install.sh --user
  38. > ```
  39. >
  40. > After install completes, confirm with `resume-skill --help`, then tell the user:
  41. > *"The build-tailored-resume skill is installed. Type `/build-tailored-resume` to get started. Have your master resume and the target job description ready."*
  42. ---
  43. ## Table of Contents
  44. - [For AI Coding Agents](#-for-ai-coding-agents--read-this-first)
  45. - [What you need to provide](#what-you-need-to-provide)
  46. - [How it works](#how-it-works)
  47. - [Requirements](#requirements)
  48. - [Installation](#installation)
  49. - [Method 0 — Agent-Assisted (fastest)](#method-0--agent-assisted-fastest)
  50. - [Method 1 — Direct Clone](#method-1--direct-clone)
  51. - [Method 2 — Install Script](#method-2--install-script-recommended-for-most-users)
  52. - [Method 3 — Manual Install](#method-3--manual-install)
  53. - [Method 4 — Plugin Marketplace](#method-4--plugin-marketplace)
  54. - [Update](#update)
  55. - [Agent-Assisted Update](#agent-assisted-update-fastest)
  56. - [Manual Update](#manual-update)
  57. - [Verify the install](#verify-the-install)
  58. - [Uninstall](#uninstall)
  59. ---
  60. ## What you need to provide
  61. ### Required
  62. | Input | What it should contain |
  63. |-------|------------------------|
  64. | **Master resume** | Every role, bullet, project, skill, and metric you have ever done — the more complete, the better. The skill selects and rewrites from this pool; it does not invent. Accepted formats: `.docx`, `.pdf`, `.txt`, `.md`, or pasted text. |
  65. | **Job description** | The full JD for the role you are applying to. Paste it as text or drop a `.md`/`.txt` file. |
  66. | **Company name** | The name of the hiring company. |
  67. ### Optional (the skill infers these if not provided)
  68. | Input | Effect |
  69. |-------|--------|
  70. | LinkedIn / GitHub / portfolio URL | Added as clickable links in the header |
  71. | Career level | Controls section order and bullet depth. One of: `new_grad`, `entry_level`, `mid_level`, `senior_ic`, `manager`, `director` |
  72. | Page preference | `one_page` or `two_page`. Defaults to what fits the content. |
  73. | Tone | `conservative`, `modern_professional`, `technical`, or `analytical` |
  74. | Roles or projects to emphasize or exclude | Overrides the skill's default selection logic |
  75. | Metrics you are confident defending | Prevents the skill from softening numbers that are accurate |
  76. ### Tips for your master resume
  77. - **Include everything** — roles you think are irrelevant, old projects, side work. The skill decides what to cut.
  78. - **Keep raw bullets, not polished ones** — the skill rewrites for you. Messy input is fine.
  79. - **Add numbers wherever you have them** — even rough ones ("~50 users", "saved about 3 hours/week"). The skill will not invent metrics you do not provide.
  80. ---
  81. ## How it works
  82. ```
  83. ┌─────────────────────────────────────────────────────────────────────┐
  84. │ USER PROVIDES │
  85. │ master resume + job description + company │
  86. └──────────────────────────────┬──────────────────────────────────────┘
  87. │
  88. v
  89. ┌─────────────────────────┐
  90. │ STAGE 1: INTAKE │ Normalize all inputs.
  91. │ (required) │ Ask only if something
  92. │ │ critical is missing.
  93. └────────────┬────────────┘
  94. │ GATE 1: candidate data + JD + company exist
  95. v
  96. ┌─────────────────────────┐
  97. │ STAGE 2: JD ANALYSIS │ Extract required skills,
  98. │ (required) │ ATS keywords, seniority
  99. │ │ signals, domain language.
  100. └────────────┬────────────┘
  101. │ GATE 2: keywords + seniority identified
  102. │
  103. ┌─────────┴──────────┐
  104. │ │
  105. v v
  106. ┌────────────────────┐ ┌─────────────────────┐
  107. │ STAGE 2a: COMPANY │ │ STAGE 2b: TEAM │
  108. │ RESEARCH │ │ INFERENCE │
  109. │ (optional) │ │ (optional) │
  110. │ │ │ │
  111. │ Runs when company │ │ Runs when JD hints │
  112. │ context is not │ │ at team structure │
  113. │ obvious from JD. │ │ or reporting line. │
  114. │ Uses web search. │ │ │
  115. └────────────────────┘ └─────────────────────┘
  116. │ │
  117. └─────────┬──────────┘
  118. v
  119. ┌─────────────────────────┐
  120. │ STAGE 3: STRATEGY │ Decide: which strengths
  121. │ (required) │ to lead with, what to
  122. │ │ downplay, section order,
  123. │ │ page target, summary Y/N.
  124. └────────────┬────────────┘
  125. │ GATE 3: strategy written, section order set
  126. v
  127. ┌─────────────────────────┐
  128. │ STAGE 4: CONTENT │ Select bullets by fit
  129. │ TAILORING │ (not recency). Rewrite
  130. │ (required) │ in human-professional
  131. │ │ style. Humanization pass.
  132. └────────────┬────────────┘
  133. │ GATE 4: all bullets rewritten + humanization
  134. │ pass complete + no unsupported claims
  135. v
  136. ┌─────────────────────────┐
  137. │ STAGE 5: ATS CHECK │ Verify JD keywords land
  138. │ (required) │ naturally. Check headings,
  139. │ │ dates, contact format.
  140. └────────────┬────────────┘
  141. │ GATE 5: all ATS checks pass
  142. v
  143. ┌─────────────────────────┐
  144. │ STAGE 6: RENDER │ Generate JSON schema.
  145. │ (required) │ Run resume-skill render.
  146. │ │ Produce .docx file.
  147. └────────────┬────────────┘
  148. │ GATE 6: schema validation PASS + DOCX written
  149. v
  150. ┌─────────────────────────┐
  151. │ STAGE 7: VALIDATE │ Final checks: no placeholders,
  152. │ (required) │ section order matches strategy,
  153. │ │ bullet counts fit page target.
  154. └────────────┬────────────┘
  155. │
  156. v
  157. ┌───────────────────────────────┐
  158. │ OUTPUT │
  159. │ tailored_resume.docx │
  160. │ + strategy summary │
  161. │ + ATS keywords matched │
  162. │ + any honest gaps flagged │
  163. └───────────────────────────────┘
  164. ```
  165. **Sequencing is enforced.** The skill cannot:
  166. - Draft bullets before JD analysis is complete
  167. - Run the ATS check before bullets are selected and rewritten
  168. - Render the DOCX before content validation passes
  169. - Deliver the final file before JSON schema validation passes
  170. ---
  171. ## Requirements
  172. - Python 3.10 or later
  173. - `pip` in PATH
  174. - Claude Code installed
  175. ---
  176. ## Installation
  177. Choose one of the five methods below. All of them let you pick between **global** (available in all your projects) or **project-based** (current project only).
  178. ---
  179. ### Method 0 — Agent-Assisted (fastest)
  180. Copy one of the prompts below and paste it directly into your coding agent (Claude Code, Cursor, Windsurf, etc.). Your agent will detect your OS and run the install automatically.
  181. **Global install — available in all your projects (recommended):**
  182. ```
  183. Please install the build-tailored-resume Claude Code skill for me globally. Clone the repo at https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git into a temporary directory, then run the install script with the user/global flag — install.sh --user on Mac/Linux, or install.ps1 -Scope user on Windows. After install, confirm it works by running resume-skill --help.
  184. ```
  185. **Project-level install — current project only:**
  186. ```
  187. Please install the build-tailored-resume Claude Code skill for this project only. Clone the repo at https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git into a temporary directory, then run the install script with the project flag. On Mac/Linux run: install.sh --project --project-path="$(pwd)". On Windows run: powershell.exe -ExecutionPolicy Bypass -File install.ps1 -Scope project -ProjectPath "$(pwd)". After install, confirm it works by running resume-skill --help.
  188. ```
  189. Then invoke it:
  190. ```
  191. /build-tailored-resume
  192. ```
  193. ---
  194. ### Method 1 — Direct Clone
  195. Clone the repository directly into your skills directory. Requires two commands: one to clone, one to install the Python CLI.
  196. **Global — all projects:**
  197. Mac / Linux:
  198. ```bash
  199. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git ~/.claude/skills/build-tailored-resume
  200. pip install ~/.claude/skills/build-tailored-resume/renderer
  201. ```
  202. Windows (PowerShell):
  203. ```powershell
  204. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git "$HOME\.claude\skills\build-tailored-resume"
  205. pip install "$HOME\.claude\skills\build-tailored-resume\renderer"
  206. ```
  207. **Project-level — current project only:**
  208. Mac / Linux:
  209. ```bash
  210. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git .claude/skills/build-tailored-resume
  211. pip install .claude/skills/build-tailored-resume/renderer
  212. ```
  213. Windows (PowerShell):
  214. ```powershell
  215. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git ".claude\skills\build-tailored-resume"
  216. pip install ".claude\skills\build-tailored-resume\renderer"
  217. ```
  218. Then invoke it:
  219. ```
  220. /build-tailored-resume
  221. ```
  222. ---
  223. ### Method 2 — Install Script (recommended for most users)
  224. **Step 1 — Download**
  225. ```bash
  226. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git
  227. cd ats-optimized-resume-agent-skill
  228. ```
  229. **Step 2 — Run the script**
  230. Mac / Linux:
  231. ```bash
  232. chmod +x install.sh
  233. ./install.sh
  234. ```
  235. Windows (PowerShell):
  236. ```powershell
  237. .\install.ps1
  238. ```
  239. Both scripts ask you to choose a scope:
  240. ```
  241. [1] User — available in ALL your projects (recommended)
  242. [2] Project — current project only, shared with your team via git
  243. [3] Local — current project only, NOT committed to git
  244. ```
  245. You can also skip the prompt by passing the scope directly:
  246. ```bash
  247. ./install.sh --user # Mac/Linux
  248. ./install.sh --project
  249. ./install.sh --local
  250. .\install.ps1 -Scope user # Windows
  251. .\install.ps1 -Scope project
  252. .\install.ps1 -Scope local
  253. ```
  254. Then invoke it:
  255. ```
  256. /build-tailored-resume
  257. ```
  258. ---
  259. ### Method 3 — Manual Install
  260. **Step 1 — Download**
  261. ```bash
  262. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git
  263. cd ats-optimized-resume-agent-skill
  264. ```
  265. **Step 2 — Install the Python CLI**
  266. ```bash
  267. pip install renderer/
  268. ```
  269. **Step 3 — Copy SKILL.md to the right location**
  270. **Global — available in all your projects:**
  271. ```bash
  272. # Mac/Linux
  273. mkdir -p ~/.claude/skills/build-tailored-resume
  274. cp SKILL.md ~/.claude/skills/build-tailored-resume/SKILL.md
  275. ```
  276. ```powershell
  277. # Windows (PowerShell)
  278. New-Item -ItemType Directory -Force "$HOME\.claude\skills\build-tailored-resume"
  279. Copy-Item SKILL.md "$HOME\.claude\skills\build-tailored-resume\SKILL.md"
  280. ```
  281. **Project-based — current project only:**
  282. ```bash
  283. # Mac/Linux
  284. mkdir -p .claude/skills/build-tailored-resume
  285. cp /path/to/resume-skill/SKILL.md .claude/skills/build-tailored-resume/SKILL.md
  286. ```
  287. ```powershell
  288. # Windows (PowerShell)
  289. New-Item -ItemType Directory -Force ".claude\skills\build-tailored-resume"
  290. Copy-Item C:\path\to\resume-skill\SKILL.md ".claude\skills\build-tailored-resume\SKILL.md"
  291. ```
  292. To share with your team, commit the file:
  293. ```bash
  294. git add .claude/skills/build-tailored-resume/SKILL.md
  295. git commit -m "Add build-tailored-resume skill"
  296. ```
  297. To keep it local only, add it to `.gitignore`:
  298. ```bash
  299. echo ".claude/skills/" >> .gitignore
  300. ```
  301. Then invoke it:
  302. ```
  303. /build-tailored-resume
  304. ```
  305. ---
  306. ### Method 4 — Plugin Marketplace
  307. Open Claude Code and run:
  308. ```
  309. /plugin install resume-skill
  310. ```
  311. Choose your scope when prompted, or pass it directly:
  312. ```bash
  313. /plugin install resume-skill # global — all your projects
  314. /plugin install resume-skill --project # current project only, committed to git
  315. /plugin install resume-skill --local # current project only, not committed
  316. ```
  317. Then invoke it:
  318. ```
  319. /resume-skill:build-tailored-resume
  320. ```
  321. ---
  322. ## Update
  323. ### Agent-Assisted Update (fastest)
  324. Copy one of the prompts below and paste it into your coding agent. It will pull the latest changes and reinstall everything automatically.
  325. **Global install:**
  326. ```
  327. Please update my build-tailored-resume Claude Code skill to the latest version. Clone the latest repo from https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git into a temporary directory, then run the install script with the user/global flag — install.sh --user on Mac/Linux, or install.ps1 -Scope user on Windows. After update, confirm with resume-skill --help.
  328. ```
  329. **Project-level install:**
  330. ```
  331. Please update my build-tailored-resume Claude Code skill to the latest version. Clone the latest repo from https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git into a temporary directory, then run the install script with the project flag — install.sh --project on Mac/Linux, or install.ps1 -Scope project on Windows. After update, confirm with resume-skill --help.
  332. ```
  333. ---
  334. ### Manual Update
  335. **If you installed via Method 1 (Direct Clone):**
  336. Pull the latest changes and reinstall the Python CLI:
  337. ```bash
  338. # Mac/Linux
  339. cd ~/.claude/skills/build-tailored-resume # global
  340. # or: cd .claude/skills/build-tailored-resume # project-level
  341. git pull
  342. pip install renderer/ --upgrade
  343. ```
  344. ```powershell
  345. # Windows (PowerShell)
  346. cd "$HOME\.claude\skills\build-tailored-resume" # global
  347. # or: cd ".claude\skills\build-tailored-resume" # project-level
  348. git pull
  349. pip install renderer\ --upgrade
  350. ```
  351. **If you installed via Method 2 (Install Script):**
  352. Re-clone and re-run the script — it overwrites `SKILL.md` and upgrades the Python CLI in one step:
  353. ```bash
  354. # Mac/Linux
  355. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume
  356. chmod +x /tmp/build-tailored-resume/install.sh
  357. /tmp/build-tailored-resume/install.sh --user # or --project
  358. ```
  359. ```powershell
  360. # Windows (PowerShell)
  361. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git $env:TEMP\build-tailored-resume
  362. & "$env:TEMP\build-tailored-resume\install.ps1" -Scope user # or -Scope project
  363. ```
  364. **If you installed via Method 3 (Manual):**
  365. Re-clone, reinstall the Python CLI, and copy the updated `SKILL.md`:
  366. ```bash
  367. # Mac/Linux
  368. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume
  369. pip install /tmp/build-tailored-resume/renderer --upgrade
  370. cp /tmp/build-tailored-resume/SKILL.md ~/.claude/skills/build-tailored-resume/SKILL.md # global
  371. # or: cp /tmp/build-tailored-resume/SKILL.md .claude/skills/build-tailored-resume/SKILL.md # project
  372. ```
  373. ```powershell
  374. # Windows (PowerShell)
  375. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git $env:TEMP\build-tailored-resume
  376. pip install "$env:TEMP\build-tailored-resume\renderer" --upgrade
  377. Copy-Item "$env:TEMP\build-tailored-resume\SKILL.md" "$HOME\.claude\skills\build-tailored-resume\SKILL.md" # global
  378. # or: Copy-Item "$env:TEMP\build-tailored-resume\SKILL.md" ".claude\skills\build-tailored-resume\SKILL.md" # project
  379. ```
  380. ---
  381. ## Verify the install
  382. Open a new Claude Code session, type `/`, and confirm **`/build-tailored-resume`** appears in the list.
  383. From the terminal:
  384. ```bash
  385. resume-skill --help
  386. ```
  387. ---
  388. ## Uninstall
  389. **Mac / Linux:**
  390. ```bash
  391. rm -rf ~/.claude/skills/build-tailored-resume # global scope
  392. rm -rf .claude/skills/build-tailored-resume # project scope
  393. pip uninstall resume-skill
  394. ```
  395. **Windows (PowerShell):**
  396. ```powershell
  397. Remove-Item -Recurse -Force "$HOME\.claude\skills\build-tailored-resume" # global
  398. Remove-Item -Recurse -Force ".claude\skills\build-tailored-resume" # project
  399. pip uninstall resume-skill
  400. ```
  401. ---
  402. <a id="chinese"></a>
  403. # resume-skill — build-tailored-resume
  404. 一个 Claude Code 技能插件,将你的完整简历母版和目标职位描述转化为一份精致、定向的 Word 文档(.docx)。
  405. 安装后,在 Claude Code 中输入以下命令即可调用:
  406. ```
  407. /build-tailored-resume
  408. ```
  409. ---
  410. ## ⚡ 致 AI 编程代理 — 请优先阅读此节
  411. > **如果你是 AI 编程代理(Claude Code、Cursor、Windsurf、OpenClaw 或同类工具):**
  412. > 用户希望将此仓库安装为可用技能。此技能需要同时完成 `SKILL.md` 复制和 Python CLI 安装(`python-docx`、`lxml`)。请根据用户的操作系统和安装范围,运行下方对应的单条命令——安装脚本会自动处理两个步骤。
  413. >
  414. > **Claude Code — Mac / Linux(全局,所有项目可用):**
  415. > ```bash
  416. > git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume && chmod +x /tmp/build-tailored-resume/install.sh && /tmp/build-tailored-resume/install.sh --user
  417. > ```
  418. >
  419. > **Claude Code — Mac / Linux(项目级,仅当前项目):**
  420. > ```bash
  421. > git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume && chmod +x /tmp/build-tailored-resume/install.sh && /tmp/build-tailored-resume/install.sh --project
  422. > ```
  423. >
  424. > **Claude Code — Windows(全局,所有项目可用):**
  425. > ```powershell
  426. > git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git $env:TEMP\build-tailored-resume; & "$env:TEMP\build-tailored-resume\install.ps1" -Scope user
  427. > ```
  428. >
  429. > **Claude Code — Windows(项目级,仅当前项目):**
  430. > ```bash
  431. > git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume && powershell.exe -ExecutionPolicy Bypass -File /tmp/build-tailored-resume/install.ps1 -Scope project -ProjectPath "$(pwd)"
  432. > ```
  433. >
  434. > **OpenClaw 或其他代理 — Mac / Linux(全局):**
  435. > ```bash
  436. > git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume && chmod +x /tmp/build-tailored-resume/install.sh && /tmp/build-tailored-resume/install.sh --user
  437. > ```
  438. >
  439. > 安装完成后,运行 `resume-skill --help` 确认成功,然后告知用户:
  440. > *"build-tailored-resume 技能已安装完成。输入 `/build-tailored-resume` 即可开始使用。请准备好你的简历母版和目标职位描述。"*
  441. ---
  442. ## 目录
  443. - [致 AI 编程代理](#-致-ai-编程代理--请优先阅读此节)
  444. - [你需要提供什么](#你需要提供什么)
  445. - [工作流程](#工作流程)
  446. - [环境要求](#环境要求)
  447. - [安装方法](#安装方法)
  448. - [方法零 — 代理辅助安装(最快速)](#方法零--代理辅助安装最快速)
  449. - [方法一 — 直接克隆](#方法一--直接克隆)
  450. - [方法二 — 安装脚本](#方法二--安装脚本推荐大多数用户)
  451. - [方法三 — 手动安装](#方法三--手动安装)
  452. - [方法四 — 插件市场](#方法四--插件市场)
  453. - [更新](#更新)
  454. - [代理辅助更新](#代理辅助更新最快速)
  455. - [手动更新](#手动更新)
  456. - [验证安装](#验证安装)
  457. - [卸载](#卸载)
  458. ---
  459. ## 你需要提供什么
  460. ### 必填项
  461. | 输入内容 | 说明 |
  462. |---------|------|
  463. | **简历母版** | 你所有的工作经历、项目、技能和量化成果的完整记录——越详细越好。插件从中筛选和改写,不会凭空捏造内容。支持格式:`.docx`、`.pdf`、`.txt`、`.md` 或直接粘贴文字。 |
  464. | **职位描述(JD)** | 你申请职位的完整 JD。可以粘贴文字,或上传 `.md` / `.txt` 文件。 |
  465. | **目标公司名称** | 招聘方的公司名称。 |
  466. ### 选填项(未提供时插件自动推断)
  467. | 输入内容 | 效果 |
  468. |---------|------|
  469. | LinkedIn / GitHub / 作品集链接 | 以可点击超链接的形式出现在简历头部 |
  470. | 职级偏好 | 控制章节顺序和子弹点深度。可选:`new_grad`(应届)、`entry_level`(初级)、`mid_level`(中级)、`senior_ic`(高级独贡)、`manager`(管理层)、`director`(总监) |
  471. | 页数偏好 | `one_page`(单页)或 `two_page`(双页),默认按内容自适应 |
  472. | 风格偏好 | `conservative`(保守正式)、`modern_professional`(现代专业)、`technical`(技术导向)、`analytical`(数据分析) |
  473. | 需要重点突出或排除的经历 | 覆盖插件默认的筛选逻辑 |
  474. | 你能自信捍卫的量化数据 | 防止插件在改写时削弱你确认准确的数字 |
  475. ### 简历母版的填写建议
  476. - **包含所有内容** — 你认为不相关的岗位、老项目、兼职经历都写进去,插件来决定取舍。
  477. - **保留原始子弹点,不用提前润色** — 插件会替你改写,粗糙的输入没关系。
  478. - **尽量加上数字** — 哪怕是估算值("约 50 名用户"、"每周节省约 3 小时")。插件不会捏造你没有提供的指标。
  479. ---
  480. ## 工作流程
  481. ```
  482. ┌─────────────────────────────────────────────────────────────────────┐
  483. │ 用户输入 │
  484. │ 简历母版 + 职位描述 + 目标公司名称 │
  485. └──────────────────────────────┬──────────────────────────────────────┘
  486. │
  487. v
  488. ┌─────────────────────────┐
  489. │ 阶段 1:信息整理 │ 规范化所有输入。
  490. │ (必要) │ 仅在关键信息缺失时
  491. │ │ 追问用户。
  492. └────────────┬────────────┘
  493. │ 关卡 1:候选人信息 + JD + 公司名称均已就绪
  494. v
  495. ┌─────────────────────────┐
  496. │ 阶段 2:JD 分析 │ 提取必要技能、ATS 关键词、
  497. │ (必要) │ 职级信号、行业语言。
  498. └────────────┬────────────┘
  499. │ 关卡 2:关键词与职级已识别
  500. │
  501. ┌─────────┴──────────┐
  502. │ │
  503. v v
  504. ┌────────────────────┐ ┌─────────────────────┐
  505. │ 阶段 2a:公司调研 │ │ 阶段 2b:团队推断 │
  506. │ (可选) │ │ (可选) │
  507. │ │ │ │
  508. │ 当 JD 中公司背景 │ │ 当 JD 暗示团队结构 │
  509. │ 不明显时触发。 │ │ 或汇报关系时触发。 │
  510. │ 使用网络搜索。 │ │ │
  511. └────────────────────┘ └─────────────────────┘
  512. │ │
  513. └─────────┬──────────┘
  514. v
  515. ┌─────────────────────────┐
  516. │ 阶段 3:策略制定 │ 确定:主打优势、淡化内容、
  517. │ (必要) │ 首页叙事、章节顺序、
  518. │ │ 是否包含摘要、页数目标。
  519. └────────────┬────────────┘
  520. │ 关卡 3:策略已定,章节顺序已设置
  521. v
  522. ┌─────────────────────────┐
  523. │ 阶段 4:内容定制 │ 按匹配度(而非时间顺序)
  524. │ (必要) │ 筛选子弹点,以人性化
  525. │ │ 专业风格改写,完成
  526. │ │ 去 AI 化检查。
  527. └────────────┬────────────┘
  528. │ 关卡 4:所有子弹点已改写 + 去 AI 化检查通过
  529. │ + 无无依据声明
  530. v
  531. ┌─────────────────────────┐
  532. │ 阶段 5:ATS 检查 │ 验证 JD 关键词自然出现。
  533. │ (必要) │ 检查章节标题、日期、
  534. │ │ 联系方式格式。
  535. └────────────┬────────────┘
  536. │ 关卡 5:所有 ATS 检查通过
  537. v
  538. ┌─────────────────────────┐
  539. │ 阶段 6:渲染生成 │ 生成 JSON 结构数据。
  540. │ (必要) │ 执行 resume-skill render。
  541. │ │ 输出 .docx 文件。
  542. └────────────┬────────────┘
  543. │ 关卡 6:schema 验证通过 + DOCX 已生成
  544. v
  545. ┌─────────────────────────┐
  546. │ 阶段 7:最终验证 │ 检查:无占位符文字、
  547. │ (必要) │ 章节顺序符合策略、
  548. │ │ 子弹点数量匹配页数目标。
  549. └────────────┬────────────┘
  550. │
  551. v
  552. ┌───────────────────────────────┐
  553. │ 输出 │
  554. │ tailored_resume.docx │
  555. │ + 策略摘要 │
  556. │ + 匹配的 ATS 关键词 │
  557. │ + 诚实标注的潜在不足 │
  558. └───────────────────────────────┘
  559. ```
  560. **执行顺序强制保障。** 插件不允许:
  561. - 在 JD 分析完成前起草任何内容
  562. - 在子弹点筛选和改写完成前执行 ATS 检查
  563. - 在内容验证通过前渲染 DOCX
  564. - 在 JSON schema 验证通过前交付最终文件
  565. ---
  566. ## 环境要求
  567. - Python 3.10 或更高版本
  568. - `pip` 已加入系统 PATH
  569. - 已安装 Claude Code
  570. ---
  571. ## 安装方法
  572. 以下五种方法均支持选择**全局安装**(所有项目可用)或**项目级安装**(仅当前项目可用)。
  573. ---
  574. ### 方法零 — 代理辅助安装(最快速)
  575. 复制以下任意一段提示词,直接粘贴到你的编程代理(Claude Code、Cursor、Windsurf 等)的对话框中。代理会自动识别你的操作系统并完成安装。
  576. **全局安装 — 所有项目可用(推荐):**
  577. ```
  578. 请帮我全局安装 build-tailored-resume 这个 Claude Code 技能。将仓库 https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git 克隆到一个临时目录,然后用全局参数运行安装脚本——Mac/Linux 运行 install.sh --user,Windows 运行 install.ps1 -Scope user。安装完成后运行 resume-skill --help 确认安装成功。
  579. ```
  580. **项目级安装 — 仅当前项目可用:**
  581. ```
  582. 请帮我为当前项目安装 build-tailored-resume 这个 Claude Code 技能。将仓库 https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git 克隆到一个临时目录,然后用项目参数运行安装脚本。Mac/Linux 运行:install.sh --project --project-path="$(pwd)";Windows 运行:powershell.exe -ExecutionPolicy Bypass -File install.ps1 -Scope project -ProjectPath "$(pwd)"。安装完成后运行 resume-skill --help 确认安装成功。
  583. ```
  584. 安装后调用:
  585. ```
  586. /build-tailored-resume
  587. ```
  588. ---
  589. ### 方法一 — 直接克隆
  590. 将仓库直接克隆到技能目录。需要两条命令:克隆仓库 + 安装 Python CLI。
  591. **全局 — 所有项目可用:**
  592. Mac / Linux:
  593. ```bash
  594. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git ~/.claude/skills/build-tailored-resume
  595. pip install ~/.claude/skills/build-tailored-resume/renderer
  596. ```
  597. Windows(PowerShell):
  598. ```powershell
  599. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git "$HOME\.claude\skills\build-tailored-resume"
  600. pip install "$HOME\.claude\skills\build-tailored-resume\renderer"
  601. ```
  602. **项目级 — 仅当前项目:**
  603. Mac / Linux:
  604. ```bash
  605. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git .claude/skills/build-tailored-resume
  606. pip install .claude/skills/build-tailored-resume/renderer
  607. ```
  608. Windows(PowerShell):
  609. ```powershell
  610. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git ".claude\skills\build-tailored-resume"
  611. pip install ".claude\skills\build-tailored-resume\renderer"
  612. ```
  613. 安装后调用:
  614. ```
  615. /build-tailored-resume
  616. ```
  617. ---
  618. ### 方法二 — 安装脚本(推荐大多数用户)
  619. **第一步 — 下载**
  620. ```bash
  621. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git
  622. cd ats-optimized-resume-agent-skill
  623. ```
  624. **第二步 — 运行脚本**
  625. Mac / Linux:
  626. ```bash
  627. chmod +x install.sh
  628. ./install.sh
  629. ```
  630. Windows(PowerShell):
  631. ```powershell
  632. .\install.ps1
  633. ```
  634. 脚本会提示你选择作用域:
  635. ```
  636. [1] User — 所有项目可用(推荐)
  637. [2] Project — 仅当前项目,通过 git 与团队共享
  638. [3] Local — 仅当前项目,不提交到 git
  639. ```
  640. 也可以直接传入参数跳过交互提示:
  641. ```bash
  642. ./install.sh --user # Mac/Linux
  643. ./install.sh --project
  644. ./install.sh --local
  645. .\install.ps1 -Scope user # Windows
  646. .\install.ps1 -Scope project
  647. .\install.ps1 -Scope local
  648. ```
  649. 安装后调用:
  650. ```
  651. /build-tailored-resume
  652. ```
  653. ---
  654. ### 方法三 — 手动安装
  655. **第一步 — 下载**
  656. ```bash
  657. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git
  658. cd ats-optimized-resume-agent-skill
  659. ```
  660. **第二步 — 安装 Python CLI**
  661. ```bash
  662. pip install renderer/
  663. ```
  664. **第三步 — 将 SKILL.md 复制到正确位置**
  665. **全局 — 所有项目可用:**
  666. ```bash
  667. # Mac/Linux
  668. mkdir -p ~/.claude/skills/build-tailored-resume
  669. cp SKILL.md ~/.claude/skills/build-tailored-resume/SKILL.md
  670. ```
  671. ```powershell
  672. # Windows(PowerShell)
  673. New-Item -ItemType Directory -Force "$HOME\.claude\skills\build-tailored-resume"
  674. Copy-Item SKILL.md "$HOME\.claude\skills\build-tailored-resume\SKILL.md"
  675. ```
  676. **项目级 — 仅当前项目:**
  677. ```bash
  678. # Mac/Linux
  679. mkdir -p .claude/skills/build-tailored-resume
  680. cp /path/to/resume-skill/SKILL.md .claude/skills/build-tailored-resume/SKILL.md
  681. ```
  682. ```powershell
  683. # Windows(PowerShell)
  684. New-Item -ItemType Directory -Force ".claude\skills\build-tailored-resume"
  685. Copy-Item C:\path\to\resume-skill\SKILL.md ".claude\skills\build-tailored-resume\SKILL.md"
  686. ```
  687. 与团队共享时,提交该文件:
  688. ```bash
  689. git add .claude/skills/build-tailored-resume/SKILL.md
  690. git commit -m "Add build-tailored-resume skill"
  691. ```
  692. 仅本机使用时,添加到 `.gitignore`:
  693. ```bash
  694. echo ".claude/skills/" >> .gitignore
  695. ```
  696. 安装后调用:
  697. ```
  698. /build-tailored-resume
  699. ```
  700. ---
  701. ### 方法四 — 插件市场
  702. 在 Claude Code 中运行:
  703. ```
  704. /plugin install resume-skill
  705. ```
  706. 按提示选择作用域,或直接传入参数:
  707. ```bash
  708. /plugin install resume-skill # 全局 — 所有项目可用
  709. /plugin install resume-skill --project # 仅当前项目,提交到 git
  710. /plugin install resume-skill --local # 仅当前项目,不提交
  711. ```
  712. 安装后调用:
  713. ```
  714. /resume-skill:build-tailored-resume
  715. ```
  716. ---
  717. ## 更新
  718. ### 代理辅助更新(最快速)
  719. 复制以下提示词,粘贴到你的编程代理对话框中,代理会自动拉取最新版本并重新安装。
  720. **全局安装:**
  721. ```
  722. 请帮我将 build-tailored-resume Claude Code 技能更新到最新版本。将仓库 https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git 克隆到临时目录,然后用全局参数运行安装脚本——Mac/Linux 运行 install.sh --user,Windows 运行 install.ps1 -Scope user。完成后运行 resume-skill --help 确认更新成功。
  723. ```
  724. **项目级安装:**
  725. ```
  726. 请帮我将当前项目的 build-tailored-resume Claude Code 技能更新到最新版本。将仓库 https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git 克隆到临时目录,然后用项目参数运行安装脚本——Mac/Linux 运行 install.sh --project,Windows 运行 install.ps1 -Scope project。完成后运行 resume-skill --help 确认更新成功。
  727. ```
  728. ---
  729. ### 手动更新
  730. **方法一(直接克隆)安装的用户:**
  731. 拉取最新代码并重新安装 Python CLI:
  732. ```bash
  733. # Mac/Linux
  734. cd ~/.claude/skills/build-tailored-resume # 全局
  735. # 或: cd .claude/skills/build-tailored-resume # 项目级
  736. git pull
  737. pip install renderer/ --upgrade
  738. ```
  739. ```powershell
  740. # Windows(PowerShell)
  741. cd "$HOME\.claude\skills\build-tailored-resume" # 全局
  742. # 或: cd ".claude\skills\build-tailored-resume" # 项目级
  743. git pull
  744. pip install renderer\ --upgrade
  745. ```
  746. **方法二(安装脚本)安装的用户:**
  747. 重新克隆并运行脚本——一步完成 `SKILL.md` 覆盖和 Python CLI 升级:
  748. ```bash
  749. # Mac/Linux
  750. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume
  751. chmod +x /tmp/build-tailored-resume/install.sh
  752. /tmp/build-tailored-resume/install.sh --user # 或 --project
  753. ```
  754. ```powershell
  755. # Windows(PowerShell)
  756. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git $env:TEMP\build-tailored-resume
  757. & "$env:TEMP\build-tailored-resume\install.ps1" -Scope user # 或 -Scope project
  758. ```
  759. **方法三(手动安装)安装的用户:**
  760. 重新克隆、升级 Python CLI,并手动覆盖 `SKILL.md`:
  761. ```bash
  762. # Mac/Linux
  763. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git /tmp/build-tailored-resume
  764. pip install /tmp/build-tailored-resume/renderer --upgrade
  765. cp /tmp/build-tailored-resume/SKILL.md ~/.claude/skills/build-tailored-resume/SKILL.md # 全局
  766. # 或: cp /tmp/build-tailored-resume/SKILL.md .claude/skills/build-tailored-resume/SKILL.md # 项目级
  767. ```
  768. ```powershell
  769. # Windows(PowerShell)
  770. git clone https://github.com/SankaiAI/ats-optimized-resume-agent-skill.git $env:TEMP\build-tailored-resume
  771. pip install "$env:TEMP\build-tailored-resume\renderer" --upgrade
  772. Copy-Item "$env:TEMP\build-tailored-resume\SKILL.md" "$HOME\.claude\skills\build-tailored-resume\SKILL.md" # 全局
  773. # 或: Copy-Item "$env:TEMP\build-tailored-resume\SKILL.md" ".claude\skills\build-tailored-resume\SKILL.md" # 项目级
  774. ```
  775. ---
  776. ## 验证安装
  777. 打开新的 Claude Code 会话,输入 `/`,确认 **`/build-tailored-resume`** 出现在列表中。
  778. 在终端中验证:
  779. ```bash
  780. resume-skill --help
  781. ```
  782. ---
  783. ## 卸载
  784. **Mac / Linux:**
  785. ```bash
  786. rm -rf ~/.claude/skills/build-tailored-resume # 全局作用域
  787. rm -rf .claude/skills/build-tailored-resume # 项目作用域
  788. pip uninstall resume-skill
  789. ```
  790. **Windows(PowerShell):**
  791. ```powershell
  792. Remove-Item -Recurse -Force "$HOME\.claude\skills\build-tailored-resume" # 全局
  793. Remove-Item -Recurse -Force ".claude\skills\build-tailored-resume" # 项目
  794. pip uninstall resume-skill
  795. ```

Ratings and comments

Sign in to rate this skill.

Sign in

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