scan

Automates job posting discovery, description extraction, and CV-to-JD evaluation into a dated Markdown report.

3|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/MLMario/JobSearchScan --skill scan-mlmario
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scan
Source: https://github.com/MLMario/JobSearchScan/tree/main/.claude/skills/scan
Command: npx skills add https://github.com/MLMario/JobSearchScan --skill scan-mlmario

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the end-to-end process of discovering open job postings, enriching them with full descriptions, and evaluating fit against your CV and preferences, delivering a clear pass/fail narrative.

Core Features & Use Cases

  • Discovery: fetches open listings from configured company portals via ATS APIs, with Playwright as a fallback for custom pages.
  • Extraction: fills in missing job descriptions by visiting posting URLs and extracting schema.org JobPosting data.
  • Evaluation: runs a four-step checklist (dealbreakers, hard/soft preferences, CV-to-JD alignment, and rationale) and writes a dated Markdown evaluation report to reports/YYYY-MM-DD-evaluation.md.
  • Use Case: job seekers and recruiters who want automated discovery, enrichment, and evaluation to quickly triage opportunities.

Quick Start

Run the /scan command to execute the end-to-end workflow.

Frequently Asked Questions about scan

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

FAQPage Schema
How do I automate job postings discovery and CV evaluation against job descriptions?

Automated job postings discovery and CV evaluation works by fetching listings from company portals via ATS APIs, extracting schema.org JobPosting data, and scoring CV-to-JD alignment against your preferences. It outputs a dated Markdown evaluation report with a clear pass/fail narrative.

How does automated CV-to-JD alignment scoring handle dealbreakers and preferences?

CV-to-JD alignment scoring applies a four-step checklist evaluating dealbreakers, hard preferences, soft preferences, and overall rationale. This process generates a pass/fail narrative based on your specific CV and job requirements.

Can I use Playwright as a fallback for job description extraction when ATS API is unavailable?

Playwright is used as a fallback for job description extraction when ATS API access is unavailable or custom portal pages are encountered. It visits posting URLs to extract schema.org JobPosting data automatically.

What format are job postings evaluation reports saved in after automated scanning?

Evaluation reports are saved as dated Markdown files in the reports directory, formatted as YYYY-MM-DD-evaluation.md. This report contains the full pass/fail narrative and scoring rationale for all scanned postings.

What's the best way to monitor multiple company portals for open job listings?

Monitoring multiple company portals is best handled by automating end-to-end discovery across configured ATS APIs, enriching missing descriptions via Playwright fallback, and scoring all postings in a single run.