scan-inbox

Classify pending mailbox messages and match them to existing job applications for review.

73|19|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/suxrobGM/jobpilot --skill scan-inbox-suxrobgm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scan-inbox
Source: https://github.com/suxrobGM/jobpilot/tree/main/plugin/skills/scan-inbox
Command: npx skills add https://github.com/suxrobGM/jobpilot --skill scan-inbox-suxrobgm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Job seekers receive a flood of email after applying to roles, and manually sorting recruiter replies, rejections, offers, and noise from job alerts is slow and error-prone. This Skill automates the triage by classifying each unscanned message and linking it to the right application, while leaving final approval to the user. ## Core Features & Use Cases - Email Classification: Categorizes each message as interviewing, rejected, offer, verification, or irrelevant based on subject, sender, and body evidence. - Application Matching: Fuzzy-matches classified messages to existing Application records using company name and sender domain with a confidence score threshold. - Human-in-the-Loop Review: Writes proposals back with a pending review status so the user approves every status move in the /inbox page; only high-confidence rejections can auto-apply. - Use Case: After a week of applications, run the scan to sync Gmail, classify 40 new messages, and see that 3 are interview invites matched to specific applications, ready for one-click approval. ## Quick Start Ask the agent to scan your inbox for new job application replies and classify them for review.

Frequently Asked Questions about scan-inbox

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

FAQPage Schema
How do I classify job application emails automatically?▼

Run the scan with no arguments to sync the mailbox and classify all pending unscanned messages. Each message is labeled as interviewing, rejected, offer, verification, or irrelevant, then matched to an existing application when confidence is high enough.

How does email matching to job applications work?▼

The skill searches existing applications by company name or sender domain, then scores each candidate against the sender name, domain, and subject line. A match is proposed only when the score reaches 0.7 or higher; otherwise the match fields stay null.

Can I rescan a single email message instead of the whole inbox?▼

Yes, pass a message id as the argument to re-scan just that message, even if it was already classified or reviewed. The re-scan overwrites the classification and resets review status but never undoes an approved status change.

Does the scan automatically change my application status?▼

No, all proposals default to pending review status and require your approval in the /inbox page. The only exception is a rejection classified with confidence of 0.95 or higher and a matched application, which the server applies automatically.

Why is my inbox scan returning nothing to classify?▼

The scan exits when the pending unscanned queue is empty, meaning all messages are already reviewed. It also stops early if no email account is connected, so verify the Gmail connection in your profile settings first.