scrape
Skill6 starsChanged 23 days agoMITView on GitHub
Finds new job postings matching your profile via installed portal-search CLIs (LinkedIn, freehire, local job boards, and any skills added with /add-portal; whichever are on, per tools/portals.py) and employer ATS boards. Deduplicates across runs. Triggers on: job scrape, find jobs, search jobs, new jobs, job search, scrape jobs, /scrape
36 other projects use a version of this.
Adopted by
Most recently taken up by
- Ivan-propio/claude-skillstheir own version, first seen Nov 16, 2026
- Mateus-Nogueira-GT/ai-job-search-brasiltheir own version, first seen Nov 16, 2026
- alexcarney460-hue/walkietheir own version, first seen Nov 15, 2026
- 5uck1ess/devkittheir own version, first seen Nov 15, 2026
- Fan-Pier-Labs/openrecordtheir own version, first seen Nov 15, 2026
- MadsLorentzen/ai-job-searchtheir own version, first seen Nov 9, 2026
Used with
Projects with it also use ios-sync, setup-gbrain and 8 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
Saqlain-811Skillios-sync
Regenerate the iOS debug bridge against the latest upstream gstack templates. (gstack)
Also in 6 projects that use this
ShreyRaviSkillsetup-gbrain
Set up gbrain for this coding agent: install the CLI, initialize a local PGLite or Supabase brain, register MCP, capture per-remote trust policy. One command from zero to "gbrain is running, and this agent can call it." Use when: "setup gbrain", "connect gbrain", "start gbrain", "install gbrain", "configure gbrain for this machine". (gstack)
Also in 8 projects that use this
ShreyRaviSkillplan-tune
Self-tuning question sensitivity + developer psychographic for gstack (v1: observational). Review which AskUserQuestion prompts fire across gstack skills, set per-question preferences (never-ask / always-ask / ask-only-for-one-way), inspect the dual-track profile (what you declared vs what your behavior suggests), and enable/disable question tuning. Conversational interface — no CLI syntax required.
Also in 10 projects that use this
Saqlain-811Skillios-clean
Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app. (gstack)
Also in 5 projects that use this
timurgaleevSkilldocument-generate
Generate missing docs for a feature, module or project as tutorials, how-tos, reference and explanation.
Also in 7 projects that use this
bastosSkillios-design-review
Review iOS app UI/UX design quality using Apple's design principles and the Liquid Glass-era design language from WWDC25/26. Use when asked for a design review, UX critique, visual design assessment, or evaluation of an app's interface quality, design intent, alignment with the new Apple design system, or usability. Triggers: "design review", "UX review", "visual design critique", "review the UI", "does this design work", "evaluate this interface", "design feedback", "Liquid Glass review".
Also in 5 projects that use this
- +3 more from ShreyRavi
- +1 more from Saqlain-811
Other versions36 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 36
- garrytan/gstack★ 142ksame name
- ai-job-search-dev/ai-job-search★ 72ksame name
- MadsLorentzen/ai-job-search★ 72ksame name
- davekilleen/Dex★ 509same name
- brightdata/skills★ 270same name
- Fan-Pier-Labs/openrecord★ 75same name
- zytedata/claude-skills★ 33same name
- timurgaleev/vibestack★ 8same name
- 5uck1ess/devkit★ 4same name
- JiemsLBJ/offer-harvester★ 4same name
26 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository11 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- profile.example/CLAUDE.mdCLAUDE.md
- tests/CLAUDE.mdCLAUDE.md
- tools/CLAUDE.mdCLAUDE.md
- freehire-searchSkill
- linkedin-searchSkill
- appSkill
- job-application-assistantSkill
- networkingSkill
- upskillSkill
The file
We split this skill into the rules it gives an agent
12 rules. 0 are common, 7 are distinctive, and 5 are very specific to this project.
0
Common
Most of the 29 edited versions we read keep these.
7
Distinctive
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 27
Scrape: every enabled portal per job-scraper/SKILL.md.
- Very specific: line 28
Rank: every surviving posting 0-100 against 04-job-evaluation.md, gates first.
- Distinctive: line 39
Only draft unprompted if the user has explicitly said to in that request.
- Very specific: line 43
Every posting presented is scored 0-100 against 04-job-evaluation.md: gates first (Eligibility, Language, Location), then the four weighted …
- Distinctive: line 137
If the target is still missed after 3 rounds, say so explicitly with the count, what was tried, and the likely blocker.
- Distinctive: line 191
And it keeps going without being asked: When a round comes back thin, a good posting arrives from a board that is not covered, an employer …
- Distinctive: line 277
A portal found broken: after the report, offer to switch it off until it is fixed.
- Distinctive: line 316
Never fabricate job postings: Only present jobs from actual CLI search/detail output or WebSearch/WebFetch results.
- Very specific: line 317
Respect deduplication: Always check seen_jobs.json AND job_search_tracker.csv before presenting.
- Very specific: line 320
Be efficient with detail fetches: Don't run detail or WebFetch on every search hit - pre-filter by title/snippet, then fetch only promising …
- Distinctive: line 321
Parallel searches: Run portal CLI searches in parallel.
- Distinctive: line 324
Score everything you present, and rank by that score: No posting reaches the user unscored, and the table is ordered by score.
“Common” is measured: kept by at least 6 in 10 of the 29 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Job Scraper
The rules every search keeps
These are the rules every round keeps, in full: CLAUDE.md points here. Most are enforced in code; this is what the code is doing and why.
When the user asks to run a job search, scan, or scrape, run the search end to end and stop at the ranked shortlist. The deliverable is a ranked, scored table plus the context needed to choose: salary read, deadlines, referral links, and what needs checking.
The pipeline, in order:
- Scrape every enabled portal per
job-scraper/SKILL.md. - Rank every surviving posting 0-100 against
04-job-evaluation.md, gates first. - Expand and repeat until the yield target is met, up to 3 rounds.
- Present the ranked table, highest score first, with scores visible, and under it
the line from
python3 tools/what_works.py brief searchwhen it reports a clear difference (whether the scores have been predicting interviews). - Stop there and ask which ones to take forward. Do not draft resumes or cover letters unless the user asks for them.
- Before drafting anything, confirm the user has not already applied. The tracker only knows about applications made through this repo, so it cannot rule out an application the user made directly. Ask, and record the answer in the tracker.
Only draft unprompted if the user has explicitly said to in that request.
/scrape on its own is a ranking tool, not a link collector.
- Every posting presented is scored 0-100 against
04-job-evaluation.md: gates first (Eligibility, Language, Location), then the four weighted dimensions. Results are presented in score order, highest first, with the score visible. - A posting that fails a gate is excluded and recorded, never ranked.
- Rank down, do not cut. A posting is a wish list. It names ten tools and the team uses
six, and the missing one is almost never what decides the hire. One missing skill is
never a reason to drop a role, and neither is a year of experience, a preferred degree,
or a posted range under target (bar the one salary cut below). Those are scoring inputs; the
role still surfaces and the candidate decides. Enforced in
tools/fit.py, which weights every gap by how hard they asked and by what sits next to it, and intools/text_screen.py, where a degree minimum and a range above the cut line are flags rather than cuts. - Only these are hard cuts, because no framing survives them, and each one carries the
quoted sentence it was cut on: an eligibility bar the profile cannot clear (a citizenship,
residency or clearance requirement, or a requirement to live elsewhere), a language
requirement (or a title written in another language), a location the Location table fails,
a professional credential gate (actuarial exams, an accounting or engineering licence), a
role whose core is a discipline the person does not hold that the profile names as a
different job (
search.pyRESEARCH_ML, research machine learning for an analyst; nothing for a researcher), a vacancy open to the employer's own staff only ("internal applicants only", an "Internal Mobility" title), and a stated salary range whose top sits below the person's cut line (SALARY_CUT_BELOWinprofile/search.py, well under the walk-away floor: a different job level, not a negotiation). Those are different jobs, not missing skills. Everything else gets ranked. A top between the cut line and the floor is a flag, never a cut, intools/text_screen.pyand intools/score_posting.py, which reads extracted fields. - Every posting ruled out is written back to
seen_jobs.jsonwithtools/exclude.py add, which storesstatus: "excluded", a checkableexclusion_reason, a date and what the ruling rests on, so it never resurfaces while that holds. A ruling under the person's screening rules lapses when the part it rests on changes (--rests-on "triage #4", or a reason citing "blocker 4"; with neither, any change to the rules) and the posting is screened again when next found; one in the person's own words holds untilexclude.py lift. An exclusion stands only while today's rules would still cut it (throttle.is_stale_exclusion): one resting on a named part of the person's rules stands while that part does, and any other is judged by its reason. Eligibility, a language, a credential, a different discipline, internal-only and a fact about the posting (closed, a duplicate) stand; a pay reason stands only on a range topping out belowSALARY_CUT_BELOW; a place only where the location gate still fails the place the entry recorded; a degree, a score or a years bar never. A round records the text screen's own cuts this way by itself (tools/text_screen.py --seen, whichrun_round.pypasses), each with its quote, so the next round drops them before hydrate fetches them again. The prefilter's drops (age, place, title) are not recorded: they are decided again for free, before any fetch, and thousands a round would bury the rulings. The gate that enforces that isthrottle.ruled_out(), and it runs at prefilter, beforehydrate.pyspends an HTTP call fetching the body: a large share of everything reaching hydrate is a posting already ruled out.prefilter.pyimports the throttle's own function rather than reimplementing it, so the shortlist is unchanged;run_round.py --no-seen-readturns it off, which is what you want after changing the scoring rules and wanting everything previously excluded re-evaluated. Exclusions are per posting, never per company: a different role at the same employer stays in scope. job_scraper/do_not_target.jsonis the one company-level exception, and it is a different claim. A posting exclusion says a role was rejected. An entry there says the employer has no relevant presence for that function in that city, so there is no role to stay in scope: an office that houses only sales, or only production, has no role to stay in scope for unless one of those is the person's function.tools/throttle.pyreads it and skips the employer with the reason. Every entry names who established it and carries areview_afterdate, after which it stops suppressing and is reported as expired, because a company standing up a team in that city is exactly the fact that goes stale. Add an entry only on positive evidence of absence, never as a shortcut for "this one was a bad fit".- Every posting presented, and every posting documents are drafted for, carries a clickable apply link.
- Scoring is tiered, cheapest first. A mechanical pre-filter, then a small-model knockout
check against
profile/10-triage-blockers.md, then full weighted scoring only on survivors, then adversarial verification only on postings scoring 70+. Never spend a full weighted evaluation discovering a stated requirement the profile cannot meet, such as a licence or a degree. See11-cost-model.mdfor the per-stage costs and the model to use at each stage. - A posting at an employer where a conversation is already running surfaces with a warning,
never suppressed.
tools/throttle.pyreadsnetwork_contacts.csvand attacheswarm_route_noteto the shortlist row: "DO NOT APPLY COLD", the person, and what is owed. A warm route makes a role more worth having, so hiding it to protect the referral would lose the role. A standing referral offer sits unused if a cold application to the same employer goes in first and spends it for nothing. - A reply is what makes a route warm.
awaiting_replymeans a message went out and nothing came back, and a large share of any contact book sits there. Counting them warm would print "DO NOT APPLY COLD" over employers where nobody had said a word back, add the referral bonus to the fit score and exempt the role from the fit floor, all on the strength of an unanswered InMail.throttle.RESPONDEDis the warm set;SENT_NO_REPLYgetsoutreach_pending_noteinstead, which says applying is fine and a second message is not. For the outreach note indocuments/applications/, both halves count: whether they replied decides whether applying is cold, and decides nothing about sending another message. - A referral already in flight is the one contact state that suppresses. A contact at
referral_in_progressmeans somebody inside has put the candidate's name forward, so a cold application lands as a second, worse record of the same person and the referral is the one that loses.throttle.referral_holds()blocks every posting at that employer and names who. This is what a live process at an employer is recorded as: put the contact onreferral_in_progress, do not rely on remembering it. - Company throttle. A company with an open application in the tracker is suppressed: do not surface more roles there. The only override is a role scoring 10+ points higher than what was already sent, named explicitly. Where one run turns up several eligible roles at one employer, surface only the highest scorer, by its 0-100 fit (priority breaks a tie), and record the rest as same-employer duplicates.
- Yield target: at least 5 postings scoring 60+, of which 2 score 75+. A run that misses it expands the search and goes again, up to 3 rounds: more title variants, then the remaining priority categories, then wider PASS-set locations, then adjacent target sectors and named employers, then more pages and the WebSearch fallback.
- If the target is still missed after 3 rounds, say so explicitly with the count, what was tried, and the likely blocker. Never pad a thin run with sub-60 postings, and never relax a gate or the location filter to hit the number.
- A posting with no stated salary is not penalized. Most postings in most markets omit it.
Report
not stated, deduct nothing, and assume the band is met where the employer is established with checkable evidence of good pay and benefits. Only a stated range whose top falls below the walk-away floor gets flagged alongside the score, and even then it is a decision input, not an exclusion (the cut line above is the one exception). See "How much weight salary actually gets" in04-job-evaluation.md.
Portals and employer boards
- The app ships two portals, and every other one is the person's.
linkedin-searchandfreehire-searchwork in any country and are on by default; a person turns either off inprofile/search.pyPORTALS, never in itsSKILL.md, which is the app's. LinkedIn's robots.txt disallows its guest job endpoints for crawlers it does not name, and/setupsays so; switching it off is the person's call. A board for one country, field or level is built for the person by/add-portal(which/setupruns for the boards its research found), lives in their repo as a personal path (tools/personal_paths.py), and is searched by every round, kept to thecrawl-delayitsSKILL.mddeclares. The app never carries a portal of its own beyond those two (.agents/skills/is a personal path, and its leak scan fails on one there). What it does carry is the market tables (tools/markets/, read withtools/markets.py): public facts about the national, field, graduate, executive, regional and remote boards of many countries, each with the robots.txt verdict code made for its search and posting paths and the day it was read, which/setupreads before it researches anything. A board from a table is searched only once/add-portalhas built it in the person's repo, after reading its robots.txt again.python3 tools/portals.pyprints what the next round will search, and the boards researched for the person (PORTAL_RESEARCH) that have no portal yet. - A site that needs a key (an API such as Adzuna's) shows on the page as what it
needs ("Needs a free key"; Adzuna "Needs a paid plan") with the steps to get it (
tools/portals.pySITES,key_help), and cannot be ticked until this computer holds it. When the person says "I have my<site>key", show them where it goes the way SETUP.md, "A job site that needs a key", says: never asked for in the chat itself, never written into the repo. - Employer boards are the third source, and not a portal.
tools/ats_boards.pyreads the employers named inprofile/boards.pystraight from their ATS (every system the vendored openroles reads: Greenhouse, Lever, Ashby, Workday, Personio, Teamtailor and the rest) or their careers site (careersite), which is how large employers that a portal under-indexes reach a round, andscrape_wide.pycalls it, sorun_round.pyneeds nothing extra.--probere-checks every token. A board whose robots.txt disallows it is refused, and so is SmartRecruiters by its API's; the reasons are recorded beside each.
A board the chat cannot reach, and a round that comes back thin
- A job board the session cannot reach may be blocked by the chat's cloud settings:
check
curl -sS "$HTTPS_PROXY/__agentproxy/status"forconnect_rejected. That is a policy denial, not a bug: do not route around it. Tell the person whatpython3 tools/env_check.py --sayprints, word for word (a round prints the same under "Tell the person"): one recommended fix in numbered steps, which reaches the running chat within about a minute. The day's sync checks it and prints the same words first, and the page shows it as a To do card. Until it is fixed, run no search: a web search in its place finds old, closed jobs./apply <pasted posting text>still works. - And it keeps going without being asked. When a round comes back thin, a good posting
arrives from a board that is not covered, an employer they mention has no board on file,
or a gate cuts something it should not for their market, propose the fix, do the research
(
/add-portalfor a board, after checking robots.txt the waytools/robots_check.pydoes;tools/ats_boards.py --find "<Employer>"for an employer's own board), and record it inprofile/, cited.
One command
python3 tools/run_round.py --jobage 14 runs every stage of a round in order and stops at the ranked shortlist; asked in the chat, add --table and it ends by printing the table to show (Step 5). When the person names employers ("search these 20 employers"), add --employers "A, B, C": only those are searched (their own boards and searches by their names), the list holds only them with a place for each, and the round names any with no open roles ("No open roles found at X, Y"), which you pass on (RUNBOOK.md step 1). Leave --out off: the round names itself, r and the next number, and prints its folder (round: r12, its files in ...), which is the folder --recut and a progress pin name. See RUNBOOK.md. When it cannot run, manual-round.md beside this file has every stage written out to do by hand: read it only then. Its step numbers are the ones cited below.
How It Works
This skill searches job portals using the installed portal-search CLIs in
.agents/skills/ (plus WebSearch as a fallback), using queries from your profile.
It deduplicates against previously seen jobs and the application tracker, scores every
surviving candidate against the fit framework in profile/04-job-evaluation.md, and presents a
ranked shortlist. A run that does not surface enough passing roles expands its search and
goes again rather than reporting a thin result.
Invocation
The user triggers this skill by saying things like:
- "Find new jobs"
- "Scrape for jobs"
- "Any new positions?"
- "/scrape"
Optional arguments:
- A focus area, e.g. "/scrape data science" or "/scrape demand planning"
- "broad" to run all search categories, e.g. "/scrape broad"
- "health" to run the portal health check only (
manual-round.mdStep 4.75), without searching, deduplicating, or presenting jobs - e.g. "/scrape health", or "/scrape health linkedin" to probe one portal even if disabled
Step 5: Present Results
On the person's page first (CLAUDE.md, "Every output is shown"): the round reaches the page's
Jobs list through python3 tools/app.py view. Asked in the chat, or where there is no page,
the chat shows it in full this way too: one line of counts, then the table, then a line only
for what is off. Never more. Asked on the page, the chat says only the counts line and where
it is.
The round prints the table; never build it from the JSON. Asked in the chat, run the round
with --table (python3 tools/run_round.py --jobage 14 --table; --recut --out <the round's
folder> --table prints it again after a recut). Under table for the person it prints the
counts line and the table, columns # | Score | Verdict | Title | Company | Location | Salary |
Deadline | Check | Apply, each row's warm route already in Check. Pass both on exactly as
printed, then the lines for what is off (below). Reading the shortlist's JSON to make it costs
about 10k tokens a search and adds nothing.
- Sorted by score, highest first, with the score shown. Never alphabetically, by portal or by posting date, and never an unscored posting. The printed table already is.
- The number asked for is filled from the next rows that pass every rule. The round's cut
(
run_round.hard_rules, the one path every row a search brings back goes through) passes over a row failing a hard rule (no score, the search window, the candidate's bar with a staffing agency, the screen's hard cuts such as a language, a ruling, or a job the person already has: applied, drafted, added, kept or still on their list; a place outside theirs, the location gate's own fail; an employer judged to clear none of their bar) and takes the next, and says how many it found when it runs out (shortlist: found 7 of the 10 asked for): pass that on. What it rules out is off the page already: the round writes each as a ruling with its plain reason and puts it on its left-out list, where Bring back undoes it, and checks the jobs still on Jobs from earlier searches the same way (left out: N ...); the page's Found list is read with the same function (run_round.page_rules), so a row failing a hard rule never shows as a find. Nothing is cleared by hand. A row you find fails a rule the round could not see is ruled out withpython3 tools/exclude.py add <url> --title "<title>" --company "<company>" --reason "<why>", thenpython3 tools/run_round.py --out <the round's folder> --recut --show <N>cuts the round again and refills it. Never drop a row from the table by hand: it leaves the shortlist short with good rows below it. - Every row carries a working apply link, and so does every posting you later draft
documents for. The link is the posting URL stored in
seen_jobs.json, which already resolves to the posting itself rather than to a listing page. When documents are produced for a posting, repeat its link next to them. - Check says what needs checking before applying, and any red flag: a mass-posting
pattern ("posted in 6 cities"), a stated salary range whose top is below the walk-away
floor, an unstated on-site expectation, a language level below the posting's bar. An absent
salary range is not a red flag. A row's warm route from the contact book goes here too
(
warm_route_note: "DO NOT APPLY COLD" and who;outreach_pending_note): those are the referral links. The printed Check holds all of these that the round read; one you find in a posting yourself (a mass-posting pattern, an on-site expectation) goes in the line under the table, never edited into a row. - A line only when something is off:
skipped (disabled): <portals>when a portal is switched off (python3 tools/portals.pysays which), so an opt-out is never silent;fallback (websearch): <portals>when results came from the search fallback, which can be stale (omit the line when every portal ran its CLI); onehealth: <portal> - <what>line for each portal the round (ormanual-round.mdStep 4.75) found degraded, broken or inconclusive; and when the target was missed, a short note: the count against target, the expansions run, the likely blocker and the next move. Never pad the table with sub-60 postings. - A portal found broken: after the report, offer to switch it off until it is fixed. For
the app's two portals (
linkedin-search,freehire-search) that is aPORTALSentry inprofile/search.py({"freehire-search": False}), never an edit to theirSKILL.md, which a sync puts back; for a portal built for this person by/add-portalit isenabled: falsein that portal's ownSKILL.mdfrontmatter. Only with the user's confirmation, and never edit anything else in the skill. - LinkedIn people-search links for a recruiter or a peer at an employer
(
manual-round.mdStep 4.5) only when the person asks:/networkis the route to people.
Step 5.5: Stop at the shortlist
The run ends at the table, unless the person asked for every one drafted (the page's Find jobs,
"Draft every one as it is found", args.draft): then the search's own chat drafts each job as it
is found, as the steps that chat is given say (app.py search-drafts, from tools/app.py
job_steps). Nothing is drafted unasked, and nothing is drafted before the
already-applied question ("The rules every search keeps", items 5 and 6, at the top of this
skill). Ask once:
"Which of these should I take forward? And have you already applied to any of them?"
A yes to the second is recorded with python3 tools/confirm.py applied (--new --company
--role --url --on <date> --source chat for one the tracker never had, or the row's name when
it has it), never by editing the tracker, and the lines it prints, the applications it covered,
are shown to them. Each
pick goes to /apply, which reuses the round's score and asks nothing already answered here.
A number the person picks is a row of the printed table, so name the pick by that row's
employer and title (Employer::title words), never by the number alone.
Do not suggest /rank after a normal run: the run already scored everything it presented (a round's scores are in documents/rounds/<round>.json; on the manual path manual-round.md Step 3 wrote them to ranked), so /rank would only score them again. /rank is for the two cases /scrape does not cover: re-scoring after a change to the candidate profile or profile/12-scoring-brief.md (/rank --all, which skips permanent exclusions), and scoring a backlog added outside the normal flow. (/rank sets the ranked and expired status values in seen_jobs.json. Treat both as already seen: a round shows a ranked posting again while it is live, and never one expired past its stated deadline, which holds by its own link only, since a posting re-issued under a new link is a new one.)
Step 6: Update Tracker (Optional)
If the user decides to apply to any job, the tracker row is written by job-application-assistant Step 3b, which Step 5 already routes into - do not add a second row here. Only when the user says they applied to something outside that path, add a row using the header and the match-then-update rule in /outcome Step 1.
Important Rules
- Never fabricate job postings. Only present jobs from actual CLI search/detail output or WebSearch/WebFetch results.
- Respect deduplication. Always check seen_jobs.json AND job_search_tracker.csv before presenting.
- Focus on configured geographic area. Skip jobs that require relocation or are clearly outside commute range.
- Only open positions. Skip postings with expired deadlines or those marked as closed. A web-search lead is shown only once its own page proves it is open (
manual-round.mdStep 1c). When this chat's cloud settings block the job sites, no search runs and there is no table: the reply is the fixpython3 tools/env_check.py --sayprints. - Be efficient with detail fetches. Don't run
detailor WebFetch on every search hit - pre-filter by title/snippet, then fetch only promising matches. - Parallel searches. Run portal CLI searches in parallel; use WebSearch only for gaps the CLIs don't cover.
- No automated people lookups. Referral contacts (
manual-round.mdStep 4.5) are LinkedIn search links only - never fetch or scrape LinkedIn people-search result pages programmatically. - Health checks are bounded and honest.
manual-round.mdStep 4.75 spends at most one probe, one retry, and (inhealthmode) one detail fetch per portal - a diagnosis, not a crawl. A rate-limit is never evidence of breakage. Health verdicts come only from observed CLI output; a portal that could not be tested is reported as inconclusive, never guessed. The on/off switch (PORTALSinprofile/search.py, orenabled:in a person's own portal) is the only thing the health check may edit, and only with confirmation. - Score everything you present, and rank by that score. No posting reaches the user unscored, and the table is ordered by score. A list of unranked links is a failed run.
- An under-target run expands before it reports.
manual-round.mdStep 3.5's expansion ladder runs before the summary is written, up to 3 rounds (run_round.py --expandwidens the pages itself and prints the other rungs, Step 3.5). Never pad a thin result with sub-60 postings, and never relax a gate or the location filter to make the yield target. - Flag distribution patterns, never accuse. The mass-posting signal (
manual-round.mdStep 2.5) describes how a listing is being distributed, not a claim that the employer is a scam. Never name a company as fraudulent or untrustworthy - present the observation and let the user decide. - Paginate. Never cap. A search walks
--page 1..Nuntil a page comes back empty or wholly duplicated (nothing on it the search's own earlier pages did not have;scrape_wide.pyPageWalk), and covers every location the PASS set covers, not just the biggest city.run_round.pydoes both;manual-round.mdStep 1b says how by hand. - Full scoring is one posting per agent, never batched (Tier 3,
manual-round.mdStep 3), whatever batch size/rankuses.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

