Communitygithub.com

gabrielmoreira/agent-skills-mirror

為求職者打造個人網站:三十秒英雄敘事、成果導向的案例研究、混合式首頁與專案路由,以及零摩擦的聯絡行動呼籲,並搭配會在行動裝置上降級的大量動畫。適用於開發者、設計師或創意人的作品集。不適用於 SaaS 行銷登陸頁面或 WebGL 引擎教學。

agent-skills-mirror 是什麼?

這項技能旨在引導 AI 代理(如 Claude Code、Cursor 等)協助使用者建立高轉換率的個人作品集網站。核心目標是讓訪客在 30 秒內清楚知道「你是誰、你做什麼、你的最佳作品、以及如何聯絡你」,並提供從架構、專案展示、技術細節、互動性到轉換優化的完整流程。技能支援開發者、設計師與創意人作品集,並強烈建議採用「混合式」導航(單頁首頁 + 獨立案例研究路由),以兼顧快速瀏覽與深度探索。說明文件中包含了詳細的區塊規劃表、案例研究結構、甚至展示影響力的前後對比寫法,以及如何透過 `useDebounceState` 等自訂 Hook 來展現技術深度。此外,也明確指出常見陷阱,例如作品集比實際作品還複雜、行動裝置體驗破碎、缺乏明確行動呼籲等,並提供具體的修正與驗證檢查清單,確保最終成品可用、易用且有效。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gabrielmoreira/agent-skills-mirror/tree/HEAD/mirrors/repos/kazimrmerchant@skill-slice/skills/interactive-portfolio

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

使用時機

  • 使用者提及或暗示:作品集、個人網站、展示作品、開發者作品集、設計師作品集或創意人作品集。
  • 使用者需要協助為個人網站規劃專案結構、案例研究或英雄區塊。
  • 使用者希望改善現有作品集的轉換率(行動呼籲、聯絡方式)。
  • 使用者正在為作品集規劃互動元素(動畫、3D、滾動效果)。

先決條件

  • 若直接實作作品集,需具備前端技術(HTML/CSS/JS、React/Next.js)的基本知識。
  • 準備好 3-5 個已完成的專案或案例研究以進行展示。

程序

1. 作品集架構

將作品集打造成能通過「30 秒測試」的結構。在 30 秒內,訪客應知道:

  1. 你是誰。
  2. 你做什麼(你的獨特價值主張)。
  3. 你最好的作品(能力證明)。
  4. 如何聯絡你(清楚的轉換路徑)。

必要區塊

區塊目的優先級2026 年最佳實務
Hero鉤子 + 身份識別關鍵高影響力視覺 + 清晰的 UVP
作品/專案證明技能關鍵重質不重量;聚焦於成果
關於我個性 + 故事重要讓開發者/設計師更人性化
聯絡轉換興趣關鍵零摩擦聯絡(Calendly/Email/LinkedIn)
推薦社會證明錦上添花經過驗證的 LinkedIn 截圖或引言
部落格/寫作思想領導力選用溝通與深度思考的證明

導航模式

  • 單頁滾動:最適合設計師、創意人、初階開發者。與動畫(GSAP/Framer Motion)搭配良好。行動裝置友善,線性敘事。
  • 多頁面:最適合資深角色、大量專案列表。獨立的案例研究頁面(對 SEO/深入探討較佳)。專業、結構化的感覺。
  • 混合式(推薦):主要區塊集中在一個頁面(首頁)。詳細的案例研究則放在獨立路由(/project/name)。兩全其美:快速掃描 + 深度探討。

Hero 區塊公式

[你的名字]
[你在一行內說明做什麼 - 例如:「專精於高效能 Web 應用的前端工程師」]
[一行內說明你的與眾不同之處 - 例如:「銜接複雜後端邏輯與像素完美 UI 之間的鴻溝」]
[CTA:查看作品 / 取得聯繫]

2. 專案展示

使用結構化的專案卡片與案例研究有效呈現作品。

專案卡片元素

