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
/plugin marketplace add Vets-Who-Code/ai-era-job-kit
/plugin install ai-era-job-kit@ai-era-job-kitWhat 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.jsonand 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-kitThis 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-code3Manually: put the files in place
~/.claude/skills/portfolio-scorer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/portfolio-scorer/
1Skills CLI (Vercel)
npx skills add Vets-Who-Code/ai-era-job-kit --skill portfolio-scorer -a codex2Manually: put the files in place
.agents/skills/portfolio-scorer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Vets-Who-Code/ai-era-job-kit --skill portfolio-scorer -a cursor2Manually: put the files in place
.cursor/skills/portfolio-scorer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Vets-Who-Code/ai-era-job-kit skills/portfolio-scorer2Manually: put the files in place
.github/skills/portfolio-scorer/SKILL.md1Skills CLI (Vercel)
npx skills add Vets-Who-Code/ai-era-job-kit --skill portfolio-scorer -a gemini-cli2Platform CLI
gemini skills install https://github.com/Vets-Who-Code/ai-era-job-kit --path skills/portfolio-scorerManually: put the files in place
.devin/skills/portfolio-scorer/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.