portfolio-presentation
Curate and present creative/technical work for maximum impact. Structure case studies, craft project narratives, optimize for different audiences (hiring managers, clients, collaborators). Supports portfolio websites, PDF decks, and presentation formats. Triggers on portfolio review, case study writing, project showcase, or work presentation requests.
What this skill does
# Portfolio Presentation
Transform scattered work into compelling professional narrative.
## Core Principle
A portfolio isn't a list of projects—it's a story about who you are and what you can do for the person viewing it.
## Audience Analysis
Before curating, identify the viewer:
| Audience | Primary Interest | Time Available | Decision Criteria |
|----------|------------------|----------------|-------------------|
| Hiring Manager | Can you do the job? | 30-90 seconds initial | Relevant skills, growth |
| Technical Lead | How do you think? | 2-5 minutes deep dive | Problem-solving, code quality |
| Client | Can you solve my problem? | 1-2 minutes | Similar work, results |
| Collaborator | Would I enjoy working with you? | Variable | Process, communication |
| Academic | What's your contribution? | Thorough review | Rigor, originality |
## Portfolio Structure
### Homepage/Landing
```
[Hero: Your positioning statement]
[Featured Work: 3-4 best pieces]
[Brief About]
[Contact/CTA]
```
**Positioning Statement Formula**:
```
I'm a [role] who [unique approach/specialty].
I help [audience] achieve [outcome] through [method].
```
### Project Selection
**The 3-5-7 Rule**:
- 3 projects minimum (shows range)
- 5 projects optimal (depth + breadth)
- 7 projects maximum (avoid overwhelm)
**Selection Criteria**:
| Criterion | Weight | Question |
|-----------|--------|----------|
| Relevance | 30% | Does it match target opportunity? |
| Impact | 25% | Can I quantify results? |
| Craft | 20% | Does it showcase my best work? |
| Recency | 15% | Is it current enough? |
| Story | 10% | Is there a compelling narrative? |
### Project Order
1. **Lead with best fit** (not necessarily best work)
2. **Second strongest** (captures attention)
3. **Show range** (different type/scale)
4. **Personal/passion project** (shows personality)
5. **Stretch piece** (aspirational direction)
---
## Case Study Framework
### Quick Format (Portfolio Card)
```markdown
## [Project Name]
**Role**: [Your specific role]
**Timeline**: [Duration]
**Team**: [Size/composition]
[One compelling image]
[2-3 sentence summary: Problem → Solution → Result]
**Key Outcome**: [Single quantified result]
```
### Standard Format (Project Page)
```markdown
# [Project Name]
## Overview
[Elevator pitch: What is it? Who's it for? Why does it matter?]
## The Challenge
[Problem statement with context and stakes]
## My Role
[Specific responsibilities and contributions]
## Process
[Key phases with visuals]
1. Discovery/Research
2. Ideation/Strategy
3. Execution/Implementation
4. Iteration/Refinement
## Solution
[What was built/created with visuals]
## Results
[Quantified outcomes]
- [Metric]: [Before] → [After]
- [Metric]: [Improvement]
## Reflection
[What I learned, what I'd do differently]
```
### Deep Dive Format (Full Case Study)
See `references/case-study-template.md`
---
## Narrative Patterns
### The Transformation Arc
```
Status Quo → Disruption → Struggle → Insight → Resolution → New Normal
```
### The Problem-Solution-Impact
```
[User] was struggling with [problem]
We discovered [insight]
So we built [solution]
Which resulted in [impact]
```
### The Process Story
```
We started by [research/discovery]
Which revealed [key insight]
Leading us to [design decision]
Through [iteration], we arrived at [solution]
```
### The Constraint Story
```
Given [constraints: time/budget/tech]
We had to [creative approach]
Which taught us [lesson]
And delivered [outcome despite constraints]
```
---
## Visual Presentation
### Image Requirements
| Type | Purpose | Specs |
|------|---------|-------|
| Hero | First impression | 16:9 or 4:3, high-res |
| Process | Show thinking | Annotated, clear |
| Detail | Craft quality | Cropped, focused |
| Before/After | Show impact | Side-by-side |
| Context | Real-world use | In-situ photos |
### Screenshot Best Practices
- Show real data (anonymized if needed)
- Browser chrome optional (clean vs. context)
- Highlight key interactions
- Include mobile views if responsive
- Show states: empty, loading, populated, error
### Video/Animation
When to use:
- Complex interactions
- Time-based experiences
- Before/after transformations
- Process documentation
Keep under 60 seconds for portfolio context.
---
## Writing Guidelines
### Headlines
❌ "E-commerce Website Redesign"
✅ "Increasing Conversion 40% Through Checkout Simplification"
### Descriptions
❌ "I designed the UI and implemented the frontend"
✅ "Led design and development of checkout flow that reduced cart abandonment from 68% to 41%"
### Quantification
| Weak | Strong |
|------|--------|
| Improved performance | Reduced load time from 4.2s to 0.8s |
| Increased engagement | Grew DAU 3x over 6 months |
| Better user experience | NPS improved from 32 to 67 |
### Voice
- First person for personal sites ("I designed...")
- First person plural for team work ("We discovered...")
- Active voice always
- Present tense for live work, past for completed
---
## Format-Specific Guidance
### Portfolio Website
See `references/website-structure.md`
### PDF Portfolio
See `references/pdf-portfolio.md`
### Presentation Deck
See `references/deck-structure.md`
---
## Review Checklist
### Content
- [ ] Positioning statement is clear
- [ ] Projects match target audience
- [ ] Each project has quantified results
- [ ] Story arc is compelling
- [ ] Role/contribution is explicit
### Visual
- [ ] Images are high quality
- [ ] Consistent visual style
- [ ] Mobile-friendly (if web)
- [ ] Load time acceptable
### Technical
- [ ] All links work
- [ ] Contact info current
- [ ] SEO basics covered (if web)
- [ ] Analytics installed (if web)
### Polish
- [ ] Proofread for errors
- [ ] Consistent formatting
- [ ] Fresh eyes review
---
---
## Related Skills
### Complementary Skills (Use Together)
- **[cv-resume-builder](../cv-resume-builder/)** - Build a resume to accompany your portfolio
- **[interview-preparation](../interview-preparation/)** - Prepare to discuss portfolio projects in interviews
- **[brand-guidelines](../brand-guidelines/)** - Create consistent visual identity across portfolio
### Alternative Skills (Similar Purpose)
- None - this is the primary portfolio presentation skill
### Prerequisite Skills (Learn First)
- None required - this is a standalone professional skill
---
## References
- `references/case-study-template.md` - Full case study format
- `references/website-structure.md` - Portfolio website architecture
- `references/pdf-portfolio.md` - PDF portfolio best practices
- `references/deck-structure.md` - Presentation deck format
Related in Writing & Docs
jax-development
IncludedUse this skill when the user is writing, debugging, profiling, refactoring, reviewing, benchmarking, parallelising, exporting, or explaining JAX code, or when they mention JAX, jax.numpy, jit, grad, value_and_grad, vmap, scan, lax, random keys, pytrees, jax.Array, sharding, Mesh, PartitionSpec, NamedSharding, pmap, shard_map, Pallas, XLA, StableHLO, checkify, profiler, or the JAX repo. It helps turn NumPy or PyTorch-style code into pure functional JAX, fix tracer/control-flow/shape/PRNG bugs, remove recompiles and host-device syncs, choose transforms and sharding strategies, inspect jaxpr/lowering/IR, and benchmark compiled code correctly.
nature-article-writer
IncludedDrafts, rewrites, diagnostically critiques, and style-calibrates primary research manuscripts for Nature and Nature Portfolio journals. Use when the user wants a Nature-style title, summary paragraph or abstract, introduction, results, discussion, methods, figure legends, presubmission enquiry, cover letter, reviewer response, or when a scientific draft sounds generic, jargon-heavy, structurally weak, or AI-ish and needs precise, broad-reader-friendly prose without inventing data, analyses, or references. Best for primary research articles and letters rather than reviews or press releases unless explicitly adapting one.
deckrd
IncludedDocument-driven framework that derives requirements, specifications, implementation plans, and executable tasks from goals through structured AI dialogue. Use when user says "write requirements", "create spec", "plan implementation", "derive tasks", "structure this feature", "break down into tasks", or "document this module". Also use for reverse engineering existing code into docs (/deckrd rev). Do NOT use for direct code writing — use /deckrd-coder after tasks are generated. Do NOT use when the user only wants to run or fix existing code without planning.
clinical-decision-support
IncludedGenerate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug development, clinical research, and evidence synthesis.
handling-sf-data
IncludedSalesforce data operations with 130-point scoring. Use this skill to create, update, delete, bulk import/export, generate test data, and clean up org records using sf CLI and anonymous Apex. TRIGGER when: user creates test data, performs bulk import/export, uses sf data CLI commands, needs data factory patterns for Apex tests, or needs to seed/clean records in a Salesforce org. DO NOT TRIGGER when: SOQL query writing only (use querying-soql), Apex test execution (use running-apex-tests), or metadata deployment (use deploying-metadata).
accelint-ac-to-playwright
IncludedConvert and validate acceptance criteria for Playwright test automation. Use when user asks to (1) review/evaluate/check if AC are ready for automation, (2) assess if AC can be converted as-is, (3) validate AC quality for Playwright, (4) turn AC into tests, (5) generate tests from acceptance criteria, (6) convert .md bullets or .feature Gherkin files to Playwright specs, (7) create test automation from requirements. Handles both bullet-style markdown and Gherkin syntax with JSON test plan generation and validation.