using-freehire

using-freehire is a skill for Claude Code from strelov1/freehire-cli. It costs 64 tokens per session (594 once invoked), scanned C, original, MIT.

A guide to the freehire command-line tool, which lets people search, filter, apply to, and track IT jobs from a terminal instead of a web browser. It explains installation, API-key login, available job-related skills, and common authentication errors.

In plain words
What is it for?
Use it when installing freehire, signing in, checking the current account, logging out, choosing a job-search task, or diagnosing a 401 error, which means the service rejected the credentials.
Why use it?
It helps an agent choose the right freehire command and fix setup problems, such as an invalid or missing API key.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the freehire plugin — 6 skills, 5 commands shipped together

Good fit Use it when installing freehire, signing in, checking the current account, logging out, choosing a job-search task, or diagnosing a 401 error, which means the service rejected the credentials.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/strelov1/freehire-cli/using-freehire
Install

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.

Any agent
npx skills add strelov1/freehire-cli --skill using-freehire
Clone the repo
git clone --depth 1 https://github.com/strelov1/freehire-cli

Made for: Claude Code.

Or install freehire, the plugin that ships this one along with the rest of its 6 skills, 5 commands.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for using-freehire

README.md
[![agentmods](https://agentmods.dev/badge/skills/strelov1/freehire-cli/using-freehire.svg)](https://agentmods.dev/skills/strelov1/freehire-cli/using-freehire)
Your own site
<a href="https://agentmods.dev/skills/strelov1/freehire-cli/using-freehire"><img src="https://agentmods.dev/badge/skills/strelov1/freehire-cli/using-freehire.svg" alt="Measured on agentmods" height="20"></a>
Per session 64 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 594 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 2 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00064 $0.00594
Opus 5 $0.00032 $0.00297
Sonnet 5 $0.00013 $0.00119
Haiku 4.5 $0.00006 $0.00059

Measured 8d ago against content hash f094f8cf679b, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade C, and why

using-freehire scanned grade C with 2 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 8d 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.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl -fsSL https://freehire.me/install.sh | sh # or: go install github.com/strelov1/freehire-cli/cmd/freehire@latest

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -fsSL https://freehire.me/install.sh | sh # or: go install github.com/strelov1/freehire-cli/cmd/freehire@latest
skills/using-freehire/SKILL.md · 49 lines

How it starts

The opening of the file, as written. The whole thing — 49 lines — stays where its author put it; the contents beside it link to each section on GitHub.

The freehire CLI

freehire is a single static binary over the freehire.me job API. It lets an agent search, filter, apply to and track IT jobs without a browser, authenticating with a personal API key. Every command supports --json for a raw, faithful API payload (pipe to jq).

Install and authenticate (once)

curl -fsSL https://freehire.me/install.sh | sh   # or: go install github.com/strelov1/freehire-cli/cmd/freehire@latest

freehire auth login --token fhk_xxxxxxxx   # validates the key and stores it (~/.freehire/creds.json)
freehire auth status                       # who am I / which API
freehire auth logout                       # removes the stored key

Create the key in the web app: freehire.me → account menu → API keys.

The key can also come from FREEHIRE_TOKEN (no stored file — good for sandboxes), which takes precedence over the stored one. --api-url overrides the base URL for one call. Errors go to stderr with a non-zero exit; a 401 means "run freehire auth login".

Which skill does what

The person wants to… Skill
find jobs, read a posting, hand over a link freehire lacks freehire-job-search
record and follow what they applied to; report a posting that never answered freehire-track-applications
know how well their stack covers the live market, and what to learn freehire-market-fit
reframe their CV toward one vacancy freehire-tailor-cv
sort their application mail into the tracker freehire-mail-triage

Three rules that hold everywhere

  • Prefer --json and parse with jq. Human output is for people.
  • Ground every filter value in freehire facets before using it. It is the vocabulary source of truth — facet values and canonical skill slugs (go, react, kubernetes, lowercase) both come from there. Do not invent values.
  • The API key is the user's whole account. Keep it in the harness's secret store or FREEHIRE_TOKEN, never in a repo or a log. It can be revoked from the web app.

Read the full file on GitHub · 49 lines

Changes

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.

  1. 8d ago First seen · 49 lines · 64 tokens per session scan C f094f8cf679b

Subscribe to this mod's changes

using-freehire is a skill published in the GitHub repository strelov1/freehire-cli (5 stars, last pushed today), licensed MIT. It adds 64 tokens to every session and 594 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

resume-tailoring

Methodology for tailoring a resume to a job description honestly and effectively — fit analysis, gap handling, keyword mirroring, fast-learner framing, and primary-over-secondary emphasis. Use whenever curating or rewriting a resume for a specific role.

snehag01/rebound · 53 tokens

alive:system-cleanup

The world feels messy. Stale tasks, orphan folders, v2 remnants, unsaved sessions — entropy is accumulating and needs to be addressed before it compounds. Scans across all walnuts, then surfaces issues one at a time.

alivecontext/alive · 52 tokens

alive:world

The human doesn't know what to work on, or wants to see everything at once. They need the big picture — what's active, what's stale, what needs attention. Renders a live world view grouped by ALIVE domain, then routes to open, tidy, find, history, or map.

alivecontext/alive · 63 tokens

alive:bundle

Create, share, and graduate bundles — the unit of focused work within a walnut. Manages the full bundle lifecycle from creation through sharing to graduation.

alivecontext/alive · 34 tokens

alive:settings

The human wants to adjust how the system behaves — not what it contains, but how it feels. Voice, rhythm, preferences, walnut-level config, full permissions toggleable, named squirrel config, action logging toggle. The system adapting to them. Routes to preferences.yaml or walnut config.yaml depending on scope. For…

alivecontext/alive · 84 tokens

alive-cleanup

System maintenance -- stale tasks, orphan folders, unsaved sessions, world health check.

alivecontext/alive · 20 tokens