Communitygithub.com

portfolio-maker

Builds a production personal portfolio for engineers, designers, editors, researchers, or consultants, as a React app or a single HTML file.

What is portfolio-maker?

portfolio-maker is a Cursor agent skill that builds a production personal portfolio for engineers, designers, editors, researchers, or consultants, as a React app or a single HTML file.

Works with~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/NaitikGrover/portfolio-maker/tree/HEAD

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Portfolio Maker: Sovereign Design & Engineering Skill

Sovereign & Self-Contained: This skill operates with complete autonomy. It does not depend on, delegate to, or require any external third-party design or animation skills. All aesthetic intuition, typographic mathematics, spatial harmony, micro-interaction dynamics, anti-slop enforcement, and component primitives are natively built into this skill.


🎯 Primary Purpose & Mission

To eliminate amateurish, generic "AI slop" portfolios and autonomously produce award-winning, production-grade portfolios for any professional across 5 core archetypes:

  1. Software Engineers & Systems Architects (Distributed systems, high-throughput APIs, clean technical bento)
  2. Video Editors, Motion Graphics & Creators (Viral showreels, before/after color grade comparisons, view-count metrics)
  3. Product Designers & UI/UX Leads (Design systems, case studies, high-contrast Swiss typography, token breakdowns)
  4. AI/ML Researchers & Data Engineers (Model architectures, arXiv publications, benchmark telemetry, weights badges)
  5. Agencies, Consultants & Solopreneurs (Social proof, client reviews, service tiers, frictionless booking conversion)

🚫 The Anti-AI-Slop Code of Honor (STRICT ENFORCEMENT)

Every portfolio generated MUST pass this rigorous aesthetic filter before outputting code:

1. Banned Visual Slop:

  • ❌ NEVER use the cliché purple/violet neon gradient trope: No from-purple-500 via-indigo-500 to-pink-500 headline text. No blurry purple background glow orbs (bg-purple-500/10 blur-3xl).
  • ❌ No flat, boring gray box grids: Avoid default Tailwind bg-gray-100 / border-gray-300 blocks with zero depth or texture.
  • ❌ No over-saturated laser borders: Avoid high-intensity synthwave neon strokes.

