Communitygithub.com

portfolio-maker (ポートフォリオメーカー)

エンジニア、デザイナー、編集者、研究者、コンサルタント向けに、React アプリまたは単一HTMLファイルとして、プロダクション品質のポートフォリオを構築します。

portfolio-maker (ポートフォリオメーカー) とは?

このスキルは、個人のプロフェッショナルポートフォリオを完全自律的に生成するための、高度に専門化されたAIエージェントスキルです。主な目的は、5つの主要なアーキタイプ(ソフトウェアエンジニア、映像クリエイター、プロダクトデザイナー、AI/ML研究者、コンサルタント)向けに、アマチュア的で一般的な「AIスラッジ」を排除し、受賞歴のあるプロダクショングレードのポートフォリオを生成することです。このスキルは、デザインの美的判断、タイポグラフィの数学的ルール、空間調和、マイクロインタラクションの設計、コンポーネントのプリミティブをすべて内蔵しており、外部のデザインやアニメーションスキルに依存しません。動作モードは2つあり、デフォルトのReact + Vite + Tailwind(TypeScript)のコードベースを生成するモードと、セットアップ不要でブラウザで即座にプレビューできる単一HTMLファイルを生成するモードをサポートします。また、21st.devの公式shadcn MCPサーバー(無料、APIキー不要)を利用した11,750以上のコンポーネントカタログへのアクセス、厳格な美的ルール(アンチスラッジコード)、インタラクティブな調整プロセスを備えています。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/NaitikGrover/portfolio-maker/tree/HEAD

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

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

ドキュメント

ポートフォリオメーカー: ソブリン・デザイン&エンジニアリングスキル

ソブリン&自己完結型: このスキルは完全な自律性を持って動作します。外部のサードパーティ製デザインやアニメーションスキルに依存、委任、または要求することはありません。美的直感、タイポグラフィの数学、空間的調和、マイクロインタラクションのダイナミクス、アンチスラッジの実行、コンポーネントプリミティブはすべてこのスキルにネイティブに組み込まれています。


🎯 主要な目的とミッション

アマチュア的で一般的な「AIスラッジ」ポートフォリオを排除し、5つのコアアーキタイプにわたるあらゆるプロフェッショナル向けに、受賞歴のあるプロダクショングレードのポートフォリオを自律的に生成します。

  1. ソフトウェアエンジニア&システムアーキテクト(分散システム、高スループットAPI、クリーンなテクニカルBento)
  2. 映像編集者、モーショングラフィックス&クリエイター(バイラルショーリール、前後のカラーグレード比較、視聴回数指標)
  3. プロダクトデザイナー&UI/UXリーダー(デザインシステム、ケーススタディ、高コントラストスイスタイポグラフィ、トークン内訳)
  4. AI/ML研究者&データエンジニア(モデルアーキテクチャ、arXiv出版物、ベンチマークテレメトリ、ウェイトバッジ)
  5. エージェンシー、コンサルタント&ソロプレナー(社会的証明、クライアントレビュー、サービス階層、摩擦のない予約コンバージョン)

🚫 アンチAIスラッジ・コード・オブ・オナー(厳格な執行)

生成されるすべてのポートフォリオは、コードを出力する前にこの厳格な美的フィルターを通過しなければなりません。

1. 禁止されるビジュアルスラッジ:

  • ❌ 決して紫/バイオレットのネオングラデーションの決まり文句を使わない: from-purple-500 via-indigo-500 to-pink-500 の見出しテキストは禁止。ぼやけた紫の背景グローオーブ (bg-purple-500/10 blur-3xl) も禁止。
  • ❌ 平坦で退屈なグレーのグリッドボックスは禁止: デフォルトのTailwind bg-gray-100 / border-gray-300 ブロックで、奥行きやテクスチャがゼロのものは避ける。
  • ❌ 過飽和なレーザーボーダーは禁止: 高強度のシンセウェイブネオンストロークは避ける。

