Communitygithub.com

ポートフォリオビルド

デザイナーのポートフォリオサイトを、1つのコンテンツファイルと3つの実績あるページグリッドから30秒で理解できるように構築または再構築します。

ポートフォリオビルド とは?

このスキルは、デザイナーやクリエイター向けに、訪問者が最初の30秒で「誰が、何をしているか」を即座に理解できるポートフォリオサイトを生成します。ユーザーが提供する1つのJSONファイル(`portfolio.json`)に、人物情報、プロジェクト、選択したグリッド、見た目の設定をすべて記述し、Pythonスクリプトを実行するだけで静的なHTML/CSSサイトが出力されます。フレームワークや追加インストールは不要で、ビルド後に自動で監査ルール(17項目)と未入力スロットがリストとして表示されるため、改善すべき点が明確になります。対応プラットフォームはClaude Code、Cursor、Codexなど、任意のAIエージェント環境で動作します(Pythonが利用可能な環境)。3種類のグリッド(固定プロフィール+全幅作品、2カラム、長尺ケーススタディ)から選択でき、ルック&フィールはテーマブロックで自由にカスタマイズ可能なため、構造と見た目を分離した設計が特徴です。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/adrituyo/30s/tree/main/skills/portfolio-build

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

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

ドキュメント

ポートフォリオビルド は何をしますか?

ポートフォリオは初回訪問時に約30秒しか注目されません。このスキルはその30秒を有効に使うポートフォリオを構築します。最初の画面に「あなたが誰で、何をしているか」、その横に実際の作品、各プロジェクトにおけるあなたの役割、そして連絡先への明確な方法を1つ配置します。

構造を修正し、見た目は本人に委ねます。3つのグリッドが「何をどこに、どの順序で配置するか」を決定します。書体、色、角丸、余白は本人のもので、1つの小さなブロックで設定します。このスキルで作られた2つのポートフォリオは同じように読み取れ、見た目はまったく異なるものになります。

以下のパスはこのスキルのフォルダを基準とします。

仕組み

1つのファイル portfolio.json にすべてが格納されます。人物情報、プロジェクト、選択したグリッド、見た目です。1つのコマンドで静的なサイト(プレーンなHTMLとCSS、フレームワークなし、インストール不要)に変換されます。

python3 scripts/build.py path/to/their-site/portfolio.json

サイトはコンテンツファイルの隣に書き出されます。スクリプトは次に2つのリストを出力します。30秒監査で依然として指摘される項目(各行がルール番号に対応、references/rules.md に17個のルールが1行ずつ記載)、およびまだ事実が入力されていない各 [スロット] です。両方をTODOリストとして扱ってください。

手順

1. ポートフォリオの目的を把握する

以下を質問するか、与えられた情報から推測してください。

  • ターゲット: 対象とする役割やクライアント。見出し、順序、省略する内容を決定します。
  • 作品: どのプロジェクトか、それぞれについて:内容、自分の担当部分、誰のためのものか、年、自分が決断したこと1つ、その結果。
  • 素材: 画像と動画がどこにあるか。

既存のサイトがある場合は、まずそれを読み、そこにあるものを引き継いでください。portfolio-audit スキルが利用可能で、公開サイトがある場合は、先にそれを実行すると何を変更すべきか正確にわかります。

自分で見つけられないことだけを質問してください。画像フォルダとLinkedInページを持っている人からは、ほとんどの情報が既に得られています。回答者がいない場合は、手持ちの情報で進め、スロットを使用してください(手順3)。

本人が迷っている素材(スケッチブック、学生プロジェクト、古い作品)は除外します。迷う理由があるからです。ポートフォリオは最も弱い作品で評価されます。除外した理由を説明してください。3つの強いプロジェクトで完全なポートフォリオになります。4つに水増しする必要はありません。

2. 本人にグリッドを選んでもらう

references/grids.md を読んでください。3つのグリッドとそれぞれが誰に適しているかが説明されています。グリッドはサイト全体の読みやすさを決めるため、本人の選択であり、あなたの選択ではありません。あなたの役割は、選択を容易にすることです。