2. Approved Elite Color Palettes:

  • Titanium Monochrome (Swiss Dark/Light): Deep obsidian canvas (#09090b), raised card layer (#121215 with backdrop-blur-md), hairline borders (border-white/[0.08]), crisp white headings (#ffffff), zinc muted text (#a1a1aa), subtle slate/white spotlights (rgba(255,255,255,0.06)).
  • Precision Emerald & Slate: Obsidian canvas (#09090b), emerald live status indicator (#10b981), monochrome cards with subtle mint hover accents.
  • International Electric Cobalt: Deep charcoal canvas (#0a0a0f), crisp white typography, high-contrast electric royal blue (#2563eb) interaction targets and buttons.
  • Warm Architectural Sand & Espresso: Warm cream canvas (#fafaf9), rich espresso headings (#18181b), subtle champagne/amber (#d97706) accents.
  • Cinematic Rose & Amber: Obsidian #0b0c10 canvas, high-impact rose (#e11d48) and warm amber (#f59e0b) accents for creative and video showreels.

3. Banned AI Fluff Copy:

  • ❌ Banned: "Passionate developer transforming ideas into elegant digital solutions."
  • ❌ Banned: "Innovating at the intersection of design, technology, and empathy."
  • ❌ Banned: "Results-oriented professional with a knack for problem-solving."
  • ✅ Required: Concrete, metric-driven, impact-focused statements:
    • "Built distributed Go microservices handling 120k req/s at 14ms p99 latency."
    • "Edited viral long-form YouTube documentaries generating 75M+ organic views."
    • "Spearheaded multi-brand Figma design token system adopted across 42 engineering squads."

🧠 The Native Aesthetic Engine (Built-In Design Intelligence)

The AI must apply these mathematical design laws to every element:

1. Typographic Hierarchy & Optical Rhythm

  • Display Headlines (text-4xl to text-6xl md:text-7xl):
    • Line-height must be tight (leading-[1.08] to leading-[1.12]). Loose leading on large fonts looks amateur.
    • Letter-spacing must be compressed (tracking-tight or tracking-tighter).
    • Font weights: Bold or Extrabold (font-bold / font-extrabold) for technical; Medium or Semibold (font-medium / font-semibold) for editorial serif.
  • Body Copy (text-base to text-lg):
    • Line-height must be generous (leading-relaxed or leading-7) to ensure readability.
    • Line length (Measure): Cap body text width using max-w-xl or max-w-2xl (45–75 characters per line). Never let paragraphs stretch across the full screen width.
    • Text Alignment: Never center-align more than 3 consecutive lines of body text. Left-align for human reading ergonomics.
  • Curated Font Pairings:
    • Modern Tech: Inter or Geist Sans + JetBrains Mono for tags and code.
    • High-Impact Creative: Plus Jakarta Sans or Syne + Inter.
    • Editorial & Luxury: Cormorant Garamond (serif display) + Inter (sans body).

2. Spatial Rhythm & The 8pt Mathematical Grid

  • Section Padding: Generous vertical breathing space (py-20 md:py-28). Tight sections suffocate the design.
  • Layout Stack: Vertical spacing between major sections must use space-y-24 or space-y-28.
  • Card Grids: Standardize on gap-6 or gap-8.
  • Content Width Containers:
    • Editorial / Minimalist: max-w-4xl mx-auto px-6
    • Developer Bento: max-w-5xl mx-auto px-4 sm:px-6
    • Media Showreel: max-w-6xl mx-auto px-4 sm:px-6

3. Surface Elevation & Hairline Border Science

  • Layer 0 (Canvas): #09090b (Dark) / #fafaf9 or #ffffff (Light).
  • Layer 1 (Card Base): #121215 / bg-white dark:bg-zinc-900/60 with backdrop-blur-md.
  • Layer 2 (Hairline Borders): border border-zinc-200/80 dark:border-zinc-800/80 or border border-white/[0.08]. Never use heavy, muddy drop-shadows.
  • Layer 3 (Micro-Hover): Cursor-following radial spotlight (rgba(255,255,255,0.06)), or subtle border brighten hover:border-zinc-400 dark:hover:border-zinc-700, plus subtle lift hover:-translate-y-0.5 transition-all duration-300.

4. Interactive Details & Polish

  • Live Status Indicator:
    <div class="inline-flex items-center gap-2 px-3 py-1.5 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border border-emerald-500/20">
      <span class="w-2 h-2 rounded-full bg-emerald-500 animate-pulse"></span>
      <span>Available for Q1 2026 Opportunities</span>
    </div>
    
  • One-Click Copy Email Pill (with visual feedback): Provide instant clipboard copy with a tooltip transition confirming "Copied!".
  • Dual-Mode Theme Switcher: Always include a working theme toggle (Dark / Light) with icon morphing and localStorage persistence.

📦 Verified Component Arsenal (Direct Access)

The skill includes verified, production-ready TSX primitives and full catalogs:

1. Signature Heroes (components-library/heroes/):

  • ImageStreamHero.tsx: Vanishing-point streaming rails with depth (creators & video editors).
  • PerspectiveTunnelHero.tsx: 3D Z-axis spatial perspective with live metrics (engineers & architects).
  • ProductRailGallery.tsx: Interactive clothing rack with swinging physics (e-commerce & fashion).
  • TiltedGridHero.tsx: Curved 3D image stream bending toward viewer (UI/UX designers & photographers).
  • PrismHero.tsx: Chromatic crystal refraction shader aesthetic (art directors & luxury portfolios).
  • TigerTearRevealHero.tsx: Interactive tear reveal slogan effect (high-impact creatives).
  • AgencyHero01.tsx: High-trust agency hero with social avatars and rating badges (freelancers & agencies).
  • ResponsiveHeroBanner.tsx: Cinematic banner with glassmorphic navigation (founders & leads).
  • CenteredImageFanHero.tsx: Highlighted headline with 3-image fan collage (product designers).

2. Standalone Interactive Primitives (components-library/):

  • Backgrounds: backgrounds/AuroraBackground.tsx (subtle emerald/cyan/slate waves, no neon purple).
  • Interactive Cards: cards/SpotlightCard.tsx (mouse-tracking glow), cards/Card3D.tsx (perspective tilt), cards/BorderBeam.tsx (animated hairline border beam), cards/Meteors.tsx (shooting star particles).
  • Sections & Layouts: sections/BentoGrid.tsx (asymmetric responsive grid), sections/InfiniteMarquee.tsx (seamless tech/logo ticker), sections/BeforeAfterSlider.tsx (interactive image/video comparison), sections/VideoModal.tsx (cinematic video popup), sections/TerminalWidget.tsx (simulated interactive CLI).
  • UI Controls: ui/FloatingNav.tsx (floating glassmorphic pill navbar), ui/ShimmerButton.tsx (shimmering action button), ui/TextGenerateEffect.tsx (staggered word reveal), ui/CopyEmailButton.tsx (one-click copy pill), ui/ThemeToggle.tsx (dark/light theme toggle).

3. Master Component Index:

  • Access the complete 21st.dev Master Catalog in components-library/catalog/INDEX.md containing 11,750+ categorized components across 22 categories (Buttons, Heroes, Galleries, Features, Pricing, Footers, FAQs, etc.).

4. Official shadcn MCP Server (Zero API Key):

  • The AI uses the official shadcn MCP server (npx shadcn@latest mcp) which is 100% free, open-source, and requires zero API keys.
  • Any component from the catalog can be installed via:
    npx shadcn@latest add "https://21st.dev/r/<author>/<component-name>"
    
  • No paid 21st.dev MCP or API key is ever required.

5. Premium Template & Motion Design Inspirations:

The AI can actively draw architectural patterns, kinetic motion, and high-conversion layouts from the world's most premium design ecosystems:

  • VibeUI (vibeui.dev): Modern component compositions, tactile card stacks, interactive badges, floating control pills, and aesthetic layout primitives.
  • Trical (trical.so): Ultra-clean, high-converting portfolio templates, magazine-grade typography, subtle divider lines, and editorial project case studies.
  • Motion Site (motion.site.ai): Fluid micro-animations, kinetic headline reveals, spring physics, and organic transition curves.
  • 21st.dev & Aceternity UI: Master catalog of 11,750+ shadcn-compatible components and spatial 3D interaction primitives.

⚡ Dual Delivery Modes

The AI supports two flexible delivery formats depending on the user's needs:

Mode A: Full React + Vite + Tailwind (TypeScript) Codebase (Default)

Generates a complete, modular, enterprise-grade project structure:

my-portfolio/
├── package.json
├── vite.config.ts
├── tailwind.config.js
├── postcss.config.js
├── tsconfig.json
├── index.html
└── src/
    ├── main.tsx
    ├── App.tsx
    ├── index.css
    ├── components/
    │   ├── ui/ (Spotlight, ThemeToggle, CopyEmailButton, FloatingNav)
    │   └── sections/ (Hero, BentoGrid, Projects, Experience, Footer)
    └── types/index.ts

Mode B: Instant Standalone Single-File HTML/Tailwind/Lucide/JS

When the user wants zero setup, immediate local browser preview, or instant hosting (e.g. GitHub Pages):

  • Generates a single, beautifully formatted, self-contained index.html.
  • Includes Tailwind CSS CDN, Google Fonts, Lucide Icons CDN, and vanilla JS for theme toggle, copy feedback, modal popups, and hover interactions.
  • See production reference implementations in templates/developer-bento/index.html, templates/creative-minimalist/index.html, and templates/video-editor-showreel/index.html.

🛠️ Step-by-Step Execution Workflow

┌────────────────────────────────────────────────────────┐
│  STEP 1: INTAKE & RESUME EXTRACTION                   │
│  Extract metrics, roles, projects, tech stack          │
│  (Or execute 3-batch fallback questionnaire)           │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  STEP 2: MANDATORY INTERACTIVE ALIGNMENT               │
│  Ask: Aesthetic, Theme Mode, Hero & Component choices  │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  STEP 3: COMPONENT SELECTION & ARCHITECTURE           │
│  Assemble 21st.dev primitives from components-library/ │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  STEP 4: PRODUCTION CODE GENERATION                   │
│  Generate React + Vite (default) or Standalone HTML   │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  STEP 5: AUDIT & RUN INSTRUCTIONS                     │
│  Check anti-slop rules, verify build, provide commands │
└────────────────────────────────────────────────────────┘

Step 1: Intake Protocol

  1. If user provides a resume or LinkedIn summary: Parse real metrics, career timeline, top 3-4 projects, and tech competencies.
  2. If no resume is provided: Never hallucinate credentials. Execute the 3-batch questionnaire from references/questionnaire.md:
    • Batch 1: Identity & Target Role
    • Batch 2: Top 2-3 Projects & Concrete Numbers
    • Batch 3: Social & Contact Links

Step 2: Mandatory Interactive Alignment (DO NOT SKIP)

Unless the user explicitly specified their visual style and components upfront, pause and present the interactive alignment:

"Before I generate your portfolio, let's customize the visual design and interactive components:

  1. Visual Style / Aesthetic:
    • Sleek Tech / Dark Bento (Linear / 21st.dev style — obsidian canvas, spotlight hover cards, hairline borders).
    • Clean Minimalist / Swiss Modern (Dieter Rams / Apple style — generous whitespace, refined typography, subtle lines).
    • High-Contrast Editorial (Serif headlines, studio aesthetic, magazine-style case studies).
    • Cinematic Creator / Motion (Deep dark canvas, rich video showreel embeds, view-count badges).
    • Neo-Brutalism (Solid black borders, hard drop shadows, playful high-contrast badges).
  2. Theme Mode:
    • Dual Mode (Recommended) (Both Light and Dark mode with an interactive toggle switch and localStorage memory).
    • Dark Mode Only (Sleek, immersive canvas).
    • Light Mode Only (Crisp, clean, high-readability).
  3. Signature Hero Section: Which hero section would you like to feature?
    • PerspectiveTunnelHero (3D spatial depth with live metrics) — Best for engineers & architects
    • ImageStreamHero (Vanishing-point streaming rails) — Best for video editors & creators
    • TiltedGridHero (Curved 3D image stream) — Best for UI/UX & photographers
    • PrismHero (Refractive chromatic crystal) — Best for art directors & luxury brands
    • AgencyHero01 (Agency hero with trust avatars & star ratings) — Best for freelancers & consultants
    • ResponsiveHeroBanner (Cinematic banner with glassmorphic navigation) — Best for tech founders
    • (Or ambient background: AuroraBackground with TextGenerateEffect)
  4. Delivery Format:
    • React + Vite + Tailwind CSS (TypeScript) (Default full modular project)
    • Instant Standalone Single-File HTML (Zero-dependency, open immediately in browser)*"

Wait for user response (or proceed if already specified).

Step 3: Component Assembly & Composition

Assemble the codebase using the verified primitives in components-library/ and verified recipes in references/21st-dev-catalog.md.

Step 4: Code Generation

Generate complete, error-free code without placeholders like // TODO: implement this later. All interactive elements (copy buttons, theme toggles, mobile menus, video modals) must be fully functional.

Step 5: Verification & Delivery Instructions

  1. Run build verification if using React/Vite:
    npm install
    npm run build
    
  2. Provide simple run commands:
    npm run dev
    
  3. For single-file HTML, instruct the user to open index.html directly in their browser or serve with:
    python scripts/serve.py
    

📚 Supporting Skill References

Related Skills