2. 承認されたエリートカラーパレット:

  • チタンモノクローム(スイスダーク/ライト): 深い黒曜石キャンバス (#09090b)、浮き上がったカードレイヤー (#121215 に backdrop-blur-md)、ヘアラインボーダー (border-white/[0.08])、鮮明な白の見出し (#ffffff)、亜鉛のミュートテキスト (#a1a1aa)、微妙なスレート/白のスポットライト (rgba(255,255,255,0.06))。
  • プレシジョンエメラルド&スレート: 黒曜石キャンバス (#09090b)、エメラルドのライブステータスインジケーター (#10b981)、モノクロームカードに微妙なミントホバーアクセント。
  • インターナショナルエレクトリックコバルト: 濃いチャコールキャンバス (#0a0a0f)、鮮明な白のタイポグラフィ、高コントラストのエレクトリックロイヤルブルー (#2563eb) のインタラクションターゲットとボタン。
  • ウォームアーキテクチュラルサンド&エスプレッソ: 暖かいクリームキャンバス (#fafaf9)、リッチなエスプレッソ見出し (#18181b)、微妙なシャンパン/アンバー (#d97706) のアクセント。
  • シネマティックローズ&アンバー: 黒曜石 #0b0c10 キャンバス、インパクトのあるローズ (#e11d48) と暖かいアンバー (#f59e0b) のアクセント。クリエイティブや動画ショーリールに。

3. 禁止されるAIのフラフコピー:

  • ❌ 禁止: 「アイデアをエレガントなデジタルソリューションに変える情熱的な開発者。」
  • ❌ 禁止: 「デザイン、テクノロジー、共感の交差点でイノベーションを起こす。」
  • ❌ 禁止: 「問題解決に長けた結果志向のプロフェッショナル。」
  • ✅ 必須: 具体的で、メトリックに基づき、インパクトに焦点を当てた記述:
    • 「120k req/s、14ms p99レイテンシを処理する分散Goマイクロサービスを構築。」
    • 「7500万以上のオーガニックビューを生み出すバイラル長尺YouTubeドキュメンタリーを編集。」
    • 「42のエンジニアリングチームで採用されたマルチブランドFigmaデザイントークンシステムを主導。」

🧠 ネイティブ美的エンジン(組み込みデザインインテリジェンス)

AIは、すべての要素にこれらの数学的デザイン法則を適用しなければなりません。

1. タイポグラフィ階層と光学的リズム

  • ディスプレイ見出し (text-4xl から text-6xl md:text-7xl)
    • 行の高さはタイトに (leading-[1.08] から leading-[1.12])。大きなフォントでのゆるい行間はアマチュア的に見える。
    • 文字間隔は圧縮する (tracking-tight または tracking-tighter)。
    • フォントウェイト: テクニカル向けはボールドまたはエクストラボールド (font-bold / font-extrabold); エディトリアルセリフ向けはミディアムまたはセミボールド (font-medium / font-semibold)。
  • ボディコピー (text-base から text-lg)
    • 行の高さは十分に (leading-relaxed または leading-7) 読みやすさを確保。
    • 行長(メジャー): 本文のテキスト幅を max-w-xl または max-w-2xl (1行あたり45~75文字) に制限する。段落を画面幅いっぱいに引き伸ばしてはいけない。
    • テキストの配置: 本文テキストを3行以上連続して中央揃えにしてはいけない。 人間の読みやすさのために左揃えに。
  • キュレーションされたフォントペアリング:
    • モダンテック: Inter または Geist Sans + タグとコード用の JetBrains Mono。
    • ハイインパクトクリエイティブ: Plus Jakarta Sans または Syne + Inter。
    • エディトリアル&ラグジュアリー: Cormorant Garamond (セリフディスプレイ) + Inter (サンズボディ)。

2. 空間リズムと8pt数学的グリッド

  • セクションパディング: 十分な垂直方向の余白 (py-20 md:py-28)。タイトなセクションはデザインを窮屈にする。
  • レイアウトスタック: 主要セクション間の垂直スペースは space-y-24 または space-y-28 を使用する。
  • カードグリッド: gap-6 または gap-8 に統一する。
  • コンテンツ幅のコンテナ:
    • エディトリアル / ミニマリスト: max-w-4xl mx-auto px-6
    • デベロッパーBento: max-w-5xl mx-auto px-4 sm:px-6
    • メディアショーリール: max-w-6xl mx-auto px-4 sm:px-6

3. サーフェスエレベーションとヘアラインボーダーの科学

  • レイヤー0 (キャンバス): #09090b (ダーク) / #fafaf9 または #ffffff (ライト)。
  • レイヤー1 (カードベース): #121215 / bg-white dark:bg-zinc-900/60 に backdrop-blur-md。
  • レイヤー2 (ヘアラインボーダー): border border-zinc-200/80 dark:border-zinc-800/80 または border border-white/[0.08]。重くて濁ったドロップシャドウは絶対に使用しない。
  • レイヤー3 (マイクロホバー): カーソル追従型ラジアルスポットライト (rgba(255,255,255,0.06))、または微妙なボーダーブライトン hover:border-zinc-400 dark:hover:border-zinc-700、さらに微妙な浮き上がり hover:-translate-y-0.5 transition-all duration-300。

4. インタラクティブな詳細とポリッシュ

  • ライブステータスインジケーター:
    <div class="inline-flex items-center gap-2 px-3 py-1.5 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border border-emerald-500/20">
      <span class="w-2 h-2 rounded-full bg-emerald-500 animate-pulse"></span>
      <span>2026年第1四半期の機会に対応可能</span>
    </div>
    
  • ワンクリックコピーメールピル(視覚的フィードバック付き): インスタントクリップボードコピーと「Copied!」を確認するツールチップトランジションを提供。
  • デュアルモードテーマスイッチャー: アイコンモーフィングと localStorage による永続化を備えた、動作するテーマトグル(ダーク/ライト)を常に含める。

📦 検証済みコンポーネントアーセナル(直接アクセス)

このスキルには、検証済みのプロダクション対応TSXプリミティブと完全なカタログが含まれています。

1. シグネチャーヒーロー (components-library/heroes/):

  • ImageStreamHero.tsx: 奥行きのある消失点ストリーミングレール(クリエイター&映像編集者向け)。
  • PerspectiveTunnelHero.tsx: 3D Z軸空間パースペクティブとライブメトリクス(エンジニア&アーキテクト向け)。
  • ProductRailGallery.tsx: スイング物理演算を備えたインタラクティブな衣類ラック(Eコマース&ファッション向け)。
  • TiltedGridHero.tsx: 視聴者に向かって曲がる湾曲3D画像ストリーム(UI/UXデザイナー&フォトグラファー向け)。
  • PrismHero.tsx: 色彩的な結晶屈折シェーダー美学(アートディレクター&ラグジュアリーポートフォリオ向け)。
  • TigerTearRevealHero.tsx: インタラクティブな涙のリビールスローガンエフェクト(ハイインパクトクリエイティブ向け)。
  • AgencyHero01.tsx: ソーシャルアバターと評価バッジを備えた高信頼エージェンシーヒーロー(フリーランサー&エージェンシー向け)。
  • ResponsiveHeroBanner.tsx: グラスモーフィックナビゲーションを備えたシネマティックバナー(創業者&リーダー向け)。
  • CenteredImageFanHero.tsx: ハイライトされた見出しと3枚の画像ファンコラージュ(プロダクトデザイナー向け)。

2. スタンドアロンインタラクティブプリミティブ (components-library/):

  • 背景: backgrounds/AuroraBackground.tsx (微妙なエメラルド/シアン/スレートの波、ネオンパープルはなし)。
  • インタラクティブカード: cards/SpotlightCard.tsx (マウストラッキンググロー)、cards/Card3D.tsx (パースペクティブチルト)、cards/BorderBeam.tsx (アニメーションヘアラインボーダービーム)、cards/Meteors.tsx (流れ星パーティクル)。
  • セクション&レイアウト: sections/BentoGrid.tsx (非対称レスポンシブグリッド)、sections/InfiniteMarquee.tsx (シームレスなテック/ロゴティッカー)、sections/BeforeAfterSlider.tsx (インタラクティブ画像/動画比較)、sections/VideoModal.tsx (シネマティック動画ポップアップ)、sections/TerminalWidget.tsx (シミュレートされたインタラクティブCLI)。
  • UIコントロール: ui/FloatingNav.tsx (浮遊グラスモーフィックピルナビバー)、ui/ShimmerButton.tsx (きらめくアクションボタン)、ui/TextGenerateEffect.tsx (ずらした単語の表示)、ui/CopyEmailButton.tsx (ワンクリックコピーピル)、ui/ThemeToggle.tsx (ダーク/ライトテーマトグル)。

3. マスターコンポーネントインデックス:

  • 完全な21st.devマスターカタログは、components-library/catalog/INDEX.md にあります。22カテゴリ(ボタン、ヒーロー、ギャラリー、機能、価格、フッター、FAQなど)にわたる11,750以上のカテゴリ別コンポーネントが含まれています。

4. 公式shadcn MCPサーバー(ゼロAPIキー):

  • AIは公式shadcn MCPサーバー (npx shadcn@latest mcp) を使用します。これは100%無料、オープンソースで、APIキーは一切不要です。
  • カタログの任意のコンポーネントは、以下でインストールできます:
    npx shadcn@latest add "https://21st.dev/r/<author>/<component-name>"
    
  • 有料の21st.dev MCPやAPIキーは決して必要ありません。

5. プレミアムテンプレート&モーションデザインのインスピレーション:

AIは、世界で最もプレミアムなデザインエコシステムから、アーキテクチャパターン、キネティックモーション、高コンバージョンレイアウトを積極的に引き出すことができます。

  • VibeUI (vibeui.dev): モダンなコンポーネント構成、触感的なカードスタック、インタラクティブバッジ、フローティングコントロールピル、美的レイアウトプリミティブ。
  • Trical (trical.so): ウルトラクリーンで高コンバージョンのポートフォリオテンプレート、マガジングレードのタイポグラフィ、微妙な区切り線、エディトリアルプロジェクトのケーススタディ。
  • Motion Site (motion.site.ai): 流動的なマイクロアニメーション、キネティックな見出しのリビール、スプリング物理演算、有機的なトランジションカーブ。
  • 21st.dev & Aceternity UI: 11,750以上のshadcn互換コンポーネントと空間3Dインタラクションプリミティブのマスターカタログ。

⚡ デュアルデリバリーモード

AIは、ユーザーのニーズに応じて2つの柔軟な配信フォーマットをサポートします。

モードA: 完全なReact + Vite + Tailwind (TypeScript) コードベース(デフォルト)

完全でモジュール化されたエンタープライズグレードのプロジェクト構造を生成します:

my-portfolio/
├── package.json
├── vite.config.ts
├── tailwind.config.js
├── postcss.config.js
├── tsconfig.json
├── index.html
└── src/
    ├── main.tsx
    ├── App.tsx
    ├── index.css
    ├── components/
    │   ├── ui/ (Spotlight, ThemeToggle, CopyEmailButton, FloatingNav)
    │   └── sections/ (Hero, BentoGrid, Projects, Experience, Footer)
    └── types/index.ts

モードB: インスタントスタンドアロン単一ファイルHTML/Tailwind/Lucide/JS

ユーザーがゼロセットアップ、即座のローカルブラウザプレビュー、またはインスタントホスティング(例: GitHub Pages)を希望する場合:

  • 単一の、美しくフォーマットされた、自己完結型の index.html を生成します。
  • Tailwind CSS CDN、Google Fonts、Lucide Icons CDN、およびテーマトグル、コピーフィードバック、モーダルポップアップ、ホバーインタラクション用のバニラJSが含まれます。
  • プロダクションリファレンス実装については、templates/developer-bento/index.html、templates/creative-minimalist/index.html、templates/video-editor-showreel/index.html を参照してください。

🛠️ ステップバイステップ実行ワークフロー

┌────────────────────────────────────────────────────────┐
│  ステップ1: インテーク&レジュメ抽出                   │
│  メトリクス、役割、プロジェクト、テクノロジースタックを抽出 │
│  (または3バッチフォールバック質問を実行)               │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  ステップ2: 必須の対話型調整                           │
│  質問: 美学、テーマモード、ヒーロー&コンポーネントの選択 │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  ステップ3: コンポーネント選択とアーキテクチャ          │
│  components-library/ から21st.devプリミティブをアセンブル  │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  ステップ4: プロダクションコード生成                   │
│  React + Vite (デフォルト) またはスタンドアロンHTMLを生成│
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  ステップ5: 監査と実行手順                             │
│  アンチスラッジルールを確認、ビルドを検証、コマンドを提供 │
└────────────────────────────────────────────────────────┘

ステップ1: インテークプロトコル

  1. ユーザーが履歴書またはLinkedInの要約を提供した場合: 実際のメトリクス、キャリアタイムライン、トップ3~4のプロジェクト、および技術的コンピテンシーを解析します。
  2. 履歴書が提供されなかった場合: 決して資格情報をでっち上げてはいけません。references/questionnaire.md から3バッチ質問を実行します:
    • バッチ1: アイデンティティとターゲットの役割
    • バッチ2: トップ2~3のプロジェクトと具体的な数値
    • バッチ3: ソーシャルと連絡先リンク

ステップ2: 必須の対話型調整(スキップ禁止)

ユーザーが事前にビジュアルスタイルとコンポーネントを明示的に指定していない限り、一時停止して対話型調整を提示します:

「ポートフォリオを生成する前に、ビジュアルデザインとインタラクティブコンポーネントをカスタマイズしましょう。

  1. ビジュアルスタイル / 美学:
    • シークテック / ダークBento (Linear / 21st.devスタイル — 黒曜石キャンバス、スポットライトホバーカード、ヘアラインボーダー)。
    • クリーンミニマリスト / スイスモダン (Dieter Rams / Appleスタイル — 十分な余白、洗練されたタイポグラフィ、繊細な線)。
    • 高コントラストエディトリアル (セリフ見出し、スタジオ美学、マガジンスタイルのケーススタディ)。
    • シネマティッククリエイター / モーション (深いダークキャンバス、リッチなビデオショーリール埋め込み、視聴回数バッジ)。
    • ネオブルータリズム (大胆な色、タイポグラフィ、グリッド、生のデジタル美学)。
  2. テーマモード:
    • ダークモード (デフォルト、目に優しく没入感がある)
    • ライトモード (クリーンで印刷物に近い)
    • デュアルモード (ユーザーが切り替え可能なテーマトグルを実装)
  3. ヒーローセクション:
    • 画像ファンコラージュ (CenteredImageFanHero)
    • パースペクティブトンネル3D (PerspectiveTunnelHero)
    • インタラクティブティアリビール (TigerTearRevealHero)
    • エージェンシーソーシャルプルーフ (AgencyHero01)
    • プロダクトレールギャラリー (ProductRailGallery)
  4. インタラクティブコンポーネント:
    • お問い合わせセクション (メール + 連絡先フォーム + コピーピル)
    • プロジェクトグリッド (BentoGrid + SpotlightCards)
    • スキル / ツールクラウド (テクノロジーバッジ + アニメーションマーキー)
    • 体験タイムライン (インタラクティブな垂直タイムライン)
    • 動的画廊 (BeforeAfterSlider, VideoModal)*」

ステップ3: コンポーネント選択とアーキテクチャ

ユーザーの選択を確認したら、コンポーネントアーセナルから適切なプリミティブをアセンブルします。

  1. 選択の確認: ユーザーの選択を簡潔に要約します(例: 「素晴らしい選択です!では、スイスモダン美学でダークモード、CenteredImageFanHero、BentoGridプロジェクトグリッド、FloatingNavを設定します。」)
  2. アーキテクチャの決定:
    • デフォルトのモードA(React + Viteコードベース)または
    • ユーザーが望む場合はモードB(スタンドアロンHTML)
  3. セクションの構成:
    • 値の高いプロジェクト上位3~4件に焦点を当てます(すべてを羅列しない)。
    • 定量的な成果とテクノロジースタックバッジを含めます。
    • それぞれの専門的アーキタイプに合わせてセクションを調整します(例: 研究者向け出版物セクション、クリエイター向けショーリール、エンジニア向けベンチマークなど)。

ステップ4: プロダクションコード生成

  1. ファイルの作成:
    • モードAの場合: src/components/ui/ と src/components/sections/ の下にすべての必要なファイルを生成します。
    • モードBの場合: 完全なスタンドアロン index.html を生成します。
  2. 必須の実装: 常に以下のものを含めます:
    • テーマトグルコンポーネント(localStorage による永続化)
    • ワンクリックコピーメール機能(確認ツールチップ付き)
    • ライブステータスインジケーター(利用可能性を示す)
    • レスポンシブナビゲーション(モバイルハンバーガーメニュー)
    • フッター(ソーシャルリンクとコピーライト)
  3. アンチスラッジコードの通過:
    • 出力の前に、以下のチェックリストに対してコードをチェックします:
      • 紫色のネオングラデーションがないか?
      • 平坦なグレーの背景がないか?
      • ぼやけたグローオーブがないか?
      • すべてのコピーは具体的でメトリックに基づいているか?
      • タイポグラフィは設計法則に従っているか?
      • 全文幅の段落がないか?(すべて max-w-xl / max-w-2xl を使用)
      • 3行以上連続した中央揃えの本文がないか?
      • 見出しの行の高さはタイトか?
      • ヘアラインボーダーと適切なレイヤリングが使用されているか?
      • インタラクティブ要素が含まれているか?(テーマトグル、コピーメール)

ステップ5: 監査と実行手順

コンポーネントを実装したら、以下の手順を実行します:

  1. ビルドの検証:
    cd my-portfolio
    npm run build
    
    エラーを確認します。
  2. 実行手順を提供:
    cd my-portfolio
    npm install
    npm run dev
    
  3. レポート: カスタマイズされたポートフォリオを生成したことを明確に要約します。選択された美学、含まれるセクション、プロフェッショナルアーキタイプに合わせてどのように調整したかを言及します。

🌱 依存関係と環境

モードA(Reactコードベース)の依存関係:

{
  "dependencies": {
    "react": "^19.0.0",
    "react-dom": "^19.0.0",
    "next": "^15.0.0",
    "framer-motion": "^11.0.0",
    "lucide-react": "^0.400.0",
    "@types/react": "^19.0.0",
    "@types/react-dom": "^19.0.0",
    "autoprefixer": "^10.0.0",
    "postcss": "^8.0.0",
    "tailwindcss": "^3.4.0",
    "typescript": "^5.6.0"
  }
}

モードB(スタンドアロンHTML)の依存関係:

  • Tailwind CSS (CDN): <script src="https://cdn.tailwindcss.com"></script>
  • Google Fonts (CDN): 選択したフォントファミリーの <link> タグ
  • Lucide Icons (CDN): <script src="https://unpkg.com/lucide@latest"></script>
  • 追加のCDNやビルドツールは不要

📂 リファレンスドキュメント

関連スキル