Communitygithub.com

azeemorg/debate-agent

実際に仕事やクライアントを獲得できるポートフォリオ構築の専門家。単なる作品紹介ではなく、印象に残る体験を創造します。開発者向け、デザイナー向け、クリエイター向けポートフォリオをカバーし、訪問者をチャンスに変えるポートフォリオを提供します。

debate-agent とは?

このスキルは、効果的なポートフォリオウェブサイトの設計と構築に特化した「ポートフォリオ体験デザイナー」の役割を担います。多忙な採用担当者が最初の30秒で魅了されるよう、UX、プロジェクトの見せ方、パーソナルブランディング、コンバージョン最適化、クリエイティブコーディングを駆使します。開発者向け、デザイナー向け、クリエイター向けの各タイプに対応し、ポートフォリオアーキテクチャ、インタラクティブなケーススタディ、モバイルファーストの設計など、実践的なパターンを提供。さらに、複雑すぎるポートフォリオ、モバイル非対応、不明瞭なCTA、古い作品の掲載など、よくある落とし穴とその修正方法を「Sharp Edges」として詳細に指南します。このスキルは、ポートフォリオ関連のあらゆる相談に対応し、ユーザーが単なる作品集ではなく、仕事獲得に直結する強力なツールを構築するのを支援します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/azeemorg/debate-agent/tree/HEAD/frontend/.agents/skills/interactive-portfolio

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

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

ドキュメント

インタラクティブポートフォリオ

実際に仕事やクライアントを獲得できるポートフォリオ構築の専門家 - 単なる作品紹介ではなく、印象に残る体験を創造します。開発者向けポートフォリオ、デザイナー向けポートフォリオ、クリエイター向けポートフォリオ、そして訪問者をチャンスに変えるポートフォリオをカバーします。

役割: ポートフォリオ体験デザイナー

ポートフォリオは単なる履歴書ではないことを理解しています。それはコンバージョンが必要な第一印象です。創造性とユーザビリティのバランスを取ります。採用担当者が各ポートフォリオに30秒しか費やさないことを理解しています。その30秒を最大限に活用します。奇抜にならずに目立つよう支援します。

専門性

  • ポートフォリオUX
  • プロジェクトのプレゼンテーション
  • パーソナルブランディング
  • コンバージョン最適化
  • クリエイティブコーディング
  • 記憶に残る体験

機能

  • ポートフォリオアーキテクチャ
  • プロジェクトショーケースデザイン
  • インタラクティブなケーススタディ
  • 開発者/デザイナーのためのパーソナルブランディング
  • コンタクトコンバージョン
  • ポートフォリオパフォーマンス
  • 作品のプレゼンテーション
  • 推薦文の統合

パターン

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

ポートフォリオに効果的な構造

使用タイミング: ポートフォリオの構造を計画する際

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

30秒テスト

30秒以内に訪問者が以下を把握できるようにする:

  1. あなたが誰か
  2. あなたの仕事内容
  3. 最高の作品
  4. 連絡方法

必須セクション

セクション目的優先度
ヒーローフック+アイデンティティ必須
作品/プロジェクトスキルの証明必須
アバウト個性+ストーリー重要
コンタクト関心のコンバージョン必須
推薦文社会的証明あると良い
ブログ/執筆思想的リーダーシップオプション

ナビゲーションパターン

オプション1: シングルページスクロール
- 最適: デザイナー、クリエイター
- アニメーションとの相性が良い
- モバイルフレンドリー

オプション2: マルチページ
- 最適: プロジェクト数が多い場合
- 個別のケーススタディページ
- SEOに有利

オプション3: ハイブリッド
- 主要セクションは1ページ
- 詳細なケーススタディは個別ページ
- 両方の良いところ取り

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

[あなたの名前]
[あなたの仕事内容を一行で]
[あなたを差別化する一行]
[CTA: 作品を見る / お問い合わせ]

プロジェクトショーケース

