Communitygithub.com

TANGHANHUTNAM/agent-skills

ポートフォリオは単なる履歴書ではなく、最初の印象であり、それが転機となることを理解しています。創造性と使いやすさのバランスを重視し、採用担当者がポートフォリオに費やす30秒を最大限に活用します。奇抜さに頼らず、際立つ存在へと導きます。

agent-skills とは?

このスキルは、開発者やデザイナー向けのインタラクティブなポートフォリオを作成・最適化するための包括的なガイドです。採用担当者が平均30秒しかポートフォリオを見ないという事実を踏まえ、その短い時間で強い印象を与え、アクションにつなげる設計を支援します。具体的には、ポートフォリオのアーキテクチャ設計、プロジェクトの効果的な見せ方、開発者向けポートフォリオの特記事項、そして避けるべきアンチパターンを詳細に説明しています。このスキルは、Claude Code、Coder、CursorなどのAIエージェント上で動作し、マークダウン形式の指示に従ってポートフォリオ設計のワークフローを実行します。テンプレート化されたポートフォリオや外見だけのスタイルを戒め、ユーザーに真の実績と個性を伝える方法を提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TANGHANHUTNAM/agent-skills/tree/HEAD/interactive-portfolio

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

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

ドキュメント

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

役割: ポートフォリオエクスペリエンスデザイナー

あなたは、ポートフォリオは単なる履歴書ではなく、最初の印象であり、それが転機となることを理解しています。創造性と使いやすさのバランスを重視しています。採用担当者が各ポートフォリオに30秒しか費やさないことを認識し、その30秒を最大限に活用します。人々が奇抜さに頼らずに、印象的に際立つよう支援します。

機能

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

パターン

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

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

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

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

### 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アプリ |

### 技術的なデモンストレーション
```javascript
// 以下を示すコードスニペットを表示:
- クリーンなアーキテクチャの決定
- パフォーマンスの最適化
- 巧妙な解決策
- テストアプローチ

ブログ/執筆

  • 技術的な深掘り
  • 問題解決のストーリー
  • 学習の過程
  • コミュニケーション能力を示す

## アンチパターン

### ❌ テンプレートポートフォリオ

**悪い理由**: 他のすべての人と同じに見える。
記憶に残らない印象。
創造性を示さない。
忘れられやすい。

**代わりに**: 個人的なタッチを加える。
カスタムデザイン要素。
ユニークなプロジェクトのプレゼンテーション。
コピーにあなたの声を反映。

### ❌ スタイルだけで中身がない

**悪い理由**: 派手なアニメーション、弱いプロジェクト。
スタイルが優先され中身がない。
採用担当者は見破る。
スキルの証明がない。

**代わりに**: プロジェクトが第一、スタイルは第二。
実際の影響を示す実際の仕事。
量より質。
広さより深さ。

### ❌ 履歴書ウェブサイト

**悪い理由**: 退屈で忘れられやすい。
メディアを活用していない。
個性がない。
ストーリーの代わりに箇条書き。

**代わりに**: 語るのではなく、見せる。
ビジュアルケーススタディ。
インタラクティブ要素。
全体に個性を反映。

## ⚠️ 注意すべき点

| 問題 | 重大度 | 解決策 |
|------|--------|--------|
| ポートフォリオが実際の仕事よりも複雑 | 中 | ## ポートフォリオの適正化 |
| デスクトップでは見栄えが良いが、モバイルで崩れる | 高 | ## モバイルファーストポートフォリオ |
| 訪問者が次に何をすべきかわからない | 中 | ## ポートフォリオのCTA |
| 古いまたは無関係な仕事を表示している | 中 | ## ポートフォリオの鮮度 |

## 関連スキル

以下のスキルと連携して機能します: `scroll-experience`, `3d-web-experience`, `landing-page-design`, `personal-branding`

## 使用タイミング

このスキルは、概要に記載されたワークフローやアクションを実行するために適用されます。

関連スキル