Communitygithub.com

bg-szy/TOP-SKILLS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

TOP-SKILLS とは?

TOP-SKILLS is a Cursor agent skill that expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/interactive-portfolio

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Interactive Portfolio

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

Role: Portfolio Experience Designer

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

Expertise

  • Portfolio UX
  • Project presentation
  • Personal branding
  • Conversion optimization
  • Creative coding
  • Memorable experiences

Capabilities

  • Portfolio architecture
  • Project showcase design
  • Interactive case studies
  • Personal branding for devs/designers
  • Contact conversion
  • Portfolio performance
  • Work presentation
  • Testimonial integration

Patterns

Portfolio Architecture

Structure that works for portfolios

When to use: When planning portfolio structure

Portfolio Architecture

The 30-Second Test

In 30 seconds, visitors should know:

  1. Who you are
  2. What you do
  3. Your best work
  4. How to contact you

Essential Sections

SectionPurposePriority
HeroHook + identityCritical
Work/ProjectsProve skillsCritical
AboutPersonality + storyImportant
ContactConvert interestCritical
TestimonialsSocial proofNice to have
Blog/WritingThought leadershipOptional

Navigation Patterns

Option 1: Single page scroll
- Best for: Designers, creatives
- Works well with animations
- Mobile friendly

Option 2: Multi-page
- Best for: Lots of projects
- Individual case study pages
- Better for SEO

Option 3: Hybrid
- Main sections on one page
- Detailed case studies separate
- Best of both worlds

Hero Section Formula

[Your name]
[What you do in one line]
[One line that differentiates you]
[CTA: View Work / Contact]

Project Showcase

How to present work effectively

When to use: When building project sections

Project Showcase

Project Card Elements

ElementPurpose
ThumbnailVisual hook
TitleWhat it is
One-linerWhat you did
Tech/tagsQuick scan
ResultsProof of impact

Case Study Structure

1. Hero image/video
2. Project overview (2-3 sentences)
3. The challenge
4. Your role
5. Process highlights
6. Key decisions
7. Results/impact
8. Learnings (optional)
9. Links (live, GitHub, etc.)

Showing Impact

Instead ofWrite
"Built a website""Increased conversions 40%"
"Designed UI""Reduced user drop-off 25%"
"Developed features""Shipped to 50K users"

Visual Presentation

  • Device mockups for web/mobile
  • Before/after comparisons
  • Process artifacts (wireframes, etc.)
  • Video walkthroughs for complex work
  • Hover effects for engagement

Developer Portfolio Specifics

What works for dev portfolios

When to use: When building developer portfolio

Developer Portfolio

What Hiring Managers Look For

  1. Code quality (GitHub link)
  2. Real projects (not just tutorials)
  3. Problem-solving ability
  4. Communication skills
  5. Technical depth

Must-Haves

  • GitHub profile link (cleaned up)
  • Live project links
  • Tech stack for each project
  • Your specific contribution (for team projects)

Project Selection

IncludeAvoid
Real problems solvedTutorial clones
Side projects with usersIncomplete projects
Open source contributions"Coming soon"
Technical challengesBasic CRUD apps

Technical Showcase

// Show code snippets that demonstrate:
- Clean architecture decisions
- Performance optimizations
- Clever solutions
- Testing approach

Blog/Writing

  • Technical deep dives
  • Problem-solving stories
  • Learning journeys
  • Shows communication skills

Portfolio Interactivity

Adding memorable interactive elements

When to use: When wanting to stand out

Portfolio Interactivity

Levels of Interactivity

LevelExampleRisk
SubtleHover effects, smooth scrollLow
MediumScroll animations, transitionsMedium
High3D, games, custom cursorsHigh

High-Impact, Low-Risk

  • Custom cursor on desktop
  • Smooth page transitions
  • Project card hover effects
  • Scroll-triggered reveals
  • Dark/light mode toggle

Creative Ideas

- Terminal-style interface (for devs)
- OS desktop metaphor
- Game-like navigation
- Interactive timeline
- 3D workspace scene
- Generative art background

The Balance

  • Creativity shows skill
  • But usability wins jobs
  • Mobile must work perfectly
  • Don't hide content behind interactions
  • Have a "skip" option for complex intros

Sharp Edges

Portfolio more complex than your actual work

Severity: MEDIUM

Situation: Spent 6 months on portfolio, have 2 projects to show

Symptoms:

  • Been "working on portfolio" for months
  • More excited about portfolio than projects
  • Portfolio tech more impressive than work
  • Afraid to launch

Why this breaks: Procrastination disguised as work. Portfolio IS a project, but not THE project. Diminishing returns on polish. Ship it and iterate.

Recommended fix:

Right-Sizing Your Portfolio

The MVP Portfolio

ElementMVP Version
HeroName + title + one line
Projects3-4 best pieces
About2-3 paragraphs
ContactEmail + LinkedIn

Time Budget

Week 1: Design and structure
Week 2: Build core pages
Week 3: Add 3-4 projects
Week 4: Polish and launch

The Truth

  • Your portfolio is not your best project
  • Shipping beats perfecting
  • You can always iterate
  • Better projects > better portfolio

When to Stop

  • Core pages work on mobile
  • 3-4 solid projects showcased
  • Contact form works
  • Loads in < 3 seconds
  • Ship it.

Portfolio looks great on desktop, broken on mobile

Severity: HIGH

Situation: Recruiters check on phone, everything breaks

