# portfolio-scorer

The portfolio-scorer Claude Code skill audits a portfolio site with automated checks and a review checklist. It runs when an agent is asked to assess a personal site or decide whether it is ready to share.

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

## What it does

The skill runs a site audit, then scores the portfolio against the Vets Who Code Portfolio Checklist. Its script reads the homepage and up to five project pages, checks whether entries from `portfolio.json` appear on the site, and loads live links. It also checks page titles and descriptions, HTTPS, mobile support, alt text, and contact details.

The checklist pass goes into `checklist.json`. Each checked item needs a pass or fail mark and a quote from the page; the script rejects entries without a quote. JavaScript-rendered sites can leave some automated checks incomplete, so those items belong in the manual review. The audit needs Python 3, a site, and `portfolio.json` in the repository.

The report includes the automated score, checklist results by section, and five ranked fixes. A separate `sync_check.py` script compares portfolio details with a resume, LinkedIn, and 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 portfolio-scorer -a claude-code
```

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

### Codex

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

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

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

## When to use it
- check whether a portfolio page has a title, description, and HTTPS
- find listed projects missing from the site
- review portfolio pages against a checklist
- rank fixes for a portfolio site

## Example prompts
- Score my portfolio site and list its highest-priority fixes.
- Check whether my personal site is ready to share.
- Compare the project pages with `portfolio.json` and the checklist.

## Similar
- [portfolio-analytics](https://affpapa.org/en/nevibecode/skills/portfolio-analytics.md) — skill · 559 installs
- [ib-portfolio](https://affpapa.org/en/nevibecode/skills/ib-portfolio.md) — skill · 107 installs
- [tracking-crypto-portfolio](https://affpapa.org/en/nevibecode/skills/tracking-crypto-portfolio.md) — skill · 1 install
- [editorial-portfolio-chapters](https://affpapa.org/en/nevibecode/skills/editorial-portfolio-chapters.md) — skill · 1800 installs
- [interactive-portfolio](https://affpapa.org/en/nevibecode/skills/sickn33-interactive-portfolio.md) — skill · 1500 installs
- [developer-portfolio](https://affpapa.org/en/nevibecode/skills/developer-portfolio.md) — skill · 101 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
