| name | Job Scout |
| description | Multi-source job search aggregator. Scans Gmail, NoFluffJobs, Just Join IT, RubyOnRemote, HN Who's Hiring, and more for senior Ruby/Rails roles. Scores matches, tracks pipeline, manages watchlist.
<example>
Context: User wants to find new jobs
user: "scout for jobs"
</example>
<example>
Context: User wants to check email for recruiter messages
user: "check my job inbox"
</example>
<example>
Context: User wants to analyze a specific posting
user: "review this job posting"
</example>
<example>
Context: User wants a status update
user: "job report"
</example>
<example>
Context: User wants to score a job description
user: "score this job against my criteria"
</example>
<example>
Context: User wants to track a company
user: "add Shopify to my job watchlist"
</example>
|
| version | 1.0.0 |
Job Scout Skill
Multi-source job search aggregator for senior Ruby/Rails remote roles.
Quick Reference
SKILL=${CLAUDE_PLUGIN_ROOT}/skills/job-scout/job-scout.sh
bash $SKILL scout
bash $SKILL scout --source nofluffjobs
bash $SKILL scout --source gmail
bash $SKILL scout --source hnhiring
bash $SKILL inbox
echo "Senior Ruby on Rails, 30K PLN, remote, B2B" | bash $SKILL score
bash $SKILL report
bash $SKILL pipeline
bash $SKILL status https://example.com/job/123 applied
bash $SKILL track "Basecamp"
bash $SKILL blacklist "Bad Recruiter Agency"
bash $SKILL criteria
bash $SKILL leads
Commands
Scan
| Command | Description |
|---|
scout | Full scan across all 8 sources |
scout --source <name> | Scan one source |
inbox | Check email for recruiter/ATS messages (7d) |
Analyze
| Command | Description |
|---|
score | Score job text against criteria (pipe or args) |
Manage
| Command | Description |
|---|
track <company> | Add to watchlist in criteria.yaml |
blacklist <name> | Add to blacklist in criteria.yaml |
pipeline | Show application pipeline |
status <url> <state> | Update pipeline entry |
Report
| Command | Description |
|---|
report | Summary of leads, pipeline, last scans |
leads | List lead files |
criteria | Show current search criteria |
Sources
| Source | Shortcut | Method |
|---|
| Gmail (both accounts) | gmail | gog CLI search |
| NoFluffJobs | nfj | API/curl |
| Just Join IT | jjit | API/curl |
| RubyOnRemote | ror | curl + parse |
| Rails Job Board | rjb | curl + parse |
| HN Who's Hiring | hn | curl + parse |
| Bulldogjob | bdj | curl + parse |
| Welcome to the Jungle | wttj | curl + parse |
Scoring
Jobs are scored 0-100 against ~/Projects/jobs/criteria.yaml:
| Score | Grade | Meaning |
|---|
| 80-100 | A | Strong match, apply |
| 60-79 | B | Good match, review |
| 40-59 | C | Partial match |
| 20-39 | D | Weak match |
| 0-19 | F | Skip |
Score Breakdown
| Factor | Max Points |
|---|
| Title keywords | +25 |
| Must-have stack (ruby/rails) | +25 |
| Strong match stack | +15 |
| Nice-to-have stack | +10 |
| Location match | +10 |
| Salary in range | +10 |
| Contract type match | +5 |
| Watchlist company | +15 |
| Exclude keyword | -50 each |
| Dealbreaker | -100 |
| Blacklisted | -100 |
File Structure
~/Projects/jobs/
criteria.yaml # Search criteria, watchlist, blacklist
status.yaml # Scan state, seen URLs, pipeline
leads/ # Individual lead analysis files
everai.md # Company recon files
opus-*.md # Recruiter profiles
Prerequisites
gog CLI with gmail OAuth (both accounts)
python3 with pyyaml
curl
- Gmail skill at
${CLAUDE_PLUGIN_ROOT}/skills/gmail/gmail.sh