jobscan-doctor

Diagnoses JobScan configuration, dependencies, and session tools before weekly job scans.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/MarioLuppino/JobScanPlugin --skill jobscan-doctor-marioluppino
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: jobscan-doctor
Source: https://github.com/MarioLuppino/JobScanPlugin/tree/main/plugins/jobscan/skills/jobscan-doctor
Command: npx skills add https://github.com/MarioLuppino/JobScanPlugin --skill jobscan-doctor-marioluppino

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? A job scan can silently degrade — a config at the wrong path, an empty employer registry, or a Firecrawl connection that was never loaded in the current session — and return a fraction of expected results while looking like it worked. This Skill turns every silent degradation into one visible, fixable line. ## Core Features & Use Cases - Automated environment check: Runs a Node script that verifies Node's version, config paths, the data folder, profile files, job-title patterns, the employer registry, feed lists, the seen-URL cache, the federal API key, the archive folder, and the applied index. - Session-level checks a script cannot do: Verifies Firecrawl tools are actually loaded, the docx skill is available, browser fallback tools exist, a subagent dispatch tool is present, and the plugin root variable resolves. - Step zero of every scan: Runs automatically before each job-search run, classifying issues as fatal (stop and offer onboarding), degrading (continue with a noted fallback), or thin (mention once at the end). - Use Case: A user's scan returned almost nothing. They say "check my job scanner" and receive a plain-words list of what works, what is broken, and the one fix for each problem — such as restarting Claude Code to load Firecrawl. ## Quick Start Ask the assistant to check my job scanner and report anything that is not working with the fix for each issue.

Frequently Asked Questions about jobscan-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check why my job scan found nothing?▼

Run the doctor check, which inspects the config file, employer registry, profile files, and feed list from disk, then verifies session-level tools like Firecrawl and the docx skill. Each problem is reported in plain words with one fix.

Why does Firecrawl show connected but not work in my session?▼

A connected line in the config only records what onboarding did, not what the current session loaded. MCP servers load at session start, so the fix is to restart Claude Code after connecting Firecrawl.

Can a job scan work without Firecrawl?▼

Yes for Greenhouse, Lever, SmartRecruiters, Ashby, and Workable boards, which plain fetch reads fine. Government and large-enterprise portals like NEOGOV, Workday, and USAJOBS cannot be read without Firecrawl or browser tools, so no packets are drafted for them.

What happens if the setup was never run before checking?▼

The script detects an install that never completed onboarding and reports it as a single condition rather than a list of missing files. The correct response is to offer to run onboarding and stop, not to enumerate missing files.

Does the doctor check run automatically before every scan?▼

Yes, it runs as step zero of every job-search run. Fatal issues stop the scan with an offer to run onboarding, degrading issues continue on a fallback path with a note in the digest, and thin issues are mentioned once at the end.