From d1139bc95cd442b48fea651ea465f81a0bbd2478 Mon Sep 17 00:00:00 2001 From: sickn33 Date: Mon, 23 Mar 2026 18:57:24 +0100 Subject: [PATCH] feat(jobgpt): Add skill with maintainer fixes Integrate the JobGPT skill directly on main because the fork does not\nallow maintainer edits and the reviewed content still needed workflow and\nauth guidance fixes before release prep.\n\nRefs #388\nCo-authored-by: Yashveer Rana --- skills/jobgpt/SKILL.md | 100 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 skills/jobgpt/SKILL.md diff --git a/skills/jobgpt/SKILL.md b/skills/jobgpt/SKILL.md new file mode 100644 index 00000000..d5f448d3 --- /dev/null +++ b/skills/jobgpt/SKILL.md @@ -0,0 +1,100 @@ +--- +name: jobgpt +description: "Job search automation, auto apply, resume generation, application tracking, salary intelligence, and recruiter outreach using the JobGPT MCP server." +risk: safe +source: community +date_added: "2026-03-23" +--- + +# JobGPT - Job Search Automation + +## Overview + +JobGPT connects your AI assistant to a complete job search automation platform via the JobGPT MCP server. It provides 34 tools covering job search, auto-apply, resume generation, application tracking, salary intelligence, and recruiter outreach so you can manage your entire job hunt from your AI coding assistant. + +Built by [6figr.com](https://6figr.com/jobgpt-ai), the platform supports 150+ countries with salary data, job matching, and automated applications. + +## When to Use This Skill + +- You want to **search for jobs** with filters like titles, locations, salary, remote, and H1B sponsorship +- You want to **auto-apply** to jobs automatically +- You want to **generate a tailored resume** for a specific job application +- You want to **track your job applications** across multiple job hunts +- You want to **find recruiters or referrers** at target companies and send outreach emails +- You want to **import a job** from LinkedIn, Greenhouse, Lever, Workday, or any job board URL +- You want to **check your salary** and compare compensation across roles + +## Setup + +This skill requires the JobGPT MCP server: + +1. **Create an account** - Sign up at [6figr.com/jobgpt-ai](https://6figr.com/jobgpt-ai) +2. **Get an API key** - Go to [6figr.com/account](https://6figr.com/account), scroll to MCP Integrations, and click Generate API Key. The key starts with `mcp_`. +3. **Add the MCP server:** + - Claude Code: `claude mcp add jobgpt -t http -u https://mcp.6figr.com/mcp --header "Authorization: "` + - Other tools: Add `jobgpt-mcp-server` as an MCP server with env var `JOBGPT_API_KEY` set. Install via `npx jobgpt-mcp-server`. + +Set the `JOBGPT_API_KEY` environment variable when you are running the local `npx jobgpt-mcp-server` path. + +## Examples + +### Find Remote Jobs + +> "Find remote senior React jobs paying over $150k" + +The skill uses `search_jobs` with title, remote, and salary filters to find matching positions, then presents results with company, title, location, salary range, and key skills. + +### Auto-Apply to Jobs + +> "Auto-apply to the top 5 matches from my job hunt" + +The skill checks that your resume is uploaded, uses `match_jobs` to find new matches, saves the selected matches with `add_job_to_applications`, then triggers `apply_to_job` for each resulting application. It monitors progress with `get_application_stats`. + +### Generate a Tailored Resume + +> "Generate a tailored resume for this Google application" + +The skill calls `generate_resume_for_job` to create an AI-optimized resume targeting the specific job's requirements, then provides the download link via `get_generated_resume`. + +### Import and Apply from a URL + +> "Apply to this job for me - https://boards.greenhouse.io/company/jobs/12345" + +The skill uses `import_job_by_url` to import the job from any supported platform (LinkedIn, Greenhouse, Lever, Workday), adds it to applications, and optionally triggers auto-apply. + +### Recruiter Outreach + +> "Find recruiters for this job and draft an outreach email" + +The skill finds recruiters with `get_job_recruiters` and helps craft a personalized message. The draft is presented to the user for review; `send_outreach` is only called after explicit user confirmation. + +### Check Application Stats + +> "Show my application stats for the last 7 days" + +The skill uses `get_application_stats` for an aggregated overview - total counts by status, auto-apply metrics, and pipeline progress. + +## Best Practices + +- **Check credits first** - Auto-apply and resume generation consume credits. Use `get_credits` before batch operations. +- **Complete your profile** - Run `get_profile` first and fill in missing fields with `update_profile` for better job matches. +- **Upload a resume before applying** - Use `list_resumes` to check, and `upload_resume` if needed. +- **Use job hunts for ongoing searches** - Create a job hunt with `create_job_hunt` to save filters and get continuous matches. +- **Use `get_application` for saved jobs** - If a user asks about a job they've already saved, use `get_application` instead of `get_job`. + +## Troubleshooting + +| Problem | Solution | +|---------|----------| +| "Missing Authorization header" | For Claude Code and other remote HTTP MCP setups, confirm the `Authorization` header is configured on the MCP server entry | +| "Missing API key" | For the local `npx jobgpt-mcp-server` setup, ensure `JOBGPT_API_KEY` is set to your API key | +| "Insufficient credits" | Check balance with `get_credits`. Purchase more at 6figr.com/account | +| Auto-apply not working | Ensure a resume is uploaded and the job hunt has auto-apply enabled | +| No job matches found | Broaden your search filters (fewer titles, more locations, wider salary range) | + +## Additional Resources + +- [JobGPT Platform](https://6figr.com/jobgpt-ai) - Sign up and manage your account +- [MCP Server Repo](https://github.com/6figr-com/jobgpt-mcp-server) - Source code and setup guides +- [Skills Repo](https://github.com/6figr-com/skills) - This skill's source +- [npm Package](https://www.npmjs.com/package/jobgpt-mcp-server) - Install via npm