Communitygithub.com

gabrielmoreira/agent-skills-mirror

求職者向けパーソナルサイトを最適化:30秒ヒーローセクション、成果重視のケーススタディ、ハイブリッド構成(一覧+詳細ルート)、スムーズな問い合わせCTA。モバイルでは重いモーションを無効化。デベロッパー、デザイナー、クリエイターのポートフォリオに最適。SaaSマーケティングページやWebGLチュートリアルではありません。

agent-skills-mirror とは?

このスキルは、開発者やデザイナーが求職用のパーソナルサイト(ポートフォリオ)を効果的に構築・改善するための包括的なガイドを提供します。主な目的は、訪問者が30秒以内に「誰か」「何をするか」「成果」「連絡先」を把握できる「30秒テスト」をクリアする構成にすることです。シングルページ、マルチページ、推奨されるハイブリッド(ホームは一覧、ケーススタディは別ルート)の3つのナビゲーションパターンを提示し、プロジェクトカードやケーススタディの構造化、具体的な成果数値の記載方法を詳しく説明します。また、Framer MotionやThree.jsなどのインタラクティブ要素の段階的な導入方法、モバイルファーストの重要性、CTA(行動喚起)の最適な配置など、実践的なアドバイスを提供します。一般的な落とし穴(ポートフォリオが本業より複雑、モバイルで壊れる、CTA不明瞭など)とその修正方法も網羅しており、最終的なローンチ前チェックリストも含まれています。主にHTML/CSS/JS、React/Next.jsを使用するフロントエンド開発者を対象としています。

対応~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に質問する

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

ドキュメント

使用するタイミング

  • ユーザーがポートフォリオ、パーソナルサイト、仕事の紹介、デベロッパーポートフォリオ、デザイナーポートフォリオ、クリエイティブポートフォリオについて言及または示唆した場合。
  • ユーザーがパーソナルサイトのプロジェクト、ケーススタディ、ヒーローセクションの構造化について支援を必要としている場合。
  • 既存のポートフォリオのコンバージョン率(CTA、連絡方法)を改善したい場合。
  • ポートフォリオにインタラクティブ要素(アニメーション、3D、スクロールエフェクト)を計画している場合。

前提条件

  • ポートフォリオを直接実装する場合、フロントエンド技術(HTML/CSS/JS、React/Next.js)の基本的な理解が必要。
  • 紹介できる完了済みプロジェクトまたはケーススタディが3〜5件用意されていること。

手順

1. ポートフォリオのアーキテクチャ

「30秒テスト」に合格できるようにポートフォリオを構成します。30秒以内に訪問者は以下を把握できる必要があります。

  1. あなたが誰か。
  2. あなたが何をするか(独自の価値提案)。
  3. あなたの最高の仕事(能力の証明)。
  4. 連絡方法(明確なコンバージョンパス)。

必須セクション

セクション目的優先度2026年のベストプラクティス
ヒーローフック + 自己紹介必須インパクトのあるビジュアル + 明確なUVP
実績/プロジェクトスキルの証明必須量より質、結果重視
自己紹介人柄 + ストーリー重要デベロッパー/デザイナーを人間味のあるものに
お問い合わせ興味のコンバージョン必須スムーズな連絡手段(Calendly/Email/LinkedIn)
お客様の声ソーシャルプルーフあると良いLinkedInのスクリーンショットや引用
ブログ/執筆思想的リーダーシップ任意コミュニケーション能力と深い思考の証明

ナビゲーションパターン

  • シングルページスクロール: デザイナー、クリエイティブ、ジュニアデベロッパーに最適。アニメーション(GSAP/Framer Motion)と相性が良く、モバイルフレンドリーで直線的なストーリーテリング。
  • マルチページ: シニア向け、プロジェクト数が多い場合に最適。個別ケーススタディページ(SEO/詳細な分析に有利)。プロフェッショナルで構造化された印象。
  • ハイブリッド(推奨): メインセクションを1ページ(ホーム)にまとめ、詳細ケーススタディは別ルート(/project/name)に配置。両方の利点:素早い把握 + 詳細な掘り下げ。

ヒーローセクションの公式

[あなたの名前]
[あなたの役割を一言で - 例:「ハイパフォーマンスWebアプリを専門とするフロントエンドエンジニア」]
[差別化ポイントを一言で - 例:「複雑なバックエンドロジックとピクセルパーフェクトなUIを橋渡しします」]
[CTA: プロジェクトを見る / お問い合わせ]

2. プロジェクトの紹介

構造化されたプロジェクトカードとケーススタディを使用して、効果的に仕事を紹介します。