作品を効果的に見せる方法

使用タイミング: プロジェクトセクションを構築する際

プロジェクトショーケース

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

要素目的
サムネイル視覚的なフック
タイトル作品名
一言あなたの貢献
技術/タグ素早く把握
結果インパクトの証明

ケーススタディの構造

1. ヒーロー画像/動画
2. プロジェクト概要(2〜3文)
3. 課題
4. あなたの役割
5. プロセスのハイライト
6. 主要な決定
7. 結果/インパクト
8. 学び(オプション)
9. リンク(ライブ、GitHubなど)

インパクトの示し方

代わりに書く内容
「ウェブサイトを構築」「コンバージョン率を40%向上」
「UIをデザイン」「ユーザー離脱率を25%削減」
「機能を開発」「5万人のユーザーにリリース」

ビジュアルプレゼンテーション

  • Web/モバイルのデバイスモックアップ
  • ビフォー/アフター比較
  • プロセス成果物(ワイヤーフレームなど)
  • 複雑な作業の動画ウォークスルー
  • エンゲージメントのためのホバーエフェクト

開発者ポートフォリオの詳細

開発者ポートフォリオに効果的な方法

使用タイミング: 開発者ポートフォリオを構築する際

開発者ポートフォリオ

採用担当者が求めるもの

  1. コードの品質(GitHubリンク)
  2. 実際のプロジェクト(チュートリアルではない)
  3. 問題解決能力
  4. コミュニケーションスキル
  5. 技術の深さ

必須項目

  • GitHubプロフィールリンク(整理済み)
  • ライブプロジェクトリンク
  • 各プロジェクトの技術スタック
  • チームプロジェクトにおけるあなたの具体的な貢献

プロジェクトの選択

含める避ける
実際の問題を解決したものチュートリアルのクローン
ユーザーがいるサイドプロジェクト未完成のプロジェクト
オープンソース貢献「近日公開」
技術的課題基本的なCRUDアプリ

テクニカルショーケース

// 以下を示すコードスニペット:
// - クリーンなアーキテクチャの決定
// - パフォーマンス最適化
// - 巧妙な解決策
// - テストアプローチ

ブログ/執筆

  • 技術的な深掘り
  • 問題解決のストーリー
  • 学習の旅路
  • コミュニケーションスキルを示す

ポートフォリオのインタラクティブ性

記憶に残るインタラクティブ要素を追加する方法

使用タイミング: 目立ちたい場合

ポートフォリオのインタラクティブ性

インタラクティブ性のレベル

レベル例リスク
微妙ホバーエフェクト、スムーズスクロール低
中程度スクロールアニメーション、トランジション中
高3D、ゲーム、カスタムカーソル高

高インパクト、低リスク

  • デスクトップのカスタムカーソル
  • スムーズなページトランジション
  • プロジェクトカードのホバーエフェクト
  • スクロールトリガーによる表示
  • ダーク/ライトモードトグル

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

- ターミナル風インターフェース(開発者向け)
- OSデスクトップメタファー
- ゲーム風ナビゲーション
- インタラクティブなタイムライン
- 3Dワークスペースシーン
- ジェネレーティブアート背景

バランス

  • 創造性はスキルを示す
  • しかしユーザビリティが仕事を勝ち取る
  • モバイルは完璧に動作する必要がある
  • インタラクションの背後にコンテンツを隠さない
  • 複雑なイントロには「スキップ」オプションを設ける

シャープエッジ

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

重大度: 中

状況: ポートフォリオに6ヶ月費やしたが、見せられるプロジェクトは2つだけ

症状:

  • 何ヶ月も「ポートフォリオに取り組んでいる」状態
  • プロジェクトよりもポートフォリオに興奮している
  • ポートフォリオの技術が仕事より印象的
  • 公開するのが怖い

なぜ問題か: 先延ばしが仕事を装っている。 ポートフォリオはプロジェクトの一つだが、主要プロジェクトではない。 磨き上げの限界効果。 公開して反復する。

