Skip to content

vmarafetti/right-fit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

right-fit

A top-of-funnel job-finding coach for Claude Code. Finds roles that genuinely fit you, ranks them transparently, and saves recurring searches so new matches surface over time.

It does one thing well: shows you the roles worth your time. It hands off to other skills for everything downstream.

Built clean-room. Designed from first principles for the top-of-funnel job-finding domain.


What It Does

Discovery — Finds current job listings that match your candidate brief. Ranks them on a transparent four-dimension rubric (Match / Reach / Edge / Sustain). Tells you what was excluded and why.

Saved radars — Saves a search profile so you can re-run it later. Surfaces only what's new since the last run, so monitoring doesn't become an inbox.

Pulse dashboard — A calm view of what you've found, what's new, what's been excluded. No false urgency, no inbox-checking ritual.

Honest filtering — Roles that don't fit get excluded with reasons. The list you see is the list worth applying to.

Just-in-time onboarding — On the first discover run, the skill captures a lightweight candidate brief through 4-5 quick questions. No 12-question intake form.


What It Does Not Do

This skill is intentionally narrow. It does not:

  • Draft cover letters, screening Q answers, or any application materials
  • Analyze interview transcripts or run mock interviews
  • Coach interview prep or negotiation
  • Optimize your full resume or LinkedIn profile
  • Track responses after you submit an application
  • Maintain a storybank or run practice drills

For any of the above, hand off to a dedicated interview coaching skill.


Commands

Command What it does How to invoke
discover Find roles ranked by fit. Captures candidate brief on first run. right-fit discover or "find me jobs using right-fit"
radar Save a search profile to re-run later (only shows new hits). right-fit radar or "save this search as a radar"
pulse Show the discovery dashboard. right-fit pulse or "show me my right-fit pulse"
help List commands right-fit help

A note on activation: Single-word commands like pulse can be ambiguous in a fresh Claude Code session with no prior context. For reliable activation, prefix the command with right-fit (e.g., right-fit pulse) or use a natural-language phrase that mentions "right-fit" or job search context. Once the skill is active in a session, single-word commands work fine.


Install

Option 1 — Clone (recommended)

git clone https://github.com/vmarafetti/right-fit.git ~/.claude/skills/right-fit

Option 2 — Download zip

Download the latest release, unzip, and move the folder to ~/.claude/skills/right-fit/.

After install

  1. Restart Claude Code (or invoke any skill — Claude Code refreshes the skill list).

  2. In a Claude Code session, say:

    right-fit discover
    

    The skill will ask 4-5 quick questions to set up your candidate brief, then run a search.

    (You can also use natural language like "find me jobs using right-fit" or "use the right-fit skill to find roles" — they all activate the same flow.)

  3. The skill creates a private right-fit-state.md file in the skill directory. Your data lives there. It's gitignored — never accidentally commit it.


State and Privacy

The skill stores your context in right-fit-state.md inside the skill directory.

  • This file contains personal data (target comp, candidate brief, discovered roles)
  • It is excluded from git via .gitignore
  • Never share or commit this file
  • A clean template is provided as right-fit-state.example.md — that's the schema, safe to view or share

How It Pairs With Other Skills

right-fit covers the top of the job-search funnel: finding roles. It explicitly stops there.

When you're ready to act on a role, hand off to a separate coaching skill (or your own workflow) for:

  • Drafting applications — cover notes, screening Q answers, resume tweaks
  • Interview prep — research, mocks, storybank work
  • Rejection processing — capturing lessons, mining patterns, recalibrating

Skills designed for different stages of the job search can run side-by-side. They write to separate state files. They do different jobs.


Origin and Attribution

Built by Victoria Marafetti. Designed from first principles for the top-of-funnel job-finding domain.

Common conventions inherited from the Claude Code skill framework (frontmatter format, SKILL.md structure, command registry pattern) are platform standards.

If you also use other job-search-related Claude Code skills, right-fit is independent. It writes only to its own state file. Credit the authors of any other skills you use alongside this one.


License

MIT — see LICENSE file. Use, modify, distribute, sell. Just keep the copyright notice in copies.

About

Top-of-funnel job-finding skill for Claude Code. Surfaces roles that genuinely fit, with transparent scoring and saved searches.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors