SKILL.md

career-ops-plugin-gmail

Agent skill fromcareer-ops-hq/career-ops

How to pull job leads from a Gmail label into the career-ops pipeline.

install career-ops-plugin-gmail

# install the career-ops pack with the skills CLI

npx skills add career-ops-hq/career-ops

# or add only this skill to Claude Code: copy the folder

plugins/gmail/

# into

~/.claude/skills/gmail/ (all projects)

.claude/skills/gmail/ (one project)

plugins/gmail/skill.md

MITFull file

1# gmail plugin
2 
3Reads a Gmail label, extracts clean job URLs from authentic (DMARC-passing)
4emails, and returns them as leads. The engine writes them to the pipeline.
5 
6## Command
7 
8- `node plugins.mjs run gmail` — ingest new leads from the configured label.
9 
10## Setup
11 
12Put `GMAIL_CLIENT_ID` + `GMAIL_CLIENT_SECRET` + `GMAIL_REFRESH_TOKEN` in `.env`
13(an OAuth Desktop client + a refresh token from the consent flow). Configure the
14label + lookback in `config/plugins.yml`:
15 
16```yaml
17plugins:
18  gmail: { enabled: true, label: "Job Leads", days_back: 7 }
19```
20 
21## Data it produces
22 
23`Job[]` ({ title, url, company, location }) — the engine de-dups against the
24pipeline and appends new ones. It maintains its own processed-message cursor in
25`data/gmail-state.json`, under your data root, to avoid re-reading the same
26emails.

Excerpt shown under the repository's MIT license.

How to install career-ops-plugin-gmail

plugins/gmail/skill.md

More skills in career-ops

Newsletter

Join the Community