プロジェクトカードの要素

要素目的2026年の標準
サムネイル視覚的なフック高解像度 WebP/AVIF または短いループ動画
タイトル何か説明的で明確
一言あなたの貢献行動志向(例:「〜のAPIを設計しました」)
技術/タグ素早い把握モダンスタック(例:Next.js 15, TypeScript, Tailwind)
結果影響の証明定量化可能な指標(例:「読み込み時間を40%短縮」)

ケーススタディの構造

  1. ヒーロー画像/動画(最も印象的なビジュアル)
  2. プロジェクト概要(2〜3文:目標、役割、成果)
  3. 課題(解決しようとした問題)
  4. あなたの役割(チーム内での具体的な貢献)
  5. プロセスのハイライト(ワイヤーフレーム、ロジックフロー、アーキテクチャ図)
  6. 重要な意思決定(なぜXを選んだか - 経験値を示す)
  7. 結果/インパクト(指標、ユーザーフィードバック、ビジネス価値)
  8. 学び(次回は何を変えるか)
  9. リンク(ライブサイト、GitHub、ケーススタディPDF)

インパクトの示し方

代わりにこう書く
「Webサイトを作りました」「A/Bテストによりコンバージョン率を40%向上させました」
「UIをデザインしました」「チェックアウトを簡素化し、ユーザー離脱を25%削減しました」
「機能を開発しました」「月間アクティブユーザー50,000人以上が使用する機能をリリースしました」
「Reactを使いました」「レンダリングパフォーマンスを最適化し、LCPを1.2秒短縮しました」

ビジュアル表現

  • 端末モックアップ(レスポンシブビュー)
  • 改善前/改善後の比較(スライダーコンポーネント)
  • プロセス成果物(Figmaのスクリーンショット、ホワイトボードのスケッチ)
  • ビデオウォークスルー(複雑な作業にはLoomや短いクリップ)
  • マイクロインタラクション(ホバーエフェクトで詳細を表示)

3. デベロッパーポートフォリオの詳細

採用担当者は、コードの品質、実際のプロジェクト、問題解決能力、コミュニケーション能力、技術的深さを重視します。

必須項目

  • GitHubプロフィールリンク(ピン留めリポジトリ、活発なコントリビューション)
  • ライブプロジェクトリンク(Vercel/Netlify/AWSにデプロイ済み)
  • 各プロジェクトの技術スタック(明示的にリストアップ)
  • あなたの具体的な貢献(チームプロジェクトでは重要)

プロジェクトの選び方

含めるべきもの避けるべきもの
実際に解決した問題チュートリアルのクローン(Todoリスト、天気アプリ)
実際のユーザーがいるサイドプロジェクト未完成の「近日公開」プロジェクト
オープンソースへのコントリビューション独自性のない基本的なCRUDアプリ
解決した技術的課題一般的なポートフォリオテンプレート

技術的な見せ所 クリーンなアーキテクチャ、カスタムフック、メモ化、型付けを示すコードスニペットを表示します。

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)
  • ダーク/ライトモードの切り替え(システム設定の検出)

クリエイティブなアイデア

  • ターミナル風インターフェース(バックエンド/システム開発者向け)
  • OSデスクトップのメタファー(インタラクティブなウィンドウ/アイコン)
  • ゲーム風ナビゲーション(キャラクター移動やクエストベース)
  • インタラクティブタイムライン(スクロールベースのキャリア進行)
  • 3Dワークスペースシーン(Spline/Three.js)
  • ジェネラティブアートの背景(Canvas/p5.js)

バランス

  • 創造性はスキルを示すが、ユーザビリティが仕事を勝ち取る。
  • モバイルでも完全に動作すること(モバイルでは重いアニメーションを無効にする)。
  • コンテンツをインタラクションの背後に隠さないこと(アクセシビリティ優先)。
  • リクルーター向けに「スキップイントロ」または「シンプルビュー」オプションを提供する。

5. コンバージョンとCTA

訪問者が次に何をすべきか明確にします。

主要CTA

目標CTA
採用される「一緒に仕事をしませんか」
フリーランス「プロジェクトを始める」
ネットワーキング「ご連絡ください」
特定の役割「[X]で私を雇ってください」

CTAの配置

  • ヒーローセクション:メインCTA(即座に)
  • プロジェクトの後:セカンダリCTA(スキルの証明の後)
  • フッター:最終CTA(最後のチャンス)
  • フローティング:オプションの永続CTA(常に利用可能)