元素目的2026 年標準
縮圖視覺鉤子高解析度 WebP/AVIF 或短循環影片
標題這是什麼描述清晰且明確
一句話簡介你做了什麼行動導向(例如:「為……設計了 API 架構」)
技術/標籤快速掃描現代技術棧(例如:Next.js 15, TypeScript, Tailwind)
成果影響力證明可量化的指標(例如:「將載入時間減少了 40%」)

案例研究結構

  1. Hero 圖片/影片(「關鍵畫面」)
  2. 專案概述(2-3 句話:目標、角色、成果)
  3. 挑戰(你正在解決的問題)
  4. 你的角色(在團隊中的具體貢獻)
  5. 流程重點(線框圖、邏輯流程、架構圖)
  6. 關鍵決策(為什麼選擇 X 而不是 Y - 展現資歷)
  7. 成果/影響(指標、使用者回饋、商業價值)
  8. 學習(下次你會怎麼做)
  9. 連結(線上網站、GitHub、案例研究 PDF)

展示影響力

避免這樣寫改成這樣寫
「建立了一個網站」「透過 A/B 測試將轉換率提升了 40%」
「設計了 UI」「透過簡化結帳流程,將使用者流失率降低了 25%」
「開發了功能」「推出了每月活躍使用者超過 5 萬人的功能」
「使用了 React」「優化了渲染效能,將 LCP 減少了 1.2 秒」

視覺呈現

  • 裝置模型(響應式視圖)
  • 前後比較(滑塊元件)
  • 流程產出物(Figma 截圖、白板草稿)
  • 影片導覽(針對複雜專案使用 Loom 或短片)
  • 微互動(可顯示細節的懸停效果)

3. 開發者作品集的具體事項

招聘經理會尋找程式碼品質、真實世界專案、解決問題的能力、溝通技巧和技術深度。

必備項目

  • GitHub 個人檔案連結(置頂的儲存庫、活躍貢獻)
  • 線上專案連結(透過 Vercel/Netlify/AWS 部署)
  • 每個專案的技術棧(明確列出)
  • 你的具體貢獻(對於團隊專案至關重要)

專案選擇

要包含的要避免的
解決的真實問題教學複製品(待辦事項清單、天氣應用)
有實際使用者的 side project不完整的「即將推出」專案
開源貢獻沒有獨特之處的基本 CRUD 應用
解決的技術挑戰一般的作品集模板

技術展示 展示能體現清晰架構、自訂 Hook、記憶化和型別檢查的程式碼片段:

import { useState, useCallback, useMemo, useEffect } from 'react';

interface UseDebounceStateOptions<T> {
  delay?: number;
  onDebounceUpdate?: (value: T) => void;
}

export function useDebounceState<T>(
  initialValue: T,
  options: UseDebounceStateOptions<T> = {}
) {
  const { delay = 300, onDebounceUpdate } = options;
  const [value, setValue] = useState<T>(initialValue);
  const [debouncedValue, setDebouncedValue] = useState<T>(initialValue);
  const [isPending, setIsPending] = useState<boolean>(false);

  useEffect(() => {
    setIsPending(true);
    const handler = setTimeout(() => {
      setDebouncedValue(value);
      setIsPending(false);
      if (onDebounceUpdate) {
        onDebounceUpdate(value);
      }
    }, delay);

    return () => clearTimeout(handler);
  }, [value, delay, onDebounceUpdate]);

  const set = useCallback((newValue: T) => {
    setValue(newValue);
  }, []);

  return useMemo(
    () => ({
      value,
      debouncedValue,
      isPending,
      set,
    }),
    [value, debouncedValue, isPending, set]
  );
}

4. 作品集互動性

在平衡創意與可用性的同時,加入令人難忘的互動元素。

互動性等級

等級範例風險
微妙懸停效果、平滑滾動、淡入低
中等滾動動畫、頁面轉場、深色模式中
高3D(Three.js)、遊戲、自訂游標、WebGL高

