The Problem

Job seekers face a fragmented workflow: resumes need tailoring per application, ATS systems reject poorly formatted files, and interview prep requires translating resume bullets into STAR stories. Doing this manually is slow and inconsistent, and generic AI prompts lack the structured frameworks needed for credible career documents. This repo packages that domain knowledge into reusable, agent-executable skills.

What This Does

ResumeSkills is a collection of 20 markdown-based skills that give AI coding agents (Claude Code, Cursor, Gemini CLI, etc.) structured workflows for resume writing and job search tasks. Each skill in skills/ is a SKILL.md file containing instructions, frameworks, and output templates—for example, skills/resume-ats-optimizer/SKILL.md handles keyword matching, while skills/interview-prep-generator/SKILL.md generates STAR stories from a resume.

The repo is a fork of Paramchoudhary/ResumeSkills (1,748 stars) and is essentially a content pack, not a codebase. There is no executable logic, no runtime, and no API—just structured prompts. The value is in the curation: 20 distinct career workflows, from academic-cv-builder to salary-negotiation-prep.

How It Is Wired

There is no control flow to trace—this is a static content repository. Each skill is a standalone SKILL.md file that an agent reads and executes. The wiring is purely organizational:

  • skills/ — canonical skill definitions (20 files)
  • .claude/, .cursor/, .codex/, .gemini/, .windsurf/, .opencode/, .agent/ — identical copies of 7 skills, duplicated per agent platform for compatibility
  • .claude-plugin/config.json — plugin manifest for Claude Code

The duplication is deliberate: different agents look for skills in different directories. The cost is maintenance—updating a skill requires editing it in multiple places. The repo has no tests, no CI, and no build step; it is 31 markdown files and one JSON config. There is no external system interaction; skills only read and write local files.

How To Use It

Setup: No build required. The README documents three install methods. The recommended CLI approach:

# Install all 20 skills globally
npx skills add Paramchoudhary/ResumeSkills -g -y

# Or install to current project only
npx skills add Paramchoudhary/ResumeSkills -y

Manual install:

git clone https://github.com/Paramchoudhary/ResumeSkills.git
mkdir -p ~/.cursor/skills
cp -r ResumeSkills/skills/* ~/.cursor/skills/

Configuration: No environment variables or API keys. Each SKILL.md defines its own input/output expectations.

Running it: Invoke a skill by asking your agent to use it—e.g., in Claude Code, reference resume-ats-optimizer when analyzing a resume. There is no standalone entry point.

Real-World Use

A user applies to a software engineering role. They ask Claude Code to run job-description-analyzer on the posting, which returns a match score and gap list. They then run resume-tailor to adjust their master resume, followed by resume-ats-optimizer to verify keyword coverage. Finally, interview-prep-generator produces STAR stories from the tailored resume. All steps stay within the agent's context; no code changes hands.

Code Health & Issues

Static analysis of the repo structure found:

  • Medium/SDLC – No tests – no test files exist; the content is untested markdown, so output quality is unverified.
  • Medium/SDLC – No CI/CD – no .github/ or CI config; there is no automated check that skills remain valid across the 7 duplicated directories.

Beyond that: 7-way duplication of skills across agent folders is a maintenance risk—a fix in skills/executive-resume-writer/SKILL.md must be manually replicated to 7 other locations. The repo has a license (LICENSE) and no committed secrets.

The Bottom Line

This is a well-curated content pack, not software—useful for anyone who wants structured, career-focused prompts without writing them. The duplication across agent directories is a real maintenance burden, and the lack of tests means quality is unverified. Use it if you want a quick start with Claude Code or Cursor; fork it if you plan to customize skills long-term.