job-preferences

Set or update your job search preferences (titles, salary, remote, filters). Used by /job-search and other skills.

Job Preferences

A Claude Code skill for managing persistent job search preferences. Set your target titles, salary floor, remote preference, and exclusion filters once — /job-search and other skills reuse them automatically.


Workflow

Step 1: Load Profile

Read ~/.claude-job-profile.json. If the file doesn't exist yet, create it with an empty object {}.

Step 2: Check for Existing Preferences

Look for the preferences key in the profile.

If preferences exist, display them:

Your current job search preferences:

  • Target titles: Staff AI Engineer, Principal ML Engineer
  • Min base salary: $250K
  • Remote preference: Remote only
  • Exclude patterns: junior, associate, intern, entry level
  • Default time range: last week

Would you like to update any of these?

Then wait for the user. If they say no, stop. If they want to update, ask only about the fields they want to change using AskUserQuestion.

If no preferences exist, run the full Q&A below.

Step 3: Collect Preferences (full Q&A)

Use AskUserQuestion to collect all fields. Ask up to 4 questions at a time (the tool's limit).

Question batch 1:

  1. Target titles (multi-select + custom)

    • Header: "Titles"
    • Question: "Which job titles are you targeting?"
    • Options: Staff AI Engineer, Principal ML Engineer, Director of AI, Head of ML
    • Multi-select: true
    • The user can add custom titles via "Other"
  2. Min base salary

    • Header: "Salary"
    • Question: "What is your minimum base salary?"
    • Options: $200K, $250K, $300K
    • Multi-select: false
  3. Remote preference

    • Header: "Remote"
    • Question: "What is your remote work preference?"
    • Options: Remote only, Remote preferred, Open to hybrid, Open to all
    • Multi-select: false
  4. Exclude patterns (multi-select)

    • Header: "Exclude"
    • Question: "Which patterns should be excluded from results?"
    • Options: junior, associate, intern, entry level
    • Multi-select: true

Question batch 2:

  1. Default time range
    • Header: "Time range"
    • Question: "What default time range should job searches use?"
    • Options: Last week, 2 weeks, Month
    • Multi-select: false

Step 4: Save Preferences

Write the collected values into ~/.claude-job-profile.json under the preferences key. Preserve all other existing keys in the file (like profile data used by /job-apply).

Schema:

{
  "preferences": {
    "targetTitles": ["Staff AI Engineer", "Principal ML Engineer"],
    "minBaseSalary": "$250K",
    "remotePreference": "remote only",
    "excludePatterns": ["junior", "associate", "intern", "entry level"],
    "defaultTimeRange": "last week"
  }
}

Step 5: Confirm

Display the saved preferences and confirm:

Preferences saved to ~/.claude-job-profile.json.

These will be used automatically by /job-search. Run /job-preferences again any time to update them.


Updating Preferences

When the user runs /job-preferences and preferences already exist, show current values and let them update selectively. Only overwrite the fields they change — keep the rest intact.


Safety Rules

  1. Never overwrite non-preference data — only read/write the preferences key in the profile JSON
  2. Preserve existing profile/job-apply stores resume data in the same file; never delete or modify those keys
  3. No defaults without user input — always ask the user, never assume values