高影響力、低風險

  • 自訂游標(僅限桌面)
  • 平滑頁面轉場(Framer Motion/View Transitions API)
  • 專案卡片懸停效果(縮放、發光或揭示細節)
  • 觸發式滾動揭示(Intersection Observer)
  • 深色/淺色模式切換(系統偏好偵測)

創意點子

  • 終端機風格介面(適用於後端/系統開發者)
  • 作業系統桌面隱喻(可互動的視窗/圖示)
  • 遊戲式導航(角色移動或任務導向)
  • 互動時間軸(基於滾動的職涯進展)
  • 3D 工作空間場景(Spline/Three.js)
  • 生成式藝術背景(Canvas/p5.js)

平衡原則

  • 創意能展現技能,但可用性才能贏得工作。
  • 行動裝置必須完美運作(在行動裝置上停用重型動畫)。
  • 不要將內容隱藏在互動背後(以無障礙為優先)。
  • 為招聘人員提供「跳過簡介」或「簡潔檢視」的選項。

5. 轉換與行動呼籲

確保訪客知道下一步該做什麼。

主要行動呼籲

目標CTA
找工作「讓我們合作」
接案「開始一個專案」
拓展人脈「打個招呼」
特定職位「為 [X] 僱用我」

行動呼籲放置位置

  • Hero 區塊:主要 CTA(立即)
  • 專案之後:次要 CTA(技能證明後)
  • 頁尾:最終 CTA(最後機會)
  • 浮動式:選用、持續顯示的 CTA(隨時可用)

讓聯絡變得簡單

  • 電子郵件連結 (mailto:)
  • LinkedIn(在新分頁開啟)
  • 日曆連結(Calendly/TidyCal)
  • 簡單的聯絡表單(附驗證)
  • 「複製電子郵件到剪貼簿」按鈕

常見陷阱

作品集比實際作品還複雜

嚴重程度: 中 情況: 花了 6 個月做作品集,卻只有 2 個專案可以展示。 為何有問題: 偽裝成工作的拖延。作品集本身是一個專案,但不是主要專案。修飾的邊際效益遞減。 修正方法: 調整作品集規模。從 MVP 開始(Hero、3-4 個專案、關於我、聯絡)。時間預算:最多 4 週。核心頁面能在行動裝置上運作、展示了 3-4 個紮實的專案、聯絡功能正常、且載入時間少於 3 秒時,就將它上線。更好的專案 > 更好的作品集。

作品集在桌面看起來很棒,在行動裝置上卻壞掉了

嚴重程度: 高 情況: 招聘人員在手機上查看,所有東西都壞了。 為何有問題: 以桌面為優先進行建置。沒有在真實裝置上測試。複雜的互動無法轉換到觸控螢幕。忘記了拇指區域。 修正方法: 採用行動裝置優先設計。60% 以上的流量來自行動裝置。確保文字可讀(16px+)、連結可點擊(最小 44x44px)、導航正常運作、載入快速,以及固定的 CTA。在 iPhone Safari、Android Chrome、平板和慢速 3G 網路上進行測試。對懸停效果使用優雅降級:

@media (hover: none) {
  .hover-effect {
    opacity: 1;
  }
}

訪客不知道下一步該做什麼

嚴重程度: 中 情況: 作品集很棒,但零聯絡。 為何有問題: 沒有明確的 CTA。聯絡資訊藏在最下面。多個互相競爭的行動選項(分析癱瘓)。假設訪客會自己想辦法。 修正方法: 在 Hero 和專案區塊後加入顯眼的聯絡 CTA。避免將聯絡表單當作唯一選項。不要隱藏聯絡資訊或列出太多社群選項。

作品集展示的是過時或不相關的作品

嚴重程度: 中 情況: 最好的作品是 3 年前的,新作品沒有展示出來。 為何有問題: 好幾年沒更新。新作品「還沒準備好」(完美主義)。捨不得移除舊愛。作品集內容偏離目標。 修正方法: 每 6 個月更新文字,每 1-2 年更新技術。如果對程式碼/設計感到難為情、技術已過時、或與目標不相關,就刪除這些專案。若想展示成長歷程,可選擇封存而非刪除。

