Skills auto-job-applier

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/atharva-badgujar/auto-job-applier" ~/.claude/skills/openclaw-skills-auto-job-applier && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/atharva-badgujar/auto-job-applier" ~/.openclaw/skills/openclaw-skills-auto-job-applier && rm -rf "$T"
manifest: skills/atharva-badgujar/auto-job-applier/SKILL.md
source content

Auto Job Applier Skill

This skill connects to the user's resumex.dev account, reads their resume data, matches them to relevant jobs via web search, presents an approval list, then automatically applies to approved jobs using browser automation — filling forms, answering screening questions, and submitting applications. All applications are logged to the resumex.dev job tracker.

Architecture: ResumeX stores resume data and the job tracker. OpenClaw's built-in AI does all the thinking and text generation (cover letters, screening answers, scoring). Web search finds jobs. Browser tool fills and submits applications.

user_preferences.json
remembers extra info between sessions.

No third-party AI API keys required. This skill uses only OpenClaw's built-in LLM for all AI tasks (cover letter drafting, screening question answers, job scoring). The only external API key needed is

RESUMEX_API_KEY
.


Required Environment Variable

VariableRequiredDescription
RESUMEX_API_KEY
RequiredAPI key from resumex.dev → Dashboard → Resumex API
JOB_SEARCH_LOCATION
OptionalOverride city/country for job search
JOB_TYPE
Optional
full-time
|
part-time
|
contract
|
internship
REMOTE_ONLY
Optional
true
|
false
(default:
false
)
MAX_APPLICATIONS
OptionalMax jobs to apply per session (default:
5
)

How to set

RESUMEX_API_KEY
in OpenClaw:

  1. Go to resumex.dev → Dashboard → Resumex API
  2. Click Generate API Key
  3. In OpenClaw, go to Settings → Environment Variables
  4. Add
    RESUMEX_API_KEY
    with the copied key value

No other keys are needed. There is no Anthropic key, no OpenAI key, no other third-party service.


Privacy & Data Handling

Read this before using the skill.

What data leaves your device

DataSent ToWhy
Resume data (API read)resumex.devTo fetch your resume for job matching
Application logs (company, role, URL, status)resumex.devTo track your job applications
Your name, email, phone, LinkedInJob application websitesTo fill application forms
Cover letter (generated text)Job application websitesSubmitted as part of each application

Data sent to resumex.dev is governed by the resumex.dev Privacy Policy.

What stays local on your device

DataLocationWhat It Contains
data/user_preferences.json
Skill directory onlySalary expectation, visa status, notice period, address, gender, date of birth, ethnicity, veteran status, disability status, screening question answers

⚠️

user_preferences.json
may contain sensitive personal data including date of birth, gender, ethnicity, veteran status, and disability status (only if you choose to save these when prompted during a form fill). This file is stored locally only and is never sent to resumex.dev or any other server. Review and restrict its filesystem permissions if needed:

chmod 600 data/user_preferences.json

To clear all saved preferences at any time:

python3 scripts/manage_preferences.py reset

Sensitive fields in preferences

The following fields are only saved if you explicitly provide them when the agent encounters a form field that requires them. You can decline to answer, skip the field, or delete a saved value at any time:

  • gender
    — only for diversity/EEO forms
  • ethnicity
    — only for diversity/EEO forms (optional, you may leave blank)
  • veteran_status
    — only for U.S. government/contractor compliance forms
  • disability_status
    — only for compliance forms (optional)
  • date_of_birth
    — only for forms that legally require it

The agent will always tell you which form requires a sensitive field before asking for the value.

Auto-submit safeguard

The agent NEVER submits an application without your explicit approval. Step 6 of the workflow always presents a formatted approval list and waits for your response before any browser interaction begins. If you are testing, set

MAX_APPLICATIONS=1
in your environment.


Workflow Overview