問い合わせを簡単にする

  • メールリンク(mailto:)
  • LinkedIn(新しいタブで開く)
  • カレンダーリンク(Calendly/TidyCal)
  • シンプルなお問い合わせフォーム(バリデーション付き)
  • 「メールアドレスをクリップボードにコピー」ボタン

落とし穴

ポートフォリオが実際の仕事より複雑

重大度: 中 状況: ポートフォリオに6ヶ月かけたが、紹介できるプロジェクトは2つだけ。 なぜ問題か: 仕事を装った先延ばし。ポートフォリオはプロジェクトの一つだが、本来の仕事ではない。磨き込みの限界利益逓減。 修正方法: ポートフォリオを適切な規模にする。MVP(ヒーロー、3〜4プロジェクト、自己紹介、お問い合わせ)から始める。時間予算:最大4週間。コアページがモバイルで動作し、3〜4の確かなプロジェクトが紹介され、連絡手段が機能し、読み込みが3秒未満になったら公開する。良いプロジェクトが良いポートフォリオより重要。

デスクトップでは見栄えが良いが、モバイルで壊れる

重大度: 高 状況: リクルーターがスマホで確認したら、すべて崩れている。 なぜ問題か: デスクトップファーストで構築。実機でテストしていない。複雑なインタラクションがタッチに対応していない。親指ゾーンを忘れている。 修正方法: モバイルファーストデザインを採用。トラフィックの60%以上はモバイル。読みやすいテキスト(16px以上)、タップしやすいリンク(最低44x44px)、動作するナビゲーション、高速読み込み、固定CTAを確保。iPhone Safari、Android Chrome、タブレット、低速3Gでテストする。ホバーエフェクトにはグレースフルデグラデーションを使用する。

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

訪問者が次に何をすべきか分からない

重大度: 中 状況: 素晴らしいポートフォリオだが、問い合わせゼロ。 なぜ問題か: 明確なCTAがない。お問い合わせがページ下部に埋もれている。複数の競合するアクション(分析麻痺)。訪問者が自分で理解すると想定している。 修正方法: ヒーローとプロジェクトセクションの後に目立つお問い合わせCTAを追加する。お問い合わせフォームのみを唯一の選択肢にしない。連絡先情報を隠したり、多すぎるソーシャルオプションをリストアップしない。

ポートフォリオに古いまたは無関係な仕事が表示されている

重大度: 中 状況: 最高の仕事が3年前で、新しい仕事が表示されていない。 なぜ問題か: 何年も更新していない。新しい仕事は「準備ができていない」(完璧主義)。古いお気に入りを削除するのが怖い。ポートフォリオの陳腐化。 修正方法: コピーは6ヶ月ごと、技術は1〜2年ごとに更新する。コードやデザインに恥ずかしさを感じる場合、技術が時代遅れの場合、目標に関係ない場合はプロジェクトを削除する。成長を示す場合は削除せずにアーカイブする。

厳格なルール:使用禁止

  • 使用禁止: フォールバックや「スキップ」オプションなしの重い3D/WebGL。
  • 使用禁止: モバイル端末でのカスタムカーソル。
  • 使用禁止: 「近日公開」のプレースホルダー(セクションを完全に削除すること)。
  • 使用禁止: 経験を確認する唯一の方法としてのPDF履歴書。
  • 使用禁止: ユーザーを混乱させる非標準のナビゲーション。
  • 使用禁止: 自動再生される音声や邪魔なポップアップ。

検証

公開前に以下の検証チェックを実施してください。

  1. 明確なお問い合わせCTAがない(高): ヒーローとプロジェクトセクションの後に目立つお問い合わせCTAがありますか?
  2. モバイルビューポートの欠落(高): HTMLに <meta name='viewport' content='width=device-width, initial-scale=1'> が含まれていますか?
  3. ポートフォリオ画像が最適化されていない(中): 画像にWebP/AVIF、遅延読み込み、レスポンシブサイズ用の srcset を使用していますか?
  4. プロジェクトにライブリンクがない(中): プロジェクトにライブデモURLまたはGitHubリンクがありますか?
  5. プロジェクトにインパクト/結果がない(低): プロジェクトの説明に指標、成果、お客様の声が含まれていますか?

最終チェックリスト

  • ヒーローセクションは、ユーザーが誰で何をしているかを明確に述べていますか?
  • ライブリンクまたはGitHubリポジトリのあるプロジェクトが少なくとも3つありますか?
  • すべてのプロジェクトに「結果」または「インパクト」の記述が含まれていますか?
  • サイトは完全にレスポンシブで、実際のモバイル端末でテストされていますか?
  • ユーザーが連絡するための明確でスムーズな方法がありますか?
  • サイトは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.

関連スキル