job-scout - SKILL.md Agent Skill

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.

Context: User wants to find new jobs user: "scout for jobs" Context: User wants to check email for recruiter messages user: "check my job inbox" Context: User wants to analyze a specific posting user: "review this job posting" Context: User wants a status update user: "job report" Context: User wants to score a job description user: "score this job against my criteria" Context: User wants to track a company user: "add Shopify to my job watchlist" 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

# Full scan — all sources
bash $SKILL scout

# Scan single source
bash $SKILL scout --source nofluffjobs
bash $SKILL scout --source gmail
bash $SKILL scout --source hnhiring

# Check email inbox for recruiter/ATS messages
bash $SKILL inbox

# Score a job description
echo "Senior Ruby on Rails, 30K PLN, remote, B2B" | bash $SKILL score

# Report — summary of leads and pipeline
bash $SKILL report

# Pipeline management
bash $SKILL pipeline
bash $SKILL status https://example.com/job/123 applied

# Watchlist and blacklist
bash $SKILL track "Basecamp"
bash $SKILL blacklist "Bad Recruiter Agency"

# Show criteria
bash $SKILL criteria

# List leads
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