1. Fetch resume data from resumex.dev API
2. Load saved user preferences (salary, visa, screening answers)
3. Build a job-match profile (skills, roles, seniority, preferences)
4. Search the web for matching jobs (3–5 query permutations)
5. Score & rank each job against the resume (0–100)
6. ⛔ APPROVAL GATE — Present formatted list → wait for user selection
7. For each approved job:
   a. Generate a tailored cover letter (via OpenClaw's built-in AI)
   b. Navigate to application page via browser
   c. Fill form fields using resume data + preferences
   d. If a required field is unknown → ask the user → save to preferences
   e. Submit the application
   f. Log to resumex.dev job tracker
8. Present final summary with statuses

Step 1 — Fetch Resume from resumex.dev

Use the agent endpoint. All calls require

Authorization: Bearer $RESUMEX_API_KEY
.

# Fetch full resume data (GET /api/v1/agent — the correct endpoint)
curl -s -X GET "https://resumex.dev/api/v1/agent" \
  -H "Authorization: Bearer $RESUMEX_API_KEY" \
  -H "Content-Type: application/json"

Note: The endpoint is

/api/v1/agent
(NOT
/api/v1/agent/resume
, which is deprecated). The helper scripts handle retries with exponential backoff automatically. Install dependencies first:
pip3 install -r requirements.txt

Or via the helper script:

# Full resume JSON
python3 scripts/fetch_resume.py

# Extract a specific field for form filling
python3 scripts/fetch_resume.py --field email
python3 scripts/fetch_resume.py --json-path profile.phone

Expected response shape:

{
  "success": true,
  "data": {
    "activeResumeId": "...",
    "resumes": [{
      "id": "...",
      "data": {
        "profile": {
          "fullName": "...", "email": "...", "phone": "...",
          "location": "...", "summary": "...",
          "linkedin": "...", "github": "...", "website": "..."
        },
        "skills": [{"category": "...", "skills": ["...", "..."]}],
        "experience": [
          {
            "role": "...", "company": "...", "location": "...",
            "startDate": "...", "endDate": "...", "description": "..."
          }
        ],
        "education": [{"degree": "...", "institution": "...", "endDate": "...", "score": "..."}],
        "projects": [{"name": "...", "description": "...", "tags": ["..."]}],
        "achievements": [{"title": "...", "year": "..."}]
      }
    }]
  }
}

Parse the active resume:

workspace = response.data
activeResume = workspace.resumes.find(r => r.id === workspace.activeResumeId)
resumeData = activeResume.data

Error handling:

HTTP CodeCauseFix
401
RESUMEX_API_KEY
is missing or invalid
Go to resumex.dev → Dashboard → Resumex API → generate a new key
404
Resume not created yetGo to resumex.dev → create and publish your resume
429
Rate limitedWait 10 seconds, retry once

Step 2 — Load Saved User Preferences

Check for previously saved preferences that supplement the resume data:

python3 scripts/manage_preferences.py list

This returns any saved answers like salary expectation, visa status, notice period, etc. If

user_preferences.json
doesn't exist yet, that's fine — it will be created when the user is first asked for missing information.

Preference fields to look for:

  • salary_expectation
    — e.g. "8-12 LPA" or "$80,000-$100,000"
  • currency
    — e.g. "INR" or "USD"
  • notice_period
    — e.g. "30 days" or "Immediate"
  • visa_status
    — e.g. "No visa required (Indian citizen)"
  • work_authorization
    — e.g. "Authorized to work in India"
  • willing_to_relocate
    — true/false
  • preferred_work_type
    — "remote" | "hybrid" | "onsite"
  • screening_answers
    — dict of previously answered screening questions

Step 3 — Build Job-Match Profile

From the resume JSON and user preferences, extract and infer:

FieldHow to Derive
Target rolesLatest
experience[0].role
+ adjacent titles (e.g. "Software Engineer" → "Backend Developer", "Full Stack Developer")
Key skillsTop 5–8 from flattened
skills[].skills
arrays + tech stack from
experience[].description
SeniorityYears of experience calculated from earliest
startDate
to today
Location
profile.location
(override with
JOB_SEARCH_LOCATION
env var if set)
Job type
JOB_TYPE
env var or
preferred_work_type
from preferences (default: full-time)
Remote
REMOTE_ONLY
env var (default: false)
IndustryInfer from company names / job descriptions in experience

Example derived profile:

Roles: Software Engineer, Backend Developer, Full Stack Developer
Skills: Python, Django, React, PostgreSQL, Docker, AWS
Seniority: Mid-level (3 years)
Location: Pune, India
Type: Full-time
Remote: No preference
Salary: 8-12 LPA (from preferences)

Step 4 — Search for Matching Jobs

Use web_search to find real, current job postings. Run 3–5 targeted searches using different query permutations to maximize coverage.

Query templates:

"{role}" "{top_skill}" jobs "{location}" site:linkedin.com OR site:naukri.com OR site:indeed.com
"{role}" "{top_skill}" "{second_skill}" hiring 2026
"{role}" remote jobs "{top_skill}" "{seniority}"
"{role}" "{top_skill}" jobs "{location}" "apply now" site:wellfound.com OR site:internshala.com

See

references/job_boards.md
for complete query patterns per board.

For each search result URL, use web_fetch to extract:

  • Job title
  • Company name
  • Location (or Remote)
  • Job URL (apply link)
  • Required skills (from description)
  • Nice-to-have skills
  • Experience required
  • Salary range (if visible)
  • Application method:
    form
    |
    easy-apply
    |
    email
    |
    redirect

Aim to collect 10–20 raw job postings before scoring.


Step 5 — Score & Rank Jobs

Score each job 0–100 against the resume profile:

FactorMax Points
Skill overlap (required skills matched)40
Role title match20
Seniority match15
Location / remote match15
Industry familiarity10

Formula:

score = (skills_matched / skills_required) * 40
      + role_title_match * 20    # 20 if exact, 10 if adjacent, 0 if unrelated
      + seniority_match * 15     # 15 if exact, 8 if ±1 level, 0 if 2+ off
      + location_match * 15      # 15 if match, 8 if remote, 0 if mismatch
      + industry_match * 10      # 10 if same industry, 5 if adjacent

Step 6 — Present Approval List to User ⛔

Present the top 10 matches in a formatted table. The user MUST approve before any applications are submitted. Never auto-apply without explicit approval. Never skip this step.

Format:

🎯 Job Match Results for [Name]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

#   Score  Company          Role                     Location        Apply Method
──  ─────  ───────          ────                     ────────        ────────────
1   92     Acme Corp        Software Engineer        Pune (On-site)  🤖 Auto-apply
2   87     TechStartup      Backend Developer        Remote          🤖 Auto-apply
3   81     MegaCorp India   Full Stack Engineer      Mumbai          🤖 Auto-apply
4   76     DevShop          Python Developer         Pune (Hybrid)   🤖 Auto-apply
5   73     CloudCo          API Engineer             Remote          🤖 Auto-apply
6   70     DataInc          Backend Engineer         Bangalore       🔗 Manual (LinkedIn)
7   68     StartupXYZ       Software Developer       Remote          🤖 Auto-apply
8   65     BigTech          Junior SWE               Hyderabad       🤖 Auto-apply
9   62     ConsultFirm      Technical Consultant     Pune            📧 Email apply
10  58     SmallCo          Full Stack Developer     Remote          🤖 Auto-apply

🤖 = Agent will fill and submit the application automatically
🔗 = LinkedIn — agent will open the page, you submit manually
📧 = Email — agent will draft the email, you review and send

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Which jobs would you like to apply to?
Options: "all", "1,3,5", "1-5", "none", or "1-5 except 3"

Apply method classification:

  • 🤖 Auto-apply
    — Standard form-based application. Agent fills and submits.
  • 🔗 Manual (LinkedIn)
    — LinkedIn Easy Apply. Agent navigates to the page but user must submit. (LinkedIn automated submission is disabled by default due to ToS concerns.)
  • 📧 Email apply
    — Agent drafts the application email for user review.
  • 🔗 Manual (redirect)
    — Redirects to external ATS. Agent navigates, user may need to complete.

Wait for the user to respond with their selection before proceeding.


Step 7 — Auto-Apply to Approved Jobs

For each job the user approved, execute the following sub-steps:

7a. Generate Cover Letter (via OpenClaw's built-in AI)

No external AI API is used. Cover letters are generated by OpenClaw's own LLM.

The

draft_cover_letter.py
script reads resume data and job details, then outputs a structured prompt. OpenClaw's agent uses that prompt with its built-in AI to generate the cover letter.

python3 scripts/draft_cover_letter.py \
  --resume /tmp/resume.json \
  --job_title "Software Engineer" \
  --company "Acme Corp" \
  --job_description "We are looking for..." \
  --output /tmp/cover_letter_acme.txt

The script outputs the generation prompt to stdout. The agent then:

  1. Reads the prompt
  2. Uses its built-in LLM to generate the cover letter text
  3. Saves the result to the
    --output
    path if specified

Cover letter structure:

  1. Hook (1 sentence): why this specific company/role excites the candidate
  2. Match (2–3 sentences): specific skills/experiences that directly map to job requirements
  3. Value add (1–2 sentences): a concrete result from their past work
  4. Close (1 sentence): call to action

Keep it under 200 words. Professional but human tone.

7b. Navigate to Application Page

Use the browser tool to navigate to the job's application URL:

browser: navigate to "{job_url}"

Wait for the page to load. Take a screenshot to confirm you're on the right page.

7c. Identify Form Fields

Analyze the page to identify the application form. Look for:

  • Input fields (
    <input>
    ,
    <textarea>
    ,
    <select>
    )
  • Required indicators (
    *
    ,
    required
    attribute)
  • Submit buttons
  • Multi-step form indicators (next/continue buttons)

See

references/form_field_mappings.md
for mapping form labels to resume data.

7d. Fill Form Fields

For each form field, use this priority order to find the value:

1. Resume data (from ResumeX API)           → profile.email, profile.phone, etc.
2. User preferences (from preferences.json) → salary_expectation, visa_status, etc.
3. Derived data (calculated by agent)       → years of experience, full name split, etc.
4. Ask the user (last resort)               → save answer to preferences for reuse

Common field mappings (see

references/form_field_mappings.md
for full list):

Form LabelSourceJSON Path
First NameResume
profile.fullName
(split, take first)
Last NameResume
profile.fullName
(split, take last)
EmailResume
profile.email
PhoneResume
profile.phone
LinkedIn URLResume
profile.linkedin
GitHub URLResume
profile.github
WebsiteResume
profile.website
Current LocationResume
profile.location
Current CompanyResume
experience[0].company
Current TitleResume
experience[0].role
Years of ExperienceDerivedCalculate from earliest
startDate
Salary ExpectationPreferences
salary_expectation
Notice PeriodPreferences
notice_period
Cover LetterGeneratedFrom Step 7a

Browser fill commands:

browser: click on the "First Name" input field
browser: type "{first_name}"
browser: click on the "Email" input field
browser: type "{email}"
...
browser: click on the "Cover Letter" textarea
browser: type "{cover_letter_text}"

7e. Handle File Upload Fields

If the form has a resume/CV upload field:

  • Do NOT attempt to upload a file automatically.
  • Note it in the summary: "⚠️ Resume upload required — please upload manually"
  • Fill all other fields and leave the upload for the user.

7f. Handle Unknown Fields — Ask & Remember

If a form field requires information not in the resume or saved preferences:

  1. Pause the application (do not skip the field)
  2. Ask the user: "The application for [Company] - [Role] requires: [field name]. What should I enter?"
  3. Save the answer for future use:
python3 scripts/manage_preferences.py set "[field_key]" "[user_answer]"
  1. Fill the field with the user's answer and continue

When asking for sensitive fields (gender, ethnicity, DOB, veteran/disability status), always mention which company's form requires it and that the answer will be saved locally. The user may decline — if so, skip the field or leave it blank if optional.

Don't ask again for the same field type. Once "salary expectation" is saved, use it for all future applications unless the user explicitly changes it.

7g. Handle Screening Questions

Many application forms include screening questions. For each question:

  1. Check
    user_preferences.screening_answers
    for a saved answer (fuzzy match on question text)
  2. If found → use saved answer
  3. If not → present the question to the user with the options available
  4. Save the answer to preferences:
python3 scripts/manage_preferences.py set-screening "authorized_to_work" "Yes"

Common screening questions and strategies:

  • "Are you authorized to work in [country]?" → check
    visa_status
    /
    work_authorization
  • "Do you require sponsorship?" → derive from
    visa_status
  • "What is your expected salary?" → use
    salary_expectation
  • "What is your notice period?" → use
    notice_period
  • "Are you willing to relocate?" → use
    willing_to_relocate
  • "Why are you interested in this role?" → generate using OpenClaw's built-in LLM from resume + job description
  • "Describe your experience with [X]" → generate using OpenClaw's built-in LLM from resume data

See

references/screening_questions.md
for the full list.

7h. Submit the Application

After all fields are filled:

  1. Take a screenshot of the completed form for the user's records
  2. Click the submit button
  3. Wait for confirmation (success page, confirmation message, or redirect)
  4. Take a screenshot of the confirmation
  5. If submission fails, note the error and move to the next job

7i. Log to resumex.dev Job Tracker

After submission (or attempted submission), log the application:

python3 scripts/log_application.py \
  --company "Acme Corp" \
  --role "Software Engineer" \
  --url "https://careers.acme.com/apply/12345" \
  --status "applied" \
  --method "auto-applied" \
  --score 92 \
  --notes "Auto-applied via job applier skill."

Use

--dry-run
to test without calling the API:

python3 scripts/log_application.py \
  --company "Test" --role "Test" --url "https://example.com" --dry-run

The script automatically tries multiple endpoints (

/api/v1/agent/jobs
, then
/api/v1/agent/logs
) with retry logic and exponential backoff.

Or via curl:

curl -s -X POST "https://resumex.dev/api/v1/agent/jobs" \
  -H "Authorization: Bearer $RESUMEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company": "Acme Corp",
    "position": "Software Engineer",
    "url": "https://careers.acme.com/apply/12345",
    "status": "applied",
    "appliedDate": "2026-04-14",
    "notes": "Auto-applied via Auto Job Applier skill. Match score: 92/100. Method: auto-applied."
  }'

Step 8 — Present Final Summary

After all approved applications are processed, show a clean summary:

✅ Application Summary for [Name]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

#  Company          Role                    Score   Status
1  Acme Corp        Software Engineer       92/100  ✅ Applied (auto)
3  MegaCorp India   Full Stack Engineer     81/100  ✅ Applied (auto)
5  CloudCo          API Engineer            73/100  ✅ Applied (auto)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 Results: 3 applied ✅ | 0 failed ❌ | 0 manual 🔗

📝 Notes:
  • All applications logged to your resumex.dev tracker
  • Cover letters generated using OpenClaw's built-in AI
  • Saved preferences: salary_expectation, notice_period (for future use)

💡 Tip: Re-run this skill weekly for fresh job listings!

If any applications had issues:

⚠️ Issues:
  • CloudCo (API Engineer) — Resume upload required. Open the application and upload manually:
    https://careers.cloudco.com/apply/67890

Error Handling

All HTTP scripts use the shared

http_client.py
module which provides automatic retry with exponential backoff. Transient errors (429, 5xx, network timeouts) are retried up to 3 times before failing. The
Retry-After
header is respected for rate limits.

ErrorCategoryResponse
401 Unauthorized
AuthAsk user to check
RESUMEX_API_KEY
in OpenClaw environment
403 Forbidden
AuthAPI key lacks permission — regenerate at resumex.dev
404 Not Found
Not FoundResume may not be set up, or endpoint has changed
429 Rate Limited
Rate LimitAuto-retried up to 3×, respects
Retry-After
header
5xx Server Error
ServerAuto-retried with exponential backoff (1s, 2s, 4s)
Network timeoutNetworkAuto-retried once, then fails with clear message
No jobs foundSearchBroaden search: remove location filter, try adjacent roles
Web search blockedSearchTry alternate job boards (Naukri, Internshala, Wellfound, etc.)
Browser can't load pageBrowserNote the job as "manual apply" and provide the link
Form field type unknownFormAsk the user what to enter, save to preferences
Submit button not foundFormTake screenshot, ask user to review the page
Application page requires loginBrowserInform user to log in first, then retry
CAPTCHA detectedBrowserSkip this application, mark as "manual", provide link
Multi-step form timeoutBrowserSave progress screenshot, note which step failed

Important Rules

  1. NEVER auto-apply without user approval. Always present the approval list (Step 6) first.
  2. Always fetch fresh resume data at the start of each session. Don't cache across sessions.
  3. Cache within a session — fetch the resume once when the skill starts, reuse for all applications.
  4. Save every unknown field to preferences — the user should never be asked the same question twice.
  5. LinkedIn jobs are manual-only by default. Don't attempt LinkedIn Easy Apply unless the user explicitly requests it (ToS risk).
  6. Skip file upload fields — note them for the user to complete manually.
  7. Take screenshots before and after form submission for the user's records.
  8. Handle CAPTCHAs gracefully — if detected, mark the job as "manual apply" and move on.
  9. Rate limits — resumex.dev API has rate limits. Don't call the resume endpoint more than once per session.
  10. No external AI APIs — cover letters and text generation use OpenClaw's built-in LLM only.
  11. Privacy — resume data is fetched live from resumex.dev. Saved preferences are stored locally only in
    data/user_preferences.json
    and never transmitted to any server.
  12. Sensitive fields — always inform the user before saving sensitive data (gender, DOB, ethnicity, etc.) and allow them to decline.

Files in This Skill

FilePurpose
SKILL.md
This file — main instructions for the agent
scripts/http_client.py
Shared HTTP client with retries, backoff, and error classification
scripts/fetch_resume.py
Fetches and parses resume from resumex.dev (supports
--field
extraction)
scripts/search_jobs.py
Constructs search queries and parses job posting results
scripts/fill_application.py
Maps form fields to resume data, outputs browser instructions
scripts/manage_preferences.py
CRUD for
user_preferences.json
(salary, visa, screening answers)
scripts/draft_cover_letter.py
Builds cover letter prompt for OpenClaw's built-in AI (no external API)
scripts/log_application.py
Logs a job application to resumex.dev tracker (with
--dry-run
support)
requirements.txt
Python dependencies (
requests>=2.28.0
)
references/job_boards.md
Job board search patterns, form selectors, browser notes
references/form_field_mappings.md
Maps form field labels → resume JSON paths
references/screening_questions.md
Common screening questions and handling strategies
data/user_preferences.json
Persistent local storage for user answers (auto-created at runtime)