The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Clover Public listing page.
An open-source Skill that turns Claude (or ChatGPT, Cursor, Codex, GitHub Copilot) into a job search and interview prep coach. It pulls real job postings, role-specific interview intelligence, and resume scoring from the hosted Four-Leaf MCP, then walks the user through preparing for an actual interview.
Free to install and use. Voice mock interviews with rubric-scored feedback and full AI resume tailoring live on four-leaf.ai; the Skill surfaces those as an upgrade path when they're the right next step.
Walks a user through prep for a specific role at a specific company. The Skill greets, asks what they're prepping for, and routes them into one of seven guided workflows. Every workflow pulls live data from the Four-Leaf MCP (jobs, role intel, question bank, match scoring) and adds the Skill's coaching on top.
You don't type these as commands. Say what you want in plain language and the coach routes to the right workflow:
Two steps. The Skill tells your AI tool how to coach. The hosted MCP gives the Skill live data.
That's it. The CLI detects your tool (Claude Code, Cursor, Codex, or GitHub Copilot), asks for scope when it matters, and copies the right bundle into the right place. Useful flags:
--tool <name> pick the tool yourself: claude-code, cursor, codex, or github-copilot--scope <project|global> Claude Code only; where to install--dry-run show what it would do without writing anything--yes skip confirmation prompts, --force overwrite an existing installfour-leaf-coach list show the supported tools and what's detected in the current directoryCursor needs the Nightly channel with Settings, Rules, Agent Skills enabled. The other tools work out of the box.
The Skill works in degraded mode (coaching only, no live job data) without the MCP. To get real job search, role intel, and resume scoring, install the hosted MCP:
The first tool call opens the browser for OAuth. A free Four-Leaf account works (3-day trial included, no credit card).
For Cursor, ChatGPT Desktop, and other MCP-aware tools, configure the same URL (https://four-leaf.ai/api/mcp) per that tool's MCP setup docs.
Once it's installed, just tell the coach what you need in plain language. Say something like "help me prep for a senior software engineer interview at Google" and it takes it from there. There are no subcommands to memorize; the coach routes based on what you ask. (In Claude Code you can also invoke it explicitly with /four-leaf-coach.)
If you'd rather not run npx (air-gapped network, or you just want to see what lands where), clone and build the bundles yourself. This is exactly what npx four-leaf-coach add --tool <name> automates.
npm run build reads skills/four-leaf-coach/SKILL.md plus the adjacent references/ tree and writes a dist/<tool>/ directory for each supported tool. Then copy your tool's bundle into place:
| Tool | Build output | Copy into place |
|---|---|---|
| Claude Code (global, all projects) | dist/claude-code/ | cp -r dist/claude-code/.claude ~/ |
| Claude Code (single project) | dist/claude-code/ | cp -r dist/claude-code/.claude PROJECT/ (replace PROJECT with your project path) |
| Cursor (Nightly + Agent Skills enabled) | dist/cursor/ | cp -r dist/cursor/.cursor PROJECT/ |
| OpenAI Codex CLI | dist/codex/ | cp -r dist/codex/AGENTS.md dist/codex/references PROJECT/, then run Codex from PROJECT |
| GitHub Copilot | dist/github/ | cp -r dist/github/.github PROJECT/ (flattened single-file variant) |
The GitHub Copilot bundle is a single flattened file (.github/copilot-instructions.md) because Copilot reads one instructions file and doesn't follow references. The build inlines the whole Skill for it. The other three tools follow file references, so they get the source tree as-is.
The Skill surfaces these when they're the right next step. It doesn't push.
What is four-leaf-coach? An open-source Skill that turns Claude, Cursor, OpenAI Codex, or GitHub Copilot into a job-search and interview-prep coach. The Skill is a structured set of instructions plus reference files that your AI tool loads. It works with the hosted Four-Leaf MCP server for live data (real job postings, role-specific interview intelligence, resume scoring).
How is this different from just prompting Claude for interview prep?
Generic prompts produce generic advice. four-leaf-coach calls real tools: search_jobs returns actual apply URLs from 100k+ active postings; match_score runs a real scoring algorithm against your resume; generate_practice_questions produces role-calibrated questions; get_interview_questions pulls from a curated question bank. The Skill orchestrates the calls and coaches around them.
Do I need a Four-Leaf account? For the data tools (jobs, role intel, question bank, match scoring) a free Four-Leaf account works. The 3-day trial requires no credit card. Voice mock interviews with rubric-scored feedback per answer and full AI resume tailoring are paid features on four-leaf.ai. The Skill surfaces those as an upgrade path when relevant.
Does the MCP work with ChatGPT? Yes. The MCP is HTTP-based with OAuth, so any MCP-aware client connects: Claude Desktop, Claude Code, Cursor, ChatGPT Desktop (Plus + Dev mode), Cline, Continue, Windsurf. The Skill itself is a Claude / Cursor / Codex / Copilot primitive; ChatGPT doesn't yet have a comparable file-based Skill convention, but the underlying MCP tools work there.
Can I use the Skill without the MCP? Yes, in degraded mode. Without the MCP, the Skill still coaches with structured workflows for prep, practice, JD analysis, and negotiation, just without live job listings or real resume scoring. Install the MCP to unlock the live data path.
Is the question bank really open? The Skill, the per-tool dist pipeline, and the install CLI are MIT-licensed in this repo. The question bank itself lives behind the MCP today; the open-data play is on the roadmap.
What about Pi, Gemini CLI, OpenCode, Trae, Rovo Dev, Qoder? On the roadmap. The dist pipeline can target any AI tool with a documented Skill or instructions-file convention. PRs welcome.
skills/four-leaf-coach/ is the source of truth. dist/ is generated output, so edit the source and rerun npm run build.
Done so far: per-tool dist/ bundles generated from a single source (npm run build), a flattened single-file variant for GitHub Copilot, and the npx four-leaf-coach add one-command installer.
PRs welcome that improve a command's coaching, add a new command, or fix a voice issue. Anything that drifts the Skill's positioning away from "coach, not cheat tool" will be declined.
MIT. See LICENSE.