Job Hunter
End-to-end job search assistant — from finding opportunities to landing interviews.
Quick Start
1. Set up candidate profile
Create a profile JSON for the user. Use the template at {baseDir}/references/profile-template.json as a starting point. Ask the user about:
- Target roles and seniority level
- Key skills and tools
- Location preferences (cities + remote)
- Salary expectations
- Dealbreakers and excluded companies
- Preferred industries/domains
Save as profile.json in the workspace.
2. Search for jobs
Use the web_search tool with multiple queries to cast a wide net:
site:linkedin.com/jobs "[role]" "[city]"
site:indeed.com "[role]" "[city]"
site:glassdoor.com/job "[role]" "[city]"
"[role]" "[city]" hiring 2025 2026
Expand keywords — don't just search one title. See {baseDir}/references/search-strategies.md for keyword expansion patterns.
Alternative: run the search script if Brave API is available:
{baseDir}/scripts/search_jobs.sh "CX Manager" --location "Amsterdam" --days 7
3. Evaluate fit
For each job found, run fit analysis:
python3 {baseDir}/scripts/analyze_fit.py --profile profile.json --jobs jobs.json --threshold 50
Or evaluate manually using this framework:
- Skill match (40%): Does user have 60%+ of required skills?
- Seniority match (25%): Right level — not over/under qualified?
- Location match (15%): Compatible location or remote?
- Domain match (10%): Preferred industry/domain?
- Red flags (10%): Excluded companies? Dealbreakers?
Score: 🟢 75+ great | 🟡 55-74 good | 🟠 40-54 stretch | 🔴 <40 skip
4. Present results
For each job, present:
- Role & Company with direct link
- Fit score with color indicator
- Why it's a match (top 3 skill matches)
- Gaps to address (missing skills to highlight as "eager to learn")
- Salary estimate if available
- Recommendation: Apply / Maybe / Skip
Application Support
Cover letters
Read {baseDir}/references/cover-letter-guide.md for structure and tone guidelines. Generate tailored cover letters that:
- Reference specific company details (not generic)
- Map user's experience to top 2-3 job requirements
- Include quantified achievements
- Stay under 350 words
Interview prep
Read {baseDir}/references/interview-prep.md for complete preparation framework. Help with:
- Company research summaries
- STAR stories for key requirements
- Tailored "tell me about yourself" script
- Salary negotiation talking points
- Questions to ask the interviewer
Salary research
bash {baseDir}/scripts/salary_research.sh "Job Title" "Location"
Cross-reference 3+ sources. In the Netherlands: factor in 8% holiday allowance, possible 13th month, pension.
Daily Brief Format
When running as a scheduled job search brief:
- New opportunities — jobs found in last 24h with fit scores and direct links
- Application status — updates on pending applications
- Action items — what to apply to today, follow-ups due
- Market intel — industry trends, salary movements, hiring patterns
Tracking
Maintain a job tracker with:
- Company, role, date found, source URL
- Fit score and recommendation
- Status:
new→applied→screening→interview→offer/rejected/ghosted - Applied/skipped with reason
- Contact info and follow-up dates
Tips for Agents
- Never apply on behalf of the user — present opportunities, let them decide
- Don't overwhelm — 3-5 quality matches beat 20 mediocre ones
- Track excluded companies — never suggest the same company twice after rejection
- Be honest about fit — stretches are okay to flag, but don't oversell poor matches
- Respect dealbreakers — if user said no customer service, don't suggest it even if "it's a great company"
- Update the profile — as you learn user preferences, refine the profile
- Celebrate wins — applied to a job? Got an interview? Acknowledge it