job-search — Claude Code skill: find jobs that match your resume
This skill runs a daily browser job search, scores each listing against your resume and preferences, and keeps only the ones worth your time.
npx skills add proficientlyjobs/proficiently-claude-skills --skill job-search -a claude-codeWhat job-search does
The skill loads your profile from DATA_DIR/resume/*, your preferences.md, and the job history so it can skip postings you have already seen. It then drives hiring.cafe through the Claude in Chrome MCP tools, entering search terms and applying filters for posting date and location. Terms come from the command argument, or from your target roles when you leave it out.
Listings are pulled with javascript_tool and a targeted selector rather than get_page_text. That matters: the full page text on a job board will blow out your context window. Each listing gets scored against your resume and preferences, everything is appended to job-history.md, and high-fit matches get followed through to the employer's careers page, where the posting is saved to DATA_DIR/jobs/[company-slug]-[date]/posting.md.
Both a resume and a preferences file are required, so the prerequisite check stops early without them. You also need to allow reads and writes under ~/.proficiently/**, crontab, and mcp__claude-in-chrome__* in ~/.claude/settings.json. If a linkedin-contacts.csv is present, the skill cross-references company names against it and tells you who you already know at each match. It won't rewrite your resume or fill in applications — separate commands handle that.
What it helps with
- find fresh postings matching a specific skill set
- skip duplicates from earlier searches
- score how well a posting fits your resume
- collect direct employer career-page links
- check whether you know anyone at the company
Example prompts for the agent
- /proficiently:job-search
- /proficiently:job-search AI infrastructure
- Run the search and show only new high-fit matches
How to install job-search
1Skills CLI (Vercel)
npx skills add proficientlyjobs/proficiently-claude-skills --skill job-search -a claude-code2Manually: put the files in place
~/.claude/skills/job-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/job-search/
1Skills CLI (Vercel)
npx skills add proficientlyjobs/proficiently-claude-skills --skill job-search -a codex2Manually: put the files in place
.agents/skills/job-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add proficientlyjobs/proficiently-claude-skills --skill job-search -a cursor2Manually: put the files in place
.cursor/skills/job-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install proficientlyjobs/proficiently-claude-skills job-search2Manually: put the files in place
.github/skills/job-search/SKILL.md1Skills CLI (Vercel)
npx skills add proficientlyjobs/proficiently-claude-skills --skill job-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/proficientlyjobs/proficiently-claude-skills --path skills/job-searchManually: put the files in place
.devin/skills/job-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add proficientlyjobs/proficiently-claude-skills --skill job-search -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about job-search
How do I install job-search in Claude?
Run npx skills add proficientlyjobs/proficiently-claude-skills --skill job-search -a claude-code. The skill then lives at ~/.claude/skills/job-search/SKILL.md.
What does job-search do?
It searches job boards in the browser using your terms, scores each listing against your resume and preferences, keeps a search history, and saves high-fit postings with a direct employer link.
What do I need before running job-search?
A resume and a preferences file — both are required. You also need Claude in Chrome MCP access and permissions for ~/.proficiently/** in ~/.claude/settings.json.
