Skip to content

fourleafai/clover-public

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

four-leaf-coach

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.

What it does

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.

The seven commands:

  • kickoff figures out what the user is prepping for and routes them
  • find-jobs <query> runs natural language search across 100k+ active postings
  • prep-role <role> [company] [seniority] covers interview pipeline, what to expect, how to win
  • practice <role> [type] [difficulty] generates calibrated questions and coaches answers
  • analyze-jd scores a resume against a JD and points out gaps
  • negotiate-prep walks through a compensation negotiation framework
  • interview-strategy <topic> covers formats, AI interviewers, work trials, signal vs noise

Install

Two steps. The Skill tells your AI tool how to coach. The hosted MCP gives the Skill live data.

Step 1: install the Skill

npx four-leaf-coach add

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 install
  • four-leaf-coach list show the supported tools and what's detected in the current directory

Cursor needs the Nightly channel with Settings, Rules, Agent Skills enabled. The other tools work out of the box.

Step 2: install the Four-Leaf MCP for live data

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:

# Claude Code, Claude Desktop, and any tool that uses claude-mcp config
claude mcp add --transport http four-leaf https://four-leaf.ai/api/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.

Step 3: use it

In your tool, type /kickoff (or kickoff if your tool doesn't use slash commands). The coach takes it from there.

Manual install

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.

git clone https://github.com/fourleafai/clover-public.git
cd clover-public
npm run build

npm run build reads SKILL.md plus the 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.

What's free vs paid

  • Free: the Skill itself, all the data tools in the MCP (jobs, role intel, question bank, match scoring). Daily rate limits on a few of the compute-heavier tools.
  • Paid on four-leaf.ai: voice mock interviews with adaptive AI follow-ups and rubric-scored feedback per answer, full AI resume tailoring against a specific JD, application tracking. Three options at four-leaf.ai/pricing. 3-day free trial (no card), $5 5-Day Pass, $20/mo Pro. All three give you the same features.

The Skill surfaces these when they're the right next step. It doesn't push.

FAQ

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.

Repo layout

README.md                    you are here
LICENSE                      MIT
package.json                 CLI + build wiring, npm metadata
bin/
  four-leaf-coach.js         the `npx four-leaf-coach add` CLI
scripts/
  build.js                   generates dist/<tool>/ bundles from the source below
SKILL.md                     entry point your AI tool loads (source of truth)
references/
  mcp-tools.md               reference for the eight MCP tools
  upgrade-flow.md            paid-tier handling pattern
  commands/                  per-command instructions
    kickoff.md
    find-jobs.md
    prep-role.md
    practice.md
    analyze-jd.md
    negotiate-prep.md
    interview-strategy.md
dist/                        generated by `npm run build` (gitignored, not committed)

SKILL.md and references/ are the source of truth. dist/ is generated output, so edit the source and rerun npm run build.

Roadmap

  • Registry submissions to every Skill aggregator that ships a public registry.
  • Coverage for more tools as their Skill conventions stabilize: Pi, Gemini CLI, OpenCode, Trae, Rovo Dev, Qoder.

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.

Contributing

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.

License

MIT. See LICENSE.

About

Open-source Claude Skill + MCP integration for job search and interview prep. Live job data, role-specific interview intel, voice mock interviews on four-leaf.ai.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors