# github-scorer

The github-scorer Claude Code skill scores a public GitHub profile and its pinned repositories. It runs on requests to assess a profile, choose pins, or prepare README files.

- 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/github-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/github-scorer

## What it does

The skill runs `github_score.py` and writes the results as JSON and Markdown. It checks profile details, the website, profile README, recent activity, and signals from pinned repositories, including their README files, tests, CI, licenses, and topics. The report contains a score and six priority fixes.

Pass pinned repositories with `--repos`; the GitHub REST API does not return the pin list. Without that option, the script uses the six most recently pushed repositories. Its score follows a VWC rubric, not an official GitHub hiring rating.

The script needs `python3` and access to GitHub. Without a token, the API allows 60 requests per hour per IP, with about 20 per run. After a rate limit, wait an hour or set `GITHUB_TOKEN` with `gh auth token`. If GitHub cannot be reached, the script exits with code 3.

## Requirements
- Works with: GitHub

## 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 github-scorer -a claude-code
```

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

### Codex

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

2. **Manually: put the files in place**
- File: `.agents/skills/github-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 github-scorer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/github-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/github-scorer
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/github-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/github-scorer/SKILL.md

## When to use it
- score a public GitHub profile
- spot gaps in pinned repositories
- choose repositories to pin
- draft fixes for profile and project READMEs

## Example prompts
- Score my public GitHub profile and list the main fixes.
- Review my pinned repositories and suggest which ones to keep.
- Help improve my profile README and repository README for hiring.

## Similar
- [github-profile](https://affpapa.org/en/nevibecode/skills/github-profile.md) — skill · 109 installs
- [github-profile-optimization](https://affpapa.org/en/nevibecode/skills/github-profile-optimization.md) — skill · 13400 installs
- [beautify-github-readme](https://affpapa.org/en/nevibecode/skills/beautify-github-readme.md) — skill · 1300 installs
- [github](https://affpapa.org/en/nevibecode/skills/kostja94-github.md) — skill · 1900 installs
- [create-readme](https://affpapa.org/en/nevibecode/skills/create-readme.md) — skill · 19081 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