嚴格規則:請勿使用

  • 請勿使用 沒有備援或「跳過」選項的重型 3D/WebGL。
  • 請勿使用 行動裝置上的自訂游標。
  • 請勿使用 「即將推出」的佔位符(請直接移除該區塊)。
  • 請勿使用 PDF 履歷作為查看經歷的唯一方式。
  • 請勿使用 會混淆使用者的非標準導航。
  • 請勿使用 自動播放音訊或侵入式彈出視窗。

驗證

在啟動前執行以下驗證檢查:

  1. 缺少明確的聯絡 CTA(高): 在 Hero 和專案區塊後是否有顯眼的聯絡 CTA?
  2. 缺少行動裝置 Viewport(高): HTML 是否包含 <meta name='viewport' content='width=device-width, initial-scale=1'>?
  3. 作品集圖片未最佳化(中): 圖片是否使用 WebP/AVIF、延遲載入以及用於響應式尺寸的 srcset?
  4. 專案缺少線上連結(中): 專案是否有線上展示 URL 或 GitHub 連結?
  5. 專案缺少影響力/成果(低): 專案描述是否包含指標、成果或推薦?

最終檢查清單

  • Hero 區塊是否清楚說明了使用者身份及其工作內容?
  • 是否至少有 3 個專案附有線上連結或 GitHub 儲存庫?
  • 每個專案是否都包含「成果」或「影響力」陳述?
  • 網站是否完全響應式,並已在真實行動裝置上測試?
  • 是否有清晰且零摩擦的方式讓使用者與你聯絡?
  • 網站是否在 3 秒內載入完成(Lighthouse/PageSpeed Insights)?
  • 圖片是否已最佳化(WebP/AVIF)並啟用延遲載入?
  • 導航是否直覺且易於存取(鍵盤/螢幕閱讀器)?

相關技能

與以下技能搭配良好:scroll-experience, 3d-web-experience, landing-page-design, personal-branding, frontend, seo

Individual skills in this repo

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

gabrielmoreira/agent-skills-mirror

Design exclusive bonus packages that make YOUR affiliate link the obvious choice. Triggers on: "create bonuses for", "bonus stack", "what bonuses should I offer", "bonus ideas for", "exclusive bonuses", "differentiate my affiliate link", "why buy through my link", "affiliate bonuses", "bonus package", "what can I offer as a bonus", "design bonuses", "build a bonus stack".

gabrielmoreira/agent-skills-mirror

Design irresistible affiliate offers using the Hormozi Grand Slam framework. Triggers on: "create an offer for", "design my offer", "grand slam offer", "make an irresistible offer", "why should someone buy through my link", "offer framework", "value proposition for", "Hormozi offer", "offer stack", "make my offer irresistible", "craft an offer", "what makes my offer different", "offer design", "increase perceived value".

gabrielmoreira/agent-skills-mirror

Create YOUR personal guarantee on top of the product's guarantee for risk reversal. Triggers on: "create a guarantee", "guarantee for my affiliate", "risk reversal", "money back guarantee", "what guarantee can I offer", "reduce buyer risk", "guarantee copy", "how to guarantee", "affiliate guarantee", "personal guarantee", "risk-free offer", "satisfaction guarantee", "results guarantee".

gabrielmoreira/agent-skills-mirror

Build high-converting affiliate landing pages as single self-contained HTML files. Triggers on: "create a landing page for", "build a landing page", "product landing page", "affiliate landing page", "comparison page for", "vs page", "single product page", "conversion page", "sales page for affiliate", "landing page HTML", "build me a page for", "create a page to promote [product]", "I need a landing page", "make a page for [product]".

gabrielmoreira/agent-skills-mirror

Build a single-product deep-dive showcase page as a self-contained HTML file. Triggers on: "build a product showcase page", "deep dive landing page for [product]", "create a product spotlight page", "product feature page", "single product page", "detailed page about [product]", "build a page showing everything about [product]", "create a long-form product page", "build a sales page for [product]", "product deep dive page", "make a feature breakdown page for [product]".

