Communitygithub.com

MMEHDI0606/ai-agent-foundation-template

仕事やクライアント獲得に実際に役立つポートフォリオ作成のエキスパート。作品を表示するだけでなく、記憶に残る体験を創り出します。開発者、デザイナー、クリエイティブ向けポートフォリオ、そして訪問者を機会に変えるポートフォリオをカバーします。

ai-agent-foundation-template とは?

このスキルは、単なる作品集ではなく、訪問者を実際の仕事やクライアント獲得へと導く「印象に残る体験」としてのポートフォリオを構築するための包括的なガイドです。対象は開発者、デザイナー、クリエイティブ職で、採用担当者が30秒で判断することを前提に、その短い時間で最大の効果を生み出すUX設計を指導します。具体的には、ポートフォリオ設計のMVP構成、プロジェクトの効果的な見せ方(インパクトを数字で示す方法)、開発者向けのテクニカルショーケース、インタラクティブ要素の追加、そしてモバイル対応や明確な行動喚起(CTA)といった実践的なノウハウを提供します。このスキルはClaude CodeのようなAIエージェントで使用することを想定しており、Scroll Experienceや3D Web Experienceなどの関連スキルと連携して、カスタマイズ可能なポートフォリオ作成を支援します。ユーザーがポートフォリオや個人ウェブサイト作成をほのめかした際に自動的にトリガーされ、プロジェクトごとに適切な技術スタックやワークフローを提案します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/MMEHDI0606/ai-agent-foundation-template/tree/HEAD/.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万人のユーザーにリリースした」

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

  • ウェブ/モバイルのデバイスモックアップ
  • 改善前/改善後の比較
  • プロセスアーティファクト(ワイヤーフレームなど)
  • 複雑な作業のための動画ウォークスルー
  • エンゲージメントのためのホバーエフェクト

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

開発者ポートフォリオに効果的なもの

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

開発者ポートフォリオ

採用担当者が求めるもの

  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
雇用される「一緒に働きましょう」
フリーランス「プロジェクトを始めましょう」
ネットワーキング「ご連絡ください」
特定の役割「[職種名]で私を雇ってください」

CTAの配置

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

お問い合わせを簡単に

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

避けるべきこと

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

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

重大度: 中

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

兆候:

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

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

推奨修正:

ポートフォリオの新しさ維持

更新頻度

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

プロジェクトの取捨選択

残すべきもの:

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

削除すべきもの:

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

成長を示す

  • 最新の作品を最初に
  • プロジェクトに日付を付ける(または付けない)
  • 関連があれば進化を示す
  • 削除ではなくアーカイブ

バリデーションチェック

明確なお問い合わせCTAがない

重大度: 高

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

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

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

重大度: 高

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

修正アクション: <meta name='viewport' content='width=device-width, initial-scale=1'> を追加する

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

重大度: 中

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

修正アクション: 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.

関連スキル