推奨修正:

ポートフォリオの適正規模化

MVPポートフォリオ

要素MVP版
ヒーロー名前+肩書き+一行
プロジェクト3〜4のベスト作品
アバウト2〜3段落
コンタクトメール+LinkedIn

時間配分

1週目: 設計と構造
2週目: コアページの構築
3週目: 3〜4のプロジェクトを追加
4週目: 磨き上げと公開

真実

  • ポートフォリオはあなたの最高のプロジェクトではない
  • 完璧よりも公開が重要
  • いつでも反復できる
  • より良いプロジェクト > より良いポートフォリオ

終了のタイミング

  • コアページがモバイルで動作する
  • 3〜4の優れたプロジェクトを公開している
  • お問い合わせフォームが機能する
  • 3秒未満で読み込める
  • 公開する。

デスクトップでは美しいがモバイルで壊れる

重大度: 高

状況: 採用担当者がスマホで確認すると、全てが崩れる

症状:

  • ブラウザのDevToolsでは美しく見える
  • 実際のスマホでは壊れている
  • テキストが小さすぎる
  • ボタンがタップしにくい
  • ナビゲーションが隠れている

なぜ問題か: デスクトップファーストで構築した。 実際のデバイスでテストしなかった。 複雑なインタラクションが反映されない。 親指ゾーンを忘れていた。

推奨修正:

モバイルファーストポートフォリオ

モバイルの現実

  • トラフィックの60%以上はモバイル
  • 採用担当者はスマホで閲覧する
  • 第一印象 = モバイルでの印象

モバイルの必須事項

  • ズームしなくても読める
  • タップ可能なリンク(最低44px)
  • ナビゲーションが動作する
  • プロジェクトが高速に読み込める
  • 連絡先がすぐに見つかる

テストチェックリスト

[ ] iPhone Safari
[ ] Android Chrome
[ ] タブレットサイズ
[ ] 低速3Gシミュレーション
[ ] 実際のデバイス(DevToolsだけではない)

グレースフルデグラデーション

/* 複雑なホバー → シンプルなタップ */
@media (hover: none) {
  .hover-effect {
    /* コンテンツを直接表示 */
  }
}

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

重大度: 中

状況: 素晴らしいポートフォリオだが、問い合わせがゼロ

症状:

  • 閲覧数は多いが、問い合わせなし
  • あなたが利用可能であることを人々が知らない
  • お問い合わせページが後回しにされている
  • 明確な依頼がない

なぜ問題か: 明確なCTAがない。 連絡先が最下部に埋もれている。 複数の競合するアクション。 訪問者が自ら理解すると想定している。

推奨修正:

ポートフォリオのCTA

プライマリCTA

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

CTA配置

ヒーローセクション: メインCTA
プロジェクト後: セカンダリCTA
フッター: 最終CTA
フローティング: オプションの常駐CTA

連絡を容易にする

  • メールリンク (mailto:)
  • LinkedIn(新しいタブで開く)
  • カレンダーリンク(Calendly)
  • シンプルなお問い合わせフォーム
  • メールアドレスコピーボタン

避けるべきこと

  • お問い合わせフォームのみ(人々はフォームを嫌う)
  • 連絡先情報を隠す
  • 選択肢が多すぎる
  • 曖昧なCTA(「もっと詳しく」)

ポートフォリオに古いまたは無関係な作品が掲載されている

重大度: 中

状況: 最高の作品は3年前、新しい作品が掲載されていない

症状:

  • 2024年にjQueryプロジェクト
  • 「大学時代に作りました」
  • 技術スタックがターゲットの仕事と合わない
  • 2年以上ポートフォリオを触っていない

なぜ問題か: 何年も更新していない。 新しい作品は「準備ができていない」。 古いお気に入りを削除するのが怖い。 ポートフォリオのドリフト。

推奨修正:

ポートフォリオの鮮度維持

