Skills for finding a job on hh

Search, evaluate, and manage job opportunities for a candidate across the Russian market with hh.ru, Habr Career, Telegram vacancy channels/chats, and LinkedIn as a secondary source. Use when building a candidate profile, filtering vacancies by salary/stack/seniority/remote format, scoring job relevance, tailoring resumes or cover letters, tracking applications, or running controlled job-hunt workflows with explicit safety rules for outreach and auto-apply.

Nikolay Kuznetsov@naxofon

Install

openclaw skills install @naxofon/hh-job-search

Job Search

Use this skill to run a structured job-hunt workflow without turning the agent into an uncontrolled spam bot.

Core workflow

Build or update the candidate profile.
Define target roles, salary floor, geography, work format, and exclusions.
Before collecting vacancies from any browser-based source (especially hh.ru), force a page refresh/reload so newly published postings appear.
For hh.ru in Browser Relay / logged-in browser flows, do not trust the currently rendered list until after an explicit refresh of the active search results tab.
Before checking whether an hh resume can be raised in search, refresh the page that shows the resume cards; stale hh UI can falsely show a cooldown when the raise is already available.
When the user asks to raise resumes on hh without narrowing it down, raise all relevant active resumes that are currently available after refresh, not just one.
Collect vacancies from the supported sources.
Normalize each vacancy into a common structure.
Score each vacancy: strong match / possible match / skip.
Save the shortlist and application state in durable workspace files.
Tailor resume / cover letter only for shortlisted roles.
Apply or message recruiters only under the allowed mode.

Supported sources

Primary:

hh.ru
Habr Career
Telegram vacancy channels and chats

Secondary:

Read references/source-strategy.md when choosing source priority and source-specific handling.

Operating modes

1. Research-only

Use when the user wants market scanning, salary mapping, or a shortlist.

Search and score vacancies.
Do not apply.
Do not send messages.

2. Assisted apply

Use when the user wants help preparing applications but still approves submission.

Search and score vacancies.
Tailor resume / cover letter.
Prepare answers and a pipeline row.
Do not submit without clear approval.

3. Controlled auto-apply

Use only when the user explicitly allows automatic submission.

Apply only to strong-match vacancies.
Respect per-source limits.
Log every submission.
Never send recruiter DMs unless separately allowed.

4. Outreach-enabled

Use only when the user explicitly allows recruiter outreach.

Follow the same rules as controlled auto-apply.
Use short, factual messages.
Log every outbound message.

Hard safety rules

Never contact recruiters or hiring managers unless the user explicitly allows outreach.
Never auto-apply unless the user explicitly enables auto-apply.
Never invent experience, stack, salary history, notice period, education, or citizenship details.
Never overwrite a candidate master profile silently; append or propose diffs.
Prefer fewer high-fit applications over mass low-fit submissions.
Log every external action in the project workspace.
Never mark an hh application as sent just because the "Откликнуться" button was clicked.
On hh, treat an application as successful only after explicit UI confirmation that the response/application was sent or the vacancy appears in the sent responses state.
If success cannot be verified, record the state as apply-unconfirmed or apply-failed, not applied.
Before deciding that hh resume raising is unavailable or still on cooldown, refresh the resume page first; stale hh UI is not a reliable signal.
Never answer screening questions or other free-text prompts without first showing them to the user and getting approval.
After a verified hh apply, immediately refresh the resumes page and raise all relevant active resumes that are available, unless the user explicitly disables that post-apply raise step.
When a bundled hh apply script/workflow already encodes required post-apply behavior, prefer that script/workflow over ad-hoc manual browser clicking for real applications.

Read references/safety-rules.md before enabling outreach or auto-apply.

Workspace layout

Prefer a durable project folder such as:

text

projects/job-search/
  PROFILE.md
  TARGET_ROLES.md
  SEARCH_RULES.md
  SOURCES.md
  PIPELINE.md
  OUTREACH_RULES.md
  BLACKLIST.md
  applications/
  exports/
  logs/

If the project does not exist yet, create it before doing serious work.

Vacancy normalization

Normalize each vacancy into these fields when possible:

source
source_url
company
title
stack
seniority
salary_min
salary_max
salary_currency
gross_or_net
location
remote_mode
employment_type
visa_or_relocation
english_level
contact_name
contact_url
summary
fit_score
fit_label
fit_reasons
red_flags
status

Source-specific notes

hh.ru

Treat as the primary source for Russian-market roles.
Normalize salary carefully; gross/net may differ by posting.
Capture employer type, location, and work format.

Habr Career

Prefer for engineering/product/design roles with better tech signal.
Preserve stack and level details from the description.

Expect noisy, duplicated, and weakly structured posts.
Deduplicate aggressively.
Parse salary, stack, and contact info from free text.
Treat direct recruiter handles as contact data, not permission to message.

Use as a secondary source.
Focus on roles that are materially better than local-market baseline or clearly international/remote.

Tailoring outputs

For a strong-match vacancy, prepare:

1 tailored resume variant
1 short cover letter or intro note
3-6 bullet reasons why the role fits
optional answers to standard screening questions

Keep tailoring factual and specific to the vacancy.

Scripts

Prefer the bundled Python tools over ad-hoc manual parsing. Install the Python dependencies first when you need the scoring/deduplication libraries:

bash

python -m pip install -r skills/job-search/scripts/requirements.txt

Available tools:

scripts/requirements.txt — Python deps for the scoring/normalization toolkit (pydantic, rapidfuzz)
references/onboarding.md — resume-first onboarding and HH Browser Relay setup guidance for first-run users
scripts/init_job_search_project.py — create a durable project folder from templates
scripts/profile_to_json.py — convert project markdown files into a compact scoring profile JSON
scripts/job_match_score.py — score vacancy JSON against a profile JSON
scripts/score_vacancy_from_project.py — score one vacancy directly against a project folder
scripts/score_vacancies_jsonl.py — score a JSONL batch against a project folder
scripts/normalize_salary.py — normalize salary text into structured fields
scripts/parse_telegram_job.py — extract a Telegram vacancy post into structured JSON
scripts/batch_parse_telegram_jobs.py — process a directory of Telegram posts into JSONL
scripts/normalize_vacancy.py — normalize a raw vacancy text/JSON payload into the common vacancy schema
scripts/batch_normalize_vacancies.py — normalize a directory of raw vacancy payloads into JSONL
scripts/dedupe_vacancies.py — cluster likely duplicate vacancies from JSONL input
scripts/canonicalize_deduped.py — convert dedupe output into canonical-only JSONL
scripts/pipeline_add.py — append a structured vacancy into PIPELINE.md
scripts/export_shortlist.py — export strong or high-score vacancies into CSV

Assets

Use assets/templates/ when creating a new durable job-search project. These templates seed:

README-START.md
PROFILE.md
TARGET_ROLES.md
SEARCH_RULES.md
SOURCES.md
PIPELINE.md
OUTREACH_RULES.md
BLACKLIST.md

References

Read only what you need:

references/onboarding.md — first-run flow for resume/CV intake and when/how to instruct Browser Relay setup for HH automation
references/source-strategy.md — source priorities and source-specific handling
references/safety-rules.md — boundaries for outreach and auto-apply
references/project-layout.md — recommended durable workspace structure
references/data-flow.md — practical end-to-end batch flow for this skill
references/file-formats.md — expected JSON/JSONL/project markdown formats