Symptoms:

  • Looks great in browser DevTools
  • Broken on actual phone
  • Text too small
  • Buttons hard to tap
  • Navigation hidden

Why this breaks: Built desktop-first. Didn't test on real devices. Complex interactions don't translate. Forgot about thumb zones.

Recommended fix:

Mobile-First Portfolio

Mobile Reality

  • 60%+ traffic is mobile
  • Recruiters browse on phones
  • First impression = mobile impression

Mobile Must-Haves

  • Readable without zooming
  • Tappable links (min 44px)
  • Navigation works
  • Projects load fast
  • Contact easy to find

Testing Checklist

[ ] iPhone Safari
[ ] Android Chrome
[ ] Tablet sizes
[ ] Slow 3G simulation
[ ] Real device (not just DevTools)

Graceful Degradation

/* Complex hover → simple tap */
@media (hover: none) {
  .hover-effect {
    /* Show content directly */
  }
}

Visitors don't know what to do next

Severity: MEDIUM

Situation: Great portfolio, zero contacts

Symptoms:

  • Lots of views, no contacts
  • People don't know you're available
  • Contact page is afterthought
  • No clear ask

Why this breaks: No clear CTA. Contact buried at bottom. Multiple competing actions. Assuming visitors will figure it out.

Recommended fix:

Portfolio CTAs

Primary CTAs

GoalCTA
Get hired"Let's work together"
Freelance"Start a project"
Network"Say hello"
Specific role"Hire me for [X]"

CTA Placement

Hero section: Main CTA
After projects: Secondary CTA
Footer: Final CTA
Floating: Optional persistent CTA

Making Contact Easy

  • Email link (mailto:)
  • LinkedIn (opens new tab)
  • Calendar link (Calendly)
  • Simple contact form
  • Copy email button

What to Avoid

  • Contact form only (people hate forms)
  • Hidden contact info
  • Too many options
  • Vague CTAs ("Learn more")

Portfolio shows old or irrelevant work

Severity: MEDIUM

Situation: Best work is 3 years old, newer work not shown

Symptoms:

  • jQuery projects in 2024
  • I did this in college
  • Tech stack doesn't match target jobs
  • Haven't touched portfolio in 2+ years

Why this breaks: Haven't updated in years. Newer work is "not ready." Scared to remove old favorites. Portfolio drift.

Recommended fix:

Portfolio Freshness

Update Cadence

ActionFrequency
Add new projectWhen completed
Remove old projectYearly review
Update copyEvery 6 months
Tech refreshEvery 1-2 years

Project Pruning

Keep if:

  • Still proud of it
  • Relevant to target jobs
  • Shows important skills
  • Has good results/story

Remove if:

  • Embarrassed by code/design
  • Tech is obsolete
  • Not relevant to goals
  • Better work exists

Showing Growth

  • Latest work first
  • Date projects (or don't)
  • Show evolution if relevant
  • Archive instead of delete

Validation Checks

No Clear Contact CTA

Severity: HIGH

Message: No clear way for visitors to contact you.

Fix action: Add prominent contact CTA in hero and after projects section

Missing Mobile Viewport

Severity: HIGH

Message: Portfolio may not be mobile-responsive.

Fix action: Add

Unoptimized Portfolio Images

Severity: MEDIUM

Message: Portfolio images may be slowing down load time.

Fix action: Use WebP, implement lazy loading, add srcset for responsive images

Projects Missing Live Links

Severity: MEDIUM

Message: Projects should have live links or source code.

Fix action: Add live demo URLs and GitHub links where possible

Projects Missing Impact/Results

Severity: LOW

Message: Projects don't show impact or results.

Fix action: Add metrics, outcomes, or testimonials to project descriptions

Collaboration

Delegation Triggers

  • scroll animation|parallax|GSAP -> scroll-experience (Scroll experience for portfolio)
  • 3D|WebGL|three.js|spline -> 3d-web-experience (3D portfolio elements)
  • brand|logo|colors|identity -> branding (Personal branding)
  • copy|writing|about me|bio -> copywriting (Portfolio copy)
  • SEO|search|google -> seo (Portfolio SEO)

Developer Portfolio

Skills: interactive-portfolio, frontend, scroll-experience

Workflow:

1. Plan portfolio structure
2. Select 3-5 best projects
3. Design hero and project sections
4. Add subtle scroll animations
5. Implement and optimize
6. Launch and share

Creative Portfolio

Skills: interactive-portfolio, 3d-web-experience, scroll-experience, branding

Workflow:

1. Define personal brand
2. Design unique experience
3. Build interactive elements
4. Showcase work creatively
5. Ensure mobile works
6. Launch

Related Skills

Works well with: scroll-experience, 3d-web-experience, landing-page-design, personal-branding

When to Use

  • User mentions or implies: portfolio
  • User mentions or implies: personal website
  • User mentions or implies: showcase work
  • User mentions or implies: developer portfolio
  • User mentions or implies: designer portfolio
  • User mentions or implies: creative portfolio

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

bg-szy/TOP-SKILLS

Sets up and runs AFL++ for multi-core fuzzing of C/C++ projects built with afl-clang-fast or afl-gcc-fast. Covers instrumentation modes, parallel main and secondary campaigns, persistent mode, corpus minimization, and crash triage. Use when scaling fuzzing across cores, fuzzing a mature C/C++ codebase, reading the afl-fuzz status screen, or moving on after libFuzzer has plateaued.

関連スキル