How k1anshul/ai-job-search works
This repository is a local, Claude Code–driven job-application framework. Its documented user journey runs from profile setup through posting discovery, ranking, tailored applications, interview preparation, and outcome tracking. The graph also preserves supporting capabilities for portal search, posting safety, document production, and salary benchmarking. Evidence is limited to the README and sampled/indexed source; unsampled subsystem links are omitted where their callers are not shown.
Main entry points: apply.md Application tailoring · job-scraper Posting scrape · setup.md Profile setup · rank.md Job ranking
Components 22
Application workflow
- Profile setup
.claude/commands/setup.md - Candidate profile
.claude/skills/job-application-assistant - Job ranking
.claude/commands/rank.md - Ranking state
tools/rank_state.py - Application tailoring
.claude/commands/apply.md - Interview prep
.claude/commands/interview.md - Outcome tracking
.claude/commands/outcome.md - Scrape state
tools/scrape_state.py
Job discovery
- Posting scrape
.claude/skills/job-scraper - Portal search
.agents/skills
Application materials
- CV templates
.claude/skills/job-application-assistant/05-cv-templates.md - Cover letters
cover_letters - PDF checks
tools/verify_pdf.py - Layout checks
tools/verify_layout.py
Safety and utilities
- Page fetching
tools/fetch_page.py - Posting integrity
tools/posting_guard.py - Page decoding
tools/page_decode.py - Salary benchmark
salary_lookup.py - Salary conversion
tools/convert_salary_excel.py
Other components
- Job seeker
- Claude Code
- Job portals
Connections 19
- Job seeker → Claude Code: uses
README.md - Claude Code → Profile setup: runs
README.md - Profile setup → Candidate profile: builds
README.md - Claude Code → Posting scrape: runs
README.md - Posting scrape → Portal search: searches
README.md - Portal search → Job portals: queries
- Claude Code → Job ranking: runs
README.md - Job ranking → Ranking state: records scores
tools/rank_state.py - Claude Code → Application tailoring: runs
README.md - Application tailoring → CV templates: tailors
README.md - Application tailoring → Cover letters: writes
README.md - Application tailoring → PDF checks: checks PDF
- Application tailoring → Layout checks: checks layout
- Claude Code → Interview prep: runs
README.md - Claude Code → Outcome tracking: runs
README.md - Posting scrape → Scrape state: tracks postings
- Page fetching → Page decoding: decodes pages
tools/page_decode.py - Posting integrity → Page decoding: decodes HTML
tools/posting_guard.py - Salary conversion → Salary benchmark: prepares data for
tools/convert_salary_excel.py