# composite-scorer

The composite-scorer skill for Claude Code and Codex combines resume, LinkedIn, GitHub, and portfolio scores. Run it after steps 1–4 or to get an overall score and identify which surface has the most room to improve.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 73 repo stars
- Author: Jerome Hardaway, Vets Who Code
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Vets-Who-Code/ai-era-job-kit/tree/HEAD/skills/composite-scorer/SKILL.md
- Updated: 2026-11-11
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/composite-scorer

## What it does

The skill combines resume, LinkedIn, GitHub, and portfolio scores into a total, a machine-read score, and a human-read score. It also checks the resume threshold and reports remaining points for each surface alongside the sync result. It needs Python 3, the four score files (`resume-score.json`, `linkedin-score.json`, `github-score.json`, and `portfolio-score.json`), plus `sync.md`.

The `scorecard.py` script writes `composite.json` and `composite.md`; scores for individual job postings can be supplied with `--screen`. The default resume threshold is 70. A lower text score or a failed parse check flags the resume regardless of either total. Vets Who Code describes the weights and threshold as its own design judgment, not research or an employer policy. If a surface has not been scored, the report marks the totals as partial.

## Requirements
- Works with: GitHub, LinkedIn

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add Vets-Who-Code/ai-era-job-kit
```
In the agent chat (not a shell):
```text
/plugin install ai-era-job-kit@ai-era-job-kit
```
This installs the whole ai-era-job-kit plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add Vets-Who-Code/ai-era-job-kit --skill composite-scorer -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/composite-scorer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/composite-scorer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Vets-Who-Code/ai-era-job-kit --skill composite-scorer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/composite-scorer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Vets-Who-Code/ai-era-job-kit --skill composite-scorer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/composite-scorer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Vets-Who-Code/ai-era-job-kit skills/composite-scorer
```

2. **Manually: put the files in place**
- File: `.github/skills/composite-scorer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Vets-Who-Code/ai-era-job-kit --skill composite-scorer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Vets-Who-Code/ai-era-job-kit --path skills/composite-scorer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/composite-scorer/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Vets-Who-Code/ai-era-job-kit/tree/HEAD/skills/composite-scorer/SKILL.md

## When to use it
- combine resume, LinkedIn, GitHub, and portfolio scores into one total
- compare machine screening and human assessments of a profile
- flag a resume below the configured threshold
- identify the surface with the most points left

## Example prompts
- Combine my resume, LinkedIn, GitHub, and portfolio scores into one scorecard.
- Show the machine and human scores for my profile.
- Check the resume gate and tell me which surface has the most points left.

## Similar
- [parasite-seo](https://affpapa.org/en/nevibecode/skills/parasite-seo.md) — skill · 2100 installs
- [context-mode-ops](https://affpapa.org/en/nevibecode/skills/context-mode-ops.md) — skill · 1700 installs
- [page-play-builder](https://affpapa.org/en/nevibecode/skills/page-play-builder.md) — skill · 1400 installs
- [agent-reach](https://affpapa.org/en/nevibecode/skills/agent-reach.md) — skill · 788 installs
- [Social Profile Lookup — Twitter, GitHub, LinkedIn](https://affpapa.org/en/nevibecode/mcp/social-profile-lookup-twitter-github-linkedin.md) — MCP server · 6933 installs
- [fit-scorer](https://affpapa.org/en/nevibecode/skills/fit-scorer.md) — skill · 1100 installs

From the same set: [vets-who-code/ai-era-job-kit](https://affpapa.org/en/nevibecode/by/vets-who-code/ai-era-job-kit.md) — 18 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
