career-compass-mcp 2.15.0 → 2.15.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/PRIVACY.md +2 -2
- package/README.md +36 -31
- package/package.json +1 -1
package/PRIVACY.md
CHANGED
|
@@ -40,8 +40,8 @@ Career Compass reads and writes the career information *you* give it:
|
|
|
40
40
|
|
|
41
41
|
## Where it is stored
|
|
42
42
|
|
|
43
|
-
In a single directory on your machine
|
|
44
|
-
|
|
43
|
+
In a single directory on your machine: `~/.career-compass/` by default, or the folder named by the
|
|
44
|
+
`CAREER_DATA_PATH` environment variable when it is set. Files are ordinary YAML you can open, edit, back up,
|
|
45
45
|
or delete with any text editor. While a write is in progress the folder also briefly holds a
|
|
46
46
|
`.write-claim` file naming the process doing the writing, so a second Career Compass process
|
|
47
47
|
(a dashboard, or a server registered in two clients) refuses rather than overwriting it. It is
|
package/README.md
CHANGED
|
@@ -5,12 +5,6 @@
|
|
|
5
5
|
</picture>
|
|
6
6
|
</h1>
|
|
7
7
|
|
|
8
|
-
[](https://www.npmjs.com/package/career-compass-mcp)
|
|
9
|
-
[](https://www.npmjs.com/package/career-compass-mcp)
|
|
10
|
-
[](LICENSE)
|
|
11
|
-
[](https://nodejs.org)
|
|
12
|
-
[](https://modelcontextprotocol.io)
|
|
13
|
-
|
|
14
8
|
**Paste a job posting. Get an honest fit verdict.**
|
|
15
9
|
|
|
16
10
|
Paste a job posting and your resume, and ask "Do I fit this?" You get a straight verdict
|
|
@@ -20,6 +14,16 @@ tailor your résumé, write the cover letter and prep the interview without padd
|
|
|
20
14
|
history. Free, MIT-licensed, and in Claude Code and Cowork your files stay on your own
|
|
21
15
|
computer.
|
|
22
16
|
|
|
17
|
+
## Get it in the Claude directory
|
|
18
|
+
|
|
19
|
+
In the Claude app or on claude.ai, open **Customize → Plugins**, search for
|
|
20
|
+
**Career Compass**, and add it. That's the whole install.
|
|
21
|
+
|
|
22
|
+
| Where you use Claude | What you get |
|
|
23
|
+
|---|---|
|
|
24
|
+
| **claude.ai chat** (web, desktop, mobile) | The skills only. Paste a résumé and a posting and Claude does the fit check, tailoring, interview prep or offer review in the conversation. A short Career Compass card carries your roles and dates into your next chat (keep it in a "Job search" Project and every chat there starts from it), and Claude can put your next follow-up on your calendar. |
|
|
25
|
+
| **Cowork** and **Claude Code** on your computer | The skills plus the local server: your career history and every application are kept as plain YAML on your computer, so later answers start from them. Needs **Node.js 22 or newer**. |
|
|
26
|
+
|
|
23
27
|
## Try it now
|
|
24
28
|
|
|
25
29
|
Just installed it and not sure what to type? Open a new chat and send whichever of these
|
|
@@ -47,17 +51,7 @@ Show me a sample Career Compass fit check.
|
|
|
47
51
|
|
|
48
52
|
## What a fit check looks like
|
|
49
53
|
|
|
50
|
-
|
|
51
|
-
<img src="https://raw.githubusercontent.com/benskamps/career-compass-mcp/main/docs/assets/demo/demo.gif" width="100%" alt="A chat: the user pastes a Director of Operations posting and asks Do I fit this. Career Compass's explore_opportunity tool returns the sample candidate's evidence and preference contract, and Claude replies: Strong fit, pay inside the band, the first three must-haves matched to evidence, and two gaps, risk ops and payments regulation. Verdict: pursue it.">
|
|
52
|
-
</p>
|
|
53
|
-
|
|
54
|
-
*A real run:* the `explore_opportunity` output on the bundled sample data,
|
|
55
|
-
and Claude's reply to it, trimmed for length (every cut is shown as "…"). Also as an
|
|
56
|
-
[MP4](docs/assets/demo/demo.mp4); how it was made is in
|
|
57
|
-
[docs/assets/demo/source](docs/assets/demo/source/README.md).
|
|
58
|
-
|
|
59
|
-
Another example in text, on the same fictional Alex Rivera who ships with the package and a
|
|
60
|
-
different made-up posting:
|
|
54
|
+
On the fictional Alex Rivera who ships with the package, and a made-up posting:
|
|
61
55
|
|
|
62
56
|
```
|
|
63
57
|
You: [pastes a VP of Operations posting from a payments company]
|
|
@@ -88,6 +82,19 @@ Claude: Stretch: strong on operations at scale, but no P&L or payments
|
|
|
88
82
|
The real reply goes on with talking points, red flags and questions to ask. A "day in the
|
|
89
83
|
life" of the role comes only when you ask for one.
|
|
90
84
|
|
|
85
|
+
The same thing as a recording, in claude.ai chat with nothing installed but the skills,
|
|
86
|
+
against a different made-up posting:
|
|
87
|
+
|
|
88
|
+
<p align="center">
|
|
89
|
+
<img src="https://raw.githubusercontent.com/benskamps/career-compass-mcp/main/docs/assets/demo/demo.gif" width="100%" alt="A chat: the user pastes a sample résumé and a Director of Operations posting and asks Do I fit this. The Career Compass skill loads, and Claude replies: Verdict: strong fit. It clears the knockouts, marks all four must-haves as met with quoted résumé lines, names two gaps, payments and risk ops, and level and scope, flags a skills-list number that doesn't match the résumé dates, and asks whether the user knows anyone at the company for a referral.">
|
|
90
|
+
</p>
|
|
91
|
+
|
|
92
|
+
*A real run (recorded on the previous patch release, with the same skills):* the posting, a sample résumé (fictional Alex Rivera) and Claude's
|
|
93
|
+
reply with only the Career Compass skills loaded and no MCP tools, the way claude.ai chat
|
|
94
|
+
runs it. The reply is trimmed for length, and every cut is shown as "…". Also as an
|
|
95
|
+
[MP4](docs/assets/demo/demo.mp4); how it was made is in
|
|
96
|
+
[docs/assets/demo/source](docs/assets/demo/source/README.md).
|
|
97
|
+
|
|
91
98
|
## It won't pad your résumé
|
|
92
99
|
|
|
93
100
|
Every sentence it writes about you has to come from your history or from what you told it.
|
|
@@ -102,17 +109,9 @@ When a stronger draft needs a fact it doesn't have, the draft says so in place:
|
|
|
102
109
|
The sample record says what changed, not how many people did it, so the bullet asks. You
|
|
103
110
|
fill in the bracket or cut it; nothing gets invented to sound stronger.
|
|
104
111
|
|
|
105
|
-
##
|
|
106
|
-
|
|
107
|
-
In the Claude app or on claude.ai, open **Customize → Plugins**, search for
|
|
108
|
-
**Career Compass**, and add it. That's the whole install.
|
|
109
|
-
|
|
110
|
-
| Where you use Claude | What you get |
|
|
111
|
-
|---|---|
|
|
112
|
-
| **claude.ai chat** (web, desktop, mobile) | The skills only. Paste a résumé and a posting and Claude does the fit check, tailoring, interview prep or offer review in the conversation. A short Career Compass card carries your roles and dates into your next chat (keep it in a "Job search" Project and every chat there starts from it), and Claude can put your next follow-up on your calendar. |
|
|
113
|
-
| **Cowork** and **Claude Code** on your computer | The skills plus the local server: your career history and every application are kept as plain YAML on your computer, so later answers start from them. Needs **Node.js 22 or newer**. |
|
|
112
|
+
## Commands, and what it does over time
|
|
114
113
|
|
|
115
|
-
|
|
114
|
+
These commands work in Claude Code and Cowork. In claude.ai chat, just ask in plain
|
|
116
115
|
words ("prep me for my interview on Friday").
|
|
117
116
|
|
|
118
117
|
| Command | What it does |
|
|
@@ -182,6 +181,12 @@ with pages for [people who were laid off](https://benskamps.github.io/career-com
|
|
|
182
181
|
|
|
183
182
|
## For other MCP clients
|
|
184
183
|
|
|
184
|
+
[](https://www.npmjs.com/package/career-compass-mcp)
|
|
185
|
+
[](https://www.npmjs.com/package/career-compass-mcp)
|
|
186
|
+
[](LICENSE)
|
|
187
|
+
[](https://nodejs.org)
|
|
188
|
+
[](https://modelcontextprotocol.io)
|
|
189
|
+
|
|
185
190
|
Everything below is for running the server yourself, outside the Claude directory: Claude
|
|
186
191
|
Desktop, Cursor, other MCP clients, or Claude Code without the plugin. If you installed the
|
|
187
192
|
plugin, skip it. Running the command below as well would register a second copy of every
|
|
@@ -266,7 +271,7 @@ Add the server:
|
|
|
266
271
|
}
|
|
267
272
|
```
|
|
268
273
|
|
|
269
|
-
Pin a version in `args` (`"career-compass-mcp@2.15.
|
|
274
|
+
Pin a version in `args` (`"career-compass-mcp@2.15.2"` rather than the bare name) if you can:
|
|
270
275
|
Desktop starts the server twice at once, and an unpinned name reinstalls on every release,
|
|
271
276
|
which can leave npx's cache half-written (see **On npx** below). `install` does this for you.
|
|
272
277
|
|
|
@@ -608,9 +613,9 @@ Alex Rivera) if you want to see the shape before writing your own.
|
|
|
608
613
|
|---------|---------|-------------|
|
|
609
614
|
| `CAREER_DATA_PATH` | `~/.career-compass` | Directory holding your career and pipeline YAML |
|
|
610
615
|
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
616
|
+
The directory plugin has no folder setting since 2.15.2 (the directory's scan flagged it), so it
|
|
617
|
+
uses `~/.career-compass` unless `CAREER_DATA_PATH` is set in the environment Claude starts the
|
|
618
|
+
server from.
|
|
614
619
|
|
|
615
620
|
---
|
|
616
621
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "career-compass-mcp",
|
|
3
3
|
"mcpName": "io.github.benskamps/career-compass-mcp",
|
|
4
|
-
"version": "2.15.
|
|
4
|
+
"version": "2.15.2",
|
|
5
5
|
"description": "AI-native career co-pilot for Claude — Career KB, resume tailoring, job pipeline, interview prep, and offer evaluation via MCP",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"main": "build/src/index.js",
|