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:
- Software Engineers & Systems Architects (Distributed systems, high-throughput APIs, clean technical bento)
- Video Editors, Motion Graphics & Creators (Viral showreels, before/after color grade comparisons, view-count metrics)
- Product Designers & UI/UX Leads (Design systems, case studies, high-contrast Swiss typography, token breakdowns)
- AI/ML Researchers & Data Engineers (Model architectures, arXiv publications, benchmark telemetry, weights badges)
- 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-500headline 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-300blocks 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 (#121215withbackdrop-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
#0b0c10canvas, 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-4xltotext-6xl md:text-7xl):- Line-height must be tight (
leading-[1.08]toleading-[1.12]). Loose leading on large fonts looks amateur. - Letter-spacing must be compressed (
tracking-tightortracking-tighter). - Font weights: Bold or Extrabold (
font-bold/font-extrabold) for technical; Medium or Semibold (font-medium/font-semibold) for editorial serif.
- Line-height must be tight (
- Body Copy (
text-basetotext-lg):- Line-height must be generous (
leading-relaxedorleading-7) to ensure readability. - Line length (Measure): Cap body text width using
max-w-xlormax-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.
- Line-height must be generous (
- Curated Font Pairings:
- Modern Tech:
InterorGeist Sans+JetBrains Monofor tags and code. - High-Impact Creative:
Plus Jakarta SansorSyne+Inter. - Editorial & Luxury:
Cormorant Garamond(serif display) +Inter(sans body).
- Modern Tech:
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-24orspace-y-28. - Card Grids: Standardize on
gap-6orgap-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
- Editorial / Minimalist:
3. Surface Elevation & Hairline Border Science
- Layer 0 (Canvas):
#09090b(Dark) /#fafaf9or#ffffff(Light). - Layer 1 (Card Base):
#121215/bg-white dark:bg-zinc-900/60withbackdrop-blur-md. - Layer 2 (Hairline Borders):
border border-zinc-200/80 dark:border-zinc-800/80orborder 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 brightenhover:border-zinc-400 dark:hover:border-zinc-700, plus subtle lifthover:-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
localStoragepersistence.
📦 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.mdcontaining 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, andtemplates/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
- If user provides a resume or LinkedIn summary: Parse real metrics, career timeline, top 3-4 projects, and tech competencies.
- 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:
- 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).
- Theme Mode:
- Dual Mode (Recommended) (Both Light and Dark mode with an interactive toggle switch and
localStoragememory).- Dark Mode Only (Sleek, immersive canvas).
- Light Mode Only (Crisp, clean, high-readability).
- Signature Hero Section: Which hero section would you like to feature?
PerspectiveTunnelHero(3D spatial depth with live metrics) — Best for engineers & architectsImageStreamHero(Vanishing-point streaming rails) — Best for video editors & creatorsTiltedGridHero(Curved 3D image stream) — Best for UI/UX & photographersPrismHero(Refractive chromatic crystal) — Best for art directors & luxury brandsAgencyHero01(Agency hero with trust avatars & star ratings) — Best for freelancers & consultantsResponsiveHeroBanner(Cinematic banner with glassmorphic navigation) — Best for tech founders- (Or ambient background:
AuroraBackgroundwithTextGenerateEffect)- 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
- Run build verification if using React/Vite:
npm install npm run build - Provide simple run commands:
npm run dev - For single-file HTML, instruct the user to open
index.htmldirectly in their browser or serve with:python scripts/serve.py
📚 Supporting Skill References
- references/design-systems.md — Color palettes, typography pairs, and theme architectures.
- references/archetypes.md — Section blueprints for Developers, Video Editors, Designers, etc.
- references/questionnaire.md — 3-batch intake questionnaire.
- references/prompt-library.md — Ready-to-use component TSX patterns.
- references/21st-dev-catalog.md — Master catalog recipes and links.
- components-library/catalog/INDEX.md — Master index of 11,750+ 21st.dev components.