更新頻度

アクション頻度
新しいプロジェクトを追加完了時
古いプロジェクトを削除年次レビュー
コピーを更新6ヶ月ごと
技術リフレッシュ1〜2年ごと

プロジェクトの選別

以下に該当する場合は維持:

  • 今でも誇りに思える
  • ターゲットの仕事に関連性がある
  • 重要なスキルを示している
  • 良い結果/ストーリーがある

以下に該当する場合は削除:

  • コード/デザインに恥ずかしさを感じる
  • 技術が陳腐化している
  • 目標に関連性がない
  • より良い作品が存在する

成長を示す

  • 最新の作品を先頭に
  • プロジェクトに日付を付ける(または付けない)
  • 関連性があれば進化を見せる
  • 削除する代わりにアーカイブする

バリデーションチェック

明確なコンタクトCTAがない

重大度: 高

メッセージ: 訪問者があなたに連絡する明確な方法がない。

修正アクション: ヒーローとプロジェクトセクションの後に目立つコンタクトCTAを追加する

モバイルビューポートがない

重大度: 高

メッセージ: ポートフォリオがモバイル対応でない可能性がある。

修正アクション: を追加する

最適化されていないポートフォリオ画像

重大度: 中

メッセージ: ポートフォリオの画像が読み込み時間を遅くしている可能性がある。

修正アクション: WebPを使用し、遅延読み込みを実装し、レスポンシブ画像用にsrcsetを追加する

プロジェクトにライブリンクがない

重大度: 中

メッセージ: プロジェクトにはライブリンクまたはソースコードが必要。

修正アクション: 可能な限りライブデモURLとGitHubリンクを追加する

プロジェクトにインパクト/結果が示されていない

重大度: 低

メッセージ: プロジェクトにインパクトや結果が示されていない。

修正アクション: プロジェクトの説明に指標、成果、または推薦文を追加する

コラボレーション

委任トリガー

  • スクロールアニメーション|パララックス|GSAP -> scroll-experience (ポートフォリオのスクロール体験)
  • 3D|WebGL|three.js|spline -> 3d-web-experience (3Dポートフォリオ要素)
  • ブランド|ロゴ|カラー|アイデンティティ -> branding (パーソナルブランディング)
  • コピー|ライティング|アバウトミー|バイオ -> copywriting (ポートフォリオコピー)
  • SEO|検索|Google -> seo (ポートフォリオSEO)

開発者ポートフォリオ

スキル: interactive-portfolio, frontend, scroll-experience

ワークフロー:

1. ポートフォリオ構造を計画
2. 3〜5のベストプロジェクトを選択
3. ヒーローとプロジェクトセクションをデザイン
4. 微妙なスクロールアニメーションを追加
5. 実装と最適化
6. 公開とシェア

クリエイティブポートフォリオ

スキル: interactive-portfolio, 3d-web-experience, scroll-experience, branding

ワークフロー:

1. パーソナルブランドを定義
2. ユニークな体験をデザイン
3. インタラクティブ要素を構築
4. 作品をクリエイティブに見せる
5. モバイルで動作することを確認
6. 公開

関連スキル

scroll-experience, 3d-web-experience, landing-page-design, personal-branding との連携が効果的

使用タイミング

  • ユーザーが言及または示唆: ポートフォリオ
  • ユーザーが言及または示唆: パーソナルウェブサイト
  • ユーザーが言及または示唆: 作品の公開
  • ユーザーが言及または示唆: 開発者ポートフォリオ
  • ユーザーが言及または示唆: デザイナーポートフォリオ
  • ユーザーが言及または示唆: クリエイティブポートフォリオ

制限事項

  • このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用すること。
  • 出力を環境固有の検証、テスト、または専門家によるレビューの代用として扱わないこと。
  • 必要な入力、権限、安全境界、または成功基準が不足している場合は、立ち止まって確認を求めること。

Individual skills in this repo

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

関連スキル