job-board-scoutlisted
Install: claude install-skill getedgehq/skills
# Job Board Scout
Discovery, not application. The script reads public job endpoints, applies filters
you declare in a config file, deduplicates against a state file, and writes a
markdown review queue. It has no credential, sends nothing, and cannot apply to a
job or message anyone.
## Prerequisites
Python 3.9 or later, standard library only. No API key, no account, no secret.
Outbound HTTPS to the endpoints you list in the config.
## Before the first run: write the config
There is no default search. `filters.title_terms` is required and the script exits
2 if it is missing, because a scout that guesses what you want is a scout that
wastes your review time. Start from [`examples/recruiting.json`](examples/recruiting.json)
and replace the lists with the user's own.
Ask the user for, and write into the config:
1. **Titles** (`filters.title_terms`). Substrings matched against the posting title,
casefolded. Prefer stems (`talent sourc`) over full words.
2. **Disqualifiers** (`filters.exclude_terms`). Matched across title, description,
tags and employment type. This is where hourly work, unpaid work, and
near-miss titles go.
3. **Remote requirement** (`filters.require_remote`, `filters.non_remote_terms`).
4. **Geography** (`filters.geography`). This filter reads the location restriction
the posting states. It is a filter over posting text, not a claim about anyone's
right to work anywhere. `allow_unstated: false` fails closed: a posting that says
nothing ab