Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/madslorentzen/ai-job-search/freehire-searchnpx skills add MadsLorentzen/ai-job-search --skill freehire-searchgit clone --depth 1 https://github.com/MadsLorentzen/ai-job-searchWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00143 | $0.02749 |
| Opus 5 | $0.00072 | $0.01375 |
| Sonnet 5 | $0.00029 | $0.00550 |
| Haiku 4.5 | $0.00014 | $0.00275 |
Grade A, and why
freehire-search scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
Copies of this mod
2 near-identical copies found in the catalogue:
- freehire-search — 100% identical, 0 lines differ
- freehire-search — 95% identical, 13 lines differ
How it starts
The opening of the file, as written. The whole thing — 201 lines — stays where its author put it; the contents beside it link to each section on GitHub.
freehire Search Skill
Search live job listings from the freehire.me job
aggregator — an open-source IT job board that normalizes postings from ~50 ATS
platforms across many countries into one schema. No authentication, no API key,
and zero runtime dependencies — it runs with just bun. The market is chosen
per query via facet flags (--region, --country), so the same skill works for a
forker in any market out of the box.
This is a country-agnostic worked example of the repo's job-portal-skill pattern, like
linkedin-search. Unlike the HTML-scraping portals, it queries freehire's public JSON API, so results are structured (skills, seniority, region facets) rather than parsed from markup.
⚠️ Scope: tech-focused
freehire's corpus already includes some non-tech postings (it crawls whole company career pages), but its faceted filtering — skills, categories, and seniority dictionaries — is tuned tech-first today, so this skill scopes its triggers to software / data / engineering / tech roles, where the filtering is strong. Non-tech coverage exists but is still maturing; don't rely on this skill for general (non-technical) job coverage yet.
ℹ️ Hosted-service dependency (best-effort, no SLA)
This skill depends on a third-party hosted service, freehire.me. Reads are
public and unauthenticated — the same zero-signup bar as linkedin-search.
freehire.me is a personal project but actively maintained; it runs on a best-effort basis (no formal SLA). If the API is unreachable, the CLI fails gracefully — a non-zero exit with a clear error message — so an outage degrades this source rather than breaking the surrounding workflow.
Self-hosting / swappable base URL. The freehire backend is a separate
MIT-licensed repo — strelov1/freehire
(Go + PostgreSQL + Meilisearch) — that stands up with one command via Docker
Compose (make up → API on :8080, same /api/v1/... paths). The skill honors a
base-URL env var, FREEHIRE_API_URL (default https://freehire.me), so pointing
it at a local instance is a one-line change:
What ships with it
14 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- cli/package.json 612 B
- cli/README.md 3.9 KB
- cli/src/cli.ts 10.0 KB runs code
- cli/src/commands/detail.ts 2.3 KB runs code
- cli/src/commands/search.ts 6.1 KB runs code
- cli/src/helpers.ts 7.7 KB runs code
- cli/tests/cli-flag-validation.test.ts 5.0 KB runs code
- cli/tests/commands.test.ts 8.3 KB runs code
- cli/tests/helpers.ts 1.0 KB runs code
- cli/tests/parsing.test.ts 3.4 KB runs code
- cli/tests/request-timeout.test.ts 957 B runs code
- cli/tests/retry-backoff.test.ts 2.4 KB runs code
- cli/tsconfig.json 305 B
- url-reference.md 7.0 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 201 lines · 143 tokens per session scan A 1db1c236985f
freehire-search is a skill published in the GitHub repository MadsLorentzen/ai-job-search (39,400 stars, last pushed today), licensed MIT. It adds 143 tokens to every session and 2,749 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
resume-tailor
Tailors a resume to a specific job description with ATS optimization. Use when asked to optimize a resume, tailor CV for a job, create an ATS-friendly resume, generate a cover letter, or adapt career profile for a specific role. Triggers on: "resume", "CV", "tailor", "ATS", "job application", "cover letter", "optimize…
Academic CV Builder
Format CVs for academic positions with publications, grants, and teaching.
resume
Generate a tailored resume AND cover letter for a job description via the native four-role Resume Team, score both against ATS and HR rubrics, create DOCX files, and update the tracker. Use when the user pastes a job description and wants a complete application package (resume plus cover letter) with dual scoring and…
writing-coach
Human-voice writing coach that rewrites resumes and cover letters for brevity, burstiness, plain language, and authentic impact, and blocks AI-sounding prose. Use when the user wants to improve writing quality, fix robotic or generic AI-sounding text, cut fluff, strengthen bullets and summaries, or pass the…
cover-letter
Create a compelling one-page, human-voice cover letter for a job description and generate the final DOCX. Use when the user wants a cover letter only (no resume), pastes a JD and asks for a letter, or needs a letter to accompany an already-tailored resume. Runs the mandatory humanvoiceaudit before producing the DOCX.
find-jobs
Search live job boards for roles that match the master resume, then score and rank them by ATS and HR fit. Use when the user wants to discover or find jobs, search openings by title or location, wants remote roles, or asks which live listings best match their background. Uses the discoverjobs MCP tool and never…