{
  "markdown": "# portfolio-review\n\nA Claude Code skill that conducts comprehensive design portfolio reviews from a hiring manager perspective. Created by Won J. You.\n\n## What it does\n\nWhen triggered, this skill opens with two clarifying questions (goal and scope), then evaluates the portfolio and produces a structured annotated report with severity-coded issues and a prioritized action plan. Reports can be exported as a self-contained HTML file.\n\n## Triggers\n\nThe skill activates when someone:\n\n- Shares a portfolio URL or PDF and asks for feedback, critique, or review\n- Mentions seniority levels (junior, mid, senior, staff, lead, director) alongside a portfolio\n- Says things like \"roast my portfolio\", \"is my portfolio ready for [role]\", or \"what's wrong with my portfolio\"\n\n## Evaluation dimensions\n\n| Dimension | What's assessed |\n|---|---|\n| **Copy & Writing** | Headlines, body copy, typos, grammar, witty/distinctive copy, micro-copy |\n| **Information Architecture** | Work visibility, structure, navigation, responsiveness |\n| **Positioning, Brand & Originality** | Market fit, positioning coherence, specialization, personality, creative distinctiveness |\n| **Skills Demonstrated** | Evidenced vs. claimed competencies |\n| **Case Studies** | Client/context/users/problem space foundations, process proportion, design clarity, rationale, live links/prototypes/demos, image legibility |\n| **Call-to-Actions** | Contact discoverability, resume link, social profiles |\n| **About Me & Essential Info** | Who/what/strengths/impact checklist, narrative, voice |\n| **Visual Design Quality** | Gestalt principles, Dieter Rams principles, typography, color, spacing |\n| **Portfolio Usability** | Scannability, wayfinding, labeling, cognitive load, performance, craft details and delight |\n| **Positioning Coherence** | Whether the portfolio actually supports the target role |\n| **Leadership Signal Evaluation** | Contribution vs. team outcomes, leadership vs. execution, cross-functional influence *(Lead+ only)* |\n\n## Report structure\n\n- **Executive Summary** with overall readiness score (X/10)\n- **Issue Log** — all findings with severity codes (🔴 Critical / 🟡 Major / 🟢 Minor)\n- **Section-by-Section Analysis** — detailed, referenced feedback per dimension\n- **Level Assessment** — does the portfolio read at the target seniority level?\n- **Priority Action Plan** — top 5 fixes in order of impact\n- **What's Working** — genuine strengths to preserve\n- **Hiring Manager Verdict** — candid debrief as if briefing a recruiter\n- **Optional HTML export** — self-contained file with styled layout, color-coded severity, and checklist rendering\n\n## Example use cases\n\n### Full portfolio review before a job search\n\n> \"I'm applying for senior product designer roles at mid-size startups. Here's my portfolio: https://yourname.com — can you do a full review?\"\n\nClaude opens with two clarifying questions, then delivers a scored report across all dimensions with severity-coded issues and a prioritized top-5 fix list.\n\n---\n\n### Readiness check for a specific company tier\n\n> \"Is my portfolio ready for a FAANG-level senior IC role? PDF attached.\"\n\nClaude calibrates the review against Senior/Staff-level expectations — emphasizing systems thinking, measurable outcomes, and cross-functional influence signals — and gives a candid hiring-manager verdict.\n\n---\n\n### Single case study deep dive\n\n> \"I want feedback only on my checkout redesign case study: https://yourname.com/checkout. I'm targeting a lead role.\"\n\nClaude scopes the review to that case study and evaluates problem framing, role clarity, process documentation, decision rationale, and outcome evidence at lead-level bar.\n\n---\n\n### First portfolio out of bootcamp\n\n> \"I just finished a UX bootcamp and built my first portfolio. Roast it: https://yourname.com\"\n\nClaude applies the junior-level rubric, flags the most common entry-level mistakes (assertion-without-evidence, missing context, weak CTAs), and outputs a prioritized action plan.\n\n---\n\n### Freelance / agency positioning\n\n> \"I do brand and web design for agencies. Here's my site: https://yourname.com — does it position me well for B2B agency clients?\"\n\nClaude evaluates positioning coherence, specialization clarity, and whether the work speaks to the right buyer — not just general design quality.\n\n---\n\n### Export report as HTML\n\n> \"Review my portfolio at https://yourname.com and export the report as an HTML file I can share with my mentor.\"\n\nClaude runs the full review and writes a self-contained `.html` file with styled severity badges, a collapsible issue log, and checklist rendering.\n\n---\n\n### Targeted section fix\n\n> \"My About page feels weak. Can you review just that section? https://yourname.com/about\"\n\nClaude evaluates the About page against the who/what/strengths/impact checklist and narrative criteria, without scoring the rest of the portfolio.\n\n---\n\n## Installation\n\n### Manual (local)\n\nThe plugin structure is already in place. To install manually, copy the plugin cache entry and register it:\n\n```bash\n# 1. Copy to plugin cache\nmkdir -p ~/.claude/plugins/cache/portfolio-review-skill/portfolio-review/1.0.0\ncp -r .claude .claude-plugin README.md CLAUDE.md \\\n  ~/.claude/plugins/cache/portfolio-review-skill/portfolio-review/1.0.0/\n\n# 2. Add to ~/.claude/settings.json under \"enabledPlugins\":\n#    \"portfolio-review@portfolio-review-skill\": true\n\n# 3. Add to ~/.claude/plugins/installed_plugins.json under \"plugins\":\n#    \"portfolio-review@portfolio-review-skill\": [{ \"scope\": \"user\", \"installPath\": \"...\", \"version\": \"1.0.0\" }]\n```\n\nThen start a new Claude Code session — the skill will be available immediately.\n\n## Repository structure\n\n```\nportfolio-review/\n├── .claude-plugin/\n│   ├── marketplace.json          # Plugin marketplace manifest\n│   └── plugin.json               # Plugin metadata and skill paths\n├── CLAUDE.md                     # Guidance for Claude Code\n├── README.md                     # This file\n└── SKILL.md                      # Canonical source (kept in sync with .claude/skills/)\n```\n",
  "bytes": 6052,
  "sha": "529caafc20ddf8ed26af1aa2c432a6f619968c31fb4609c1820cda492ab86356",
  "repo_slug": "wonjyou/portfolio-review-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_wonjyou_portfolio_review_skill_portfolio_610a2599/readme"
}