gabrielmoreira/agent-skills-mirror

Build email capture landing pages (squeeze pages) as single self-contained HTML files. Triggers on: "build a squeeze page", "email capture page", "lead magnet page", "create an opt-in page", "build an email list page", "lead capture landing page", "create a freebie page", "build a page to collect emails", "opt-in landing page", "email signup page for [product/niche]", "create a lead magnet landing page", "build a page that captures emails before sending to affiliate offer".

gabrielmoreira/agent-skills-mirror

Design the complete free-to-premium value ladder for affiliate promotions. Triggers on: "value ladder", "customer journey", "upsell path", "ascension model", "free to paid funnel", "tripwire offer", "upsell strategy", "downsell", "product ladder", "price ladder", "customer ascension", "funnel architecture", "map my funnel", "design my funnel stages", "monetization path".

gabrielmoreira/agent-skills-mirror

Build a webinar or live event registration page as a self-contained HTML file with countdown timer, speaker bio, agenda, and registration form. Triggers on: "build a webinar registration page", "create a webinar sign-up page", "event registration landing page", "live training registration page", "workshop sign-up page", "create a webinar page", "build an event page", "free webinar landing page", "live demo registration page", "online event page", "create a registration page for my webinar", "build a training event page".

gabrielmoreira/agent-skills-mirror

Audit paid-ad landing pages for message match, mobile experience, performance, accessibility, trust, forms, consent, tracking, security, and conversion friction. Use for landing-page audit, post-click experience, LP audit, conversion-rate optimization, form optimization, ad-to-page message match, redirects, blocked navigation, or requests involving private, loopback, link-local, or metadata IP destinations.

gabrielmoreira/agent-skills-mirror

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

gabrielmoreira/agent-skills-mirror

Review UI code for Web Interface Guidelines compliance.

gabrielmoreira/agent-skills-mirror

Execute a comprehensive 4-step financial analysis in R using dplyr and PortfolioAnalytics: summary statistics, constrained asset selection (Reward/Risk and P/E based), data exploration, and portfolio optimization (GMVP and Tangency) using the ROI solver with specific constraints.

gabrielmoreira/agent-skills-mirror

Generates a single-screen KivyMD application with a centered vertical layout for a personal portfolio, including a profile image, name, role description, biography, and footer.

gabrielmoreira/agent-skills-mirror

Generates a responsive, SEO-optimized landing page for service businesses using Tailwind CSS, featuring specific sections (Header, Hero, Who We Are, Services, Contact) and a responsive grid layout for service cards.

gabrielmoreira/agent-skills-mirror

Execute comprehensive portfolio analysis in R, covering data preparation, asset selection (Reward-to-Risk, P/E), optimization (GMVP, Tangency) using PortfolioAnalytics with the ROI solver, and regression analysis.

gabrielmoreira/agent-skills-mirror

Generate and rewrite marketing content for software services and portfolios. Adapts tone from professional agency to customer-centric, handles style mimicry, formatting constraints, and strictly manages perspective (e.g., removing first-person pronouns for portfolio contexts).

gabrielmoreira/agent-skills-mirror

When the user wants to design, deploy, or measure Apple Custom Product Pages (CPP) — the alternate App Store product pages with different screenshots, preview videos, and promo text shown to users coming from specific URLs (typically ad campaigns or social posts). Use when the user mentions "Custom Product Page", "CPP", "alternate product page", "App Store URL variant", "ASA CPP", "campaign-specific landing page", "product page per audience", "App Store Connect CPP", "ppoUrl", "?cpp=" parameter, or "show different screenshots to different ad audiences". For App Store A/B tests on the default page, see ab-test-store-listing. For paid ad campaigns that route to CPPs, see apple-search-ads or ua-campaign.

gabrielmoreira/agent-skills-mirror

Generate complete, deploy-ready landing pages from any repository. Use when creating a homepage for an open-source project, building a project website, converting a README into a marketing page, or standardizing landing pages across multiple repos.

相關技能