構築前に、3つのグリッドをそれぞれ1行で簡潔に説明し、あなたのおすすめとその理由を述べ、どれを希望するか尋ねてください。手順1で尋ねる必要がある他の質問と一緒にまとめ、質問は1ラウンドで済ませてください。

  • 既にグリッドが指定されている場合は、それを使用し、質問を再開しないでください。
  • あなたのおすすめと異なるグリッドを選んだ場合は、そのグリッドで構築してください。重要な場合(例:index には決定と結果を記載する場所がない)は、一度だけそのデメリットを伝え、その後は触れないでください。
  • 本人が迷っている場合、または回答者がいない場合は、あなたのおすすめで進め、手順5で --compare 付きで構築し、3つすべてを並べて開けるようにしてください。

後で切り替えるのはファイル内の1単語を変更するだけなので、誰も縛られることはありません。これは選択肢を軽く提案する理由であり、スキップする理由ではありません。

3. コンテンツファイルを作成する

assets/example/portfolio.json を出発点としてコピーし、references/content.md ですべてのフィールドを確認してください。サイトになるフォルダに配置し、画像もその隣に置いてください。例では case グリッドを使用しています。index と columns の場合、decision と result はオプションで、before/after 行はほとんど必要ありません。

最も重要な部分の書き方:

  • 見出し: 何を誰のために作っているかを一文で、事実を含めて。他の誰のサイトにも当てはまらないようにします。「フィンテックアプリのプロダクトデザイナー。8年の経験、直近ではLedgerの貯蓄フローのリードを担当。」というように。「マルチディシプリナリーなクリエイティブで、体験のクラフトに情熱を注いでいます」ではありません。
  • 証明: 見出しの直後に、最も強い名前や数字を3〜4つ。
  • 順序: ターゲットに最も合致するプロジェクトを最初に配置し、日付は問いません。4〜8プロジェクト。サイドの専門分野(アートディレクターの映像、プロダクトデザイナーのイラストなど)は、混ぜるよりも別のコンテンツファイルを持つ2つ目のサイトとして扱う方が良いでしょう。
  • 各プロジェクト: 1行の概要、役割、クライアント・雇用主・個人コンセプトのいずれか。プロダクトやリーダーシップ向けの場合は、決定と結果を追加します。
  • 役割: 応募先ではなく、現在の肩書きをそのまま。
  • 依頼方法: メールアドレスの上に、何について連絡してほしいかを一文で。
  • 言語: 対象読者の言語で書き、site.lang を設定します。テンプレート自体の単語(Index、Facts、Next…)は英語とスペイン語に対応します。それ以外の言語の場合は labels で設定してください。

本人から提供された事実、または既存のページにある事実のみを使用してください。自分で推測した事実(ファイル名から読み取ったクライアント名など)は使用しても構いませんが、推測であることを伝え、確認を取ってください。

事実が不明な場合は、角括弧でスロットを記述します([年]、[チーム規模]、[出荷されたもの])。スロットはそのままサイトに表示され、ビルド時にすべてリストアップされます。したがって:

  • 見出しにスロットを含めないでください。既知の情報から記述します。最初の文にスロットがあると、訪問者が最初に読むものになります。
  • フィールド全体が不明でオプションの場合(city、team、site.url)は、フィールド自体を省略してください。
  • 成果がない作品については、真実を述べてください:「2024年に出荷。数値は持ち合わせていません」、「コンセプトのみ、未ローンチ」。それが結果です。影響を空約束するのは避けてください。
  • スロットがあるサイトはドラフトです。引き継ぎ時にその旨を明確に伝えてください。

正直なギャップがあるポートフォリオは問題ありません。クライアントを捏造したポートフォリオは面接での問題になります。

4. 見た目を設定する

theme ブロックで:ライトまたはダーク、アクセントカラー1つ、書体、角丸、画像間の余白。本人にブランドや既存サイトがある場合は、そこから取得してください。何もない場合は、作品に合う書体とアクセントを選び、選んだ理由を伝えてください。例や他のデザイナーのサイトの見た目をコピーしないでください。

すべてのデバイスにない書体を使用する場合は、font_url で読み込む必要があります。font に名前だけを指定すると、ほとんどの訪問者にはシステムフォントがフォールバックとして使用されます。両方を指定するか、システムフォントのスタックを選択してください。

5. ビルド、確認、修正

ビルドを実行します。本人がグリッドを選択していない場合は、--compare を追加します。

python3 scripts/build.py path/to/their-site/portfolio.json --compare

これにより、同じコンテンツが3つのグリッドすべてで compare/ フォルダに書き出され、それらをリンクするページも作成されます。本人にそのページを見せて選んでもらってください。compare/ は選択用のみで、公開前には削除してください。

その後、デスクトップとスマートフォンの幅でブラウザで確認できる場合は確認してください(case グリッドはプロジェクトフォルダへのリンクがあるため、サーバーが必要です)。サイトフォルダで python3 -m http.server を起動し、最初の画面(名前、仕事内容、証明、連絡先、実際の作品)がスクロールせずに表示されることを自分で確認してください。

ブラウザを開けない場合は、引き継ぎ時にその旨を伝え、少なくとも見出しと証明を合わせて約45語以内に収めてください。これはスマートフォンの最初の画像の上に収まる文字数です。

スクリプトが出力したリストを確認してください。コンテンツから修正できるもの(役割行の欠落、画像の重さ、見出しの長さなど)を修正し、残りは本人のみが提供できるものとして短いリストにまとめて引き継いでください。

6. 引き継ぎ

以下を伝えてください:使用したグリッドと、本人が選んだかあなたが選んだか(および他の2つは1単語の変更で使えること、または --compare で作成した場合は compare/ にあること)、見出しに書いた内容、除外したもの、推測したもの、まだ埋めるべきスロット、監査リストに残っている項目、変更方法(portfolio.json を編集して再度ビルドを実行)。フォルダは完全な静的サイトであり、そのままアップロードして任意の静的ホストで公開できます。

本人のみが提供できる2つのものをここで尋ねてください。サイトの公開アドレス(site.url)と、リンクプレビュー用の1200×630の画像(site.share_image)です。最初のプロジェクトの最も良い画像を切り抜いたもので十分です。

画像

  • 最大2000px幅でエクスポートし、AVIFまたはWebP形式で、各500KB以下にしてください。ビルドは重い画像について警告します。JPEG、PNG、SVGも使用可能です。
  • スマートフォン用の小さいコピーは、ファイル名をペアにすることで自動的に使用されます。コンテンツファイルに shot-lg.jpg、その隣に shot-sm.jpg を配置します。同じ名前の .avif がある場合は、それを解釈できるブラウザに対して優先的に提供されます。
  • 各画像に、何が写っているかを示す alt を指定してください。指定しないとプロジェクトタイトルが使用され、検索エンジンやAIアシスタントにはほとんど情報が伝わりません。画像を見ていない場合は、どの作品のどの部分かを伝え、本人に説明を依頼してください。
  • 短いループ動画(.mp4、.webm)はタイルとして機能します。画面に表示されている間のみ、ミュートで再生されます。ratio を指定してください。

やってはいけないこと

  • コンテンツの表示を遅らせるイントロアニメーション、ローダー、カスタムカーソル、スクロールエフェクトを追加しないでください。テンプレートは最初の画面を意図的に即座に表示します。
  • プロジェクトタイトルをホバーで隠さないでください。スマートフォンにはホバーがありません。
  • 連絡先ブロックがスクロールで見えなくなった後に表示される、名前とメールアドレスが表示される小さなバー「ドック」を削除しないでください。レビュアーはページの最後ではなく、プロジェクトの途中で連絡を決めることがあります。
  • 薄い作品にプロセス画像(付箋、ペルソナ)を追加して水増ししないでください。1つの決断を明確に述べることの方がはるかに価値があります。
  • 生成されたHTMLを手動で編集しないでください。次のビルドで上書きされます。コンテンツファイルを変更するか、構造自体を変更する必要がある場合は assets/template/ のテンプレートを変更してください。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル