How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/gaket/talent-agent --skill find-rolesBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
find-roles
Inputs
profile/prefs.yml(roles, seasons, locations, exclusions). Fall back toprofile.example/prefs.ymland say so.- Company list:
resources/boards.example.yml(user copies toprofile/boards.yml).
Steps
- Read prefs. Confirm season (e.g. Summer 2027) and locations if missing.
- For each company in boards file, call the public API for its ATS:
- Greenhouse:
https://boards-api.greenhouse.io/v1/boards/<token>/jobs?content=true - Lever:
https://api.lever.co/v0/postings/<slug>?mode=json - Ashby:
https://api.ashbyhq.com/posting-api/job-board/<slug>?includeCompensation=true
Or run python .agents/skills/find-roles/scripts/ats_fetch.py profile/boards.yml.
- HN: find the current month's "Ask HN: Who is hiring?" via
https://hn.algolia.com/api/v1/search?query=who%20is%20hiring&tags=story,author_whoishiring, then fetch comments; keep ones mentioning intern / new grad / junior.
3b. JobRight (only if jobright: true in boards file and a browser tool is available): follow resources/jobright.md. Read-only, user must already be logged in, ≤25 cards, never click Apply. No browser tool? Skip it and say so.
- Filter titles/descriptions:
- Keep: intern, internship, co-op, new grad, university grad, early career, junior, "Software Engineer I", "Data Scientist I", 2027.
- Drop:
exclude_keywordsfrom prefs, senior/staff/principal, 3+ years required. - Match locations (city, "Remote - Canada/US").
- Liveness: keep only postings still returned by the API; for HN or pasted URLs, fetch the page and drop if 404, redirected to a generic careers page, or says "no longer accepting".
- Dedupe by (company, normalized title, location).
- Output a table: company | title | location | source (greenhouse/lever/ashby/hn/jobright) | URL (original posting preferred) | posted/updated | notes (sponsorship text, season). Offer to pass to
score-fitand add to tracker viatrack-pipeline.
Rules
- Public APIs/pages only, plus the one read-only JobRight exception in
resources/jobright.md. LinkedIn is not a job source here (people search lives infind-people). If the user pastes LinkedIn job text, you may parse it. - Never apply or submit anything.
- Be polite: ≤1 request/sec per host; cache results in
output/roles-YYYY-MM-DD.json.

