Skip to main content
skill CX Codex

portfolio-scorer — Claude Code skill for portfolio reviews

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.

no license ★ 73 updated 2026-11-11

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Vets-Who-Code/ai-era-job-kit
/plugin install ai-era-job-kit@ai-era-job-kit
Open on GitHub

What portfolio-scorer 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.

What it helps with

  • 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 for the agent

  • 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.

How to install portfolio-scorer

1Plugin marketplace

/plugin marketplace add Vets-Who-Code/ai-era-job-kit
/plugin install ai-era-job-kit@ai-era-job-kit

This installs the whole ai-era-job-kit plugin with all its skills

2Skills CLI (Vercel)

npx skills add Vets-Who-Code/ai-era-job-kit --skill portfolio-scorer -a claude-code

3Manually: put the files in place

~/.claude/skills/portfolio-scorer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/portfolio-scorer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about portfolio-scorer

How do I install portfolio-scorer in Claude Code?

Add the marketplace with /plugin marketplace add Vets-Who-Code/ai-era-job-kit, then install the skill with /plugin install ai-era-job-kit@ai-era-job-kit.

What does portfolio-scorer do?

It audits a portfolio site, checks it against the Vets Who Code Portfolio Checklist, and reports the score with ranked fixes.

What does portfolio-scorer need to run?

It needs Python 3, a site address, and the repository's portfolio.json. The checklist review also uses a checklist.json file.

Similar skills

All skills for Code review and refactoring →

From the same set18

The whole set →
career-scorecard career-scorecard — a subagent for Claude Code orchestrates a multi-step audit of a job candidate's resume, LinkedIn, GitHub, and portfolio to output an overall rating and an action plan. CX Codex ★ 73repo stars ai-interviewer The ai-interviewer Claude Code subagent runs a practice interview against a revised resume and scores answers against job criteria. It probes specific resume claims, then reviews the transcript. CX Codex ★ 73repo stars ai-era-job-kit ai-era-job-kit — a plugin for Claude Code that audits resumes, LinkedIn profiles, and GitHub activity against an engineer's portfolio. Pulls live O*NET and BLS market data to guide career preparation. ★ 73repo stars improvement-plan The improvement-plan Claude Code skill turns a composite resume and profile score into a ranked list of fixes. It runs after scoring or when asked what to address first. CX Codex +1 ★ 73repo stars 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. CX Codex +1 ★ 73repo stars linkedin-scorer The linkedin-scorer Claude Code skill scores a LinkedIn profile against a resume and portfolio record. The agent uses it to review a profile, draft its headline or About section, or improve recruiter discovery. CX Codex +1 ★ 73repo stars 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. CX Codex +1 ★ 73repo stars resume-rebuilder resume-rebuilder — a Claude Code skill that rebuilds a resume from portfolio evidence and a role’s scoring data. It activates for requests to write, revise, split, or target a resume. CX Codex +1 ★ 73repo stars

Project sponsors

Companies that keep this analytics open