Communitygithub.com

donotdonuts/claude-workflow-skills

donotdonuts.github.io テンプレートから個人ポートフォリオサイトを構築します。ユーザーの名前、写真、履歴書、ソーシャルURL、ビジュアルスタイル(参照URLまたは説明文)を収集し、履歴書からタイムライン/プロジェクトカード/チャットボットナレッジを生成して、適切なカラーパレットを適用します。オプションでCloudflare WorkerバックエンドのDeepSeekチャットボットも設定可能。ユーザーがボット名を指定すると、エージェントがマッチする絵文字アバターを提案します。静的サイトはGitHub Pagesにデプロイされます。このアーキテクチャで自分用のポートフォリオを構築したいユーザーに使用します。

claude-workflow-skills とは?

このスキルは、donotdonuts/donotdonuts.github.io テンプレートをベースに、ユーザー個人のポートフォリオサイトをゼロから構築するための完全自動化ワークフローです。主な機能として、履歴書から抽出した職歴・学歴・サイドプロジェクトを視覚的なタイムラインとプロジェクトカードグリッドに自動生成します。タイムラインの各項目にホバーまたはフォーカスすると、関連するプロジェクトカードのみが表示されるインタラクティブなフィルター機能を備えています。また、オプションでDeepSeek APIを利用したチャットボットをCloudflare Worker経由で追加でき、ユーザーがボット名を指定するとそれに合った絵文字アバターを提案します。サイトのビジュアルスタイルは、ユーザーが指定した参照URLからCSS変数を抽出するか、自然言語での説明をもとに適切なカラーパレットとフォントを生成します。最終的に生成された静的サイトはGitHub Pagesにプッシュされ、公開されます。対応プラットフォームはGitHub Pages、Cloudflare Workers(チャットボット利用時)、DeepSeek APIです。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/donotdonuts/claude-workflow-skills/tree/HEAD/skills/random-skills/personal-site-setup

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

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

ドキュメント

個人サイトのセットアップ

新しいユーザーが https://<ユーザー名>.github.io で自分のポートフォリオを公開できるよう導きます。アーキテクチャは固定ですが、見た目、コピー、チャットボットのペルソナはすべてユーザーごとにカスタマイズされます。

得られるもの

  • シングルページ静的サイト、バンドラー不要。GitHub Pages がリポジトリルートの main ブランチを配信します。
  • ヒーローセクション — ユーザーの肖像写真 + 名前 + 一行の所在地 + 一行のキャッチコピー。
  • プロジェクトセクション — セクションヘッダーにフェードした縦のタイムライン(仕事はレンチアイコン、学歴は本アイコン、雰囲気/サイドプロジェクトはスパークルアイコン。各停止点は会社、役職、日付、所在地を表示)と、本文にプロジェクトカードのグリッド。両方ともユーザーの履歴書から生成されます。
  • タイムライン ↔ カードフィルター — タイムラインの停止点にホバーまたはキーボードフォーカスすると、関連しないプロジェクトカードが非表示になります。クリックでフィルターを固定(もう一度クリックで解除)。連携するカードが1枚以上ある停止点のみインタラクティブになります。その他は非アクティブのままです。
  • 折りたたみカード — 各プロジェクトカードはデフォルトでカテゴリ + タイトル + ツールタグのみを表示します。ホバー/フォーカスで要約段落と指標行が表示され、グリッドがスキャンしやすくなります。
  • チャットボット(オプション) — 右下に浮かぶ起動ボタンとポップアウトパネル(インラインページセクションではありません)。DeepSeek の OpenAI 互換 API を Cloudflare Worker 経由で使用し、API キーを保持します。ユーザーがボットの名前を選択し、エージェントがマッチする絵文字アバターを提案します。ボットの返信はマークダウンをレンダリングします。2層のレート制限があります。
  • コンタクトセクション — メール + ユーザーのソーシャルURL。

前提条件

必要なものツールインストール方法
すべてgit通常インストール済み
すべてGitHub アカウント + gh CLIbrew install gh その後 gh auth login
すべてpython3(ローカルプレビュー用)通常インストール済み
チャットボットCloudflare アカウント(無料枠)https://dash.cloudflare.com
チャットボットwrangler CLInpm install -g wrangler その後 wrangler login
チャットボットDeepSeek API キーhttps://platform.deepseek.com/ → API keys
肖像写真の色調整Node.jsbrew install node

ステップバイステップ

1. ユーザーから入力を収集する

ファイルに触れる前にこれを行ってください。 すべての入力を一度に収集し、後のステップで自動編集できるようにします。複数選択肢には AskUserQuestion を、自由記述には直接プロンプトを使用します。

以下をすべてユーザーから取得します。

入力質問方法例
GitHub ユーザー名直接jane(リポジトリは jane.github.io になります)
表示名直接Jane Doe または Jane "JD" Doe
所在地フレーズ直接、短くNYC metropolitan、Remote、Tokyo
キャッチコピー直接、一文I build ML systems and love shipping.
履歴書テキストを貼り付け、またはファイルパス完全な履歴書 — タイムライン、プロジェクトカード、チャットボットナレッジに使用
写真ディスク上の正方形画像のパス/Users/jane/Desktop/headshot.jpg。クローン後、リポジトリルートに raw.jpg として配置可能
ソーシャルURL直接、各オプションLinkedIn / GitHub プロフィール / Medium / 個人メール
チャットボット?AskUserQuestionはい / いいえ
チャットボット名(「はい」の場合)直接Pot、Nova、Echo など
ビジュアルスタイルAskUserQuestion「参考にしたいURLを貼る」または「言葉で説明する」

チャットボット名を収集した後、テーマに合う絵文字アバターを2~3個提案し、ユーザーに選んでもらいます。例:

名前提案するアバター
Pot🫖(ティーポット)· 🍲 · 🎨
Nova🌟 · 💫 · 🌠
Echo📣 · 🔊 · 🌀
Ember🔥 · 🪵 · ✨
Atlas🗺️ · 🧭 · 🌍
Bit💾 · 🔢 · 🤖
Sage🌿 · 📖 · 🦉

明確に合うものがなければ、ニュートラルな 🤖、💬、🪄 を提案します。選択された絵文字と名前を保存し、後でコードに書き込みます。

2. GitHub リポジトリを作成する

gh repo create <ユーザー名>.github.io --public --description "個人ウェブサイト"

GitHub Pages のユーザーサイトは <ユーザー名>.github.io である必要があります。

3. テンプレートをクローンする

git clone https://github.com/donotdonuts/donotdonuts.github.io my-site
cd my-site
rm -rf .git
git init -b main
git remote add origin https://github.com/<ユーザー名>/<ユーザー名>.github.io.git

4. ビジュアルスタイルを選ぶ

テンプレートのデフォルトはクリーム + IBM Plex Mono の外観です。ステップ1でのユーザーの回答に基づいて上書きします。

4a. ユーザーがURLを指定した場合

ページのCSSを取得し、トークンを抽出します。

curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origin>/<css-path>" -o /tmp/ref-1.css

# bodyに実際に適用されているフォント
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# すべてのCSSカスタムプロパティ定義
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60

以下を探します: 背景の16進数、前景/インクの16進数、境界線の16進数、アクセントの16進数、bodyに適用されている font-family、@font-face URL。

4b. ユーザーが説明文を指定した場合

説明を具体的なトークンに変換します。ヒューリスティック:

単語意味
"ミニマル"、"エディトリアル"、"ペーパー"クリーム/オフホワイト背景、ダークインク、細い区切り線
"ダーク"、"ターミナル"、"IDE"ほぼ黒背景(#0f1115)、明るいインク、控えめなグレーの境界線
"ウォーム"、"アナログ"やや黄色みがかったクリーム(#faf5e8)、茶色がかった黒インク
"ブルータリスト"純白または純黒、2px以上の実線の境界線
"テクニカル"、"データ"等幅フォント(IBM Plex Mono、JetBrains Mono)、クールグレー
"マガジン"、"エディトリアル"セリフ体(EB Garamond、Fraunces)、広めの行間
"遊び心"彩度の高いアクセント色1つ、他は落ち着いた色

4c. 提案して適用

13個のトークンとフォントスタックをまとめます。コードブロックで提案パレットを表示し、ファイル編集前に承認を得てください。

:root {
  --bg:             <16進数>;   /* ページ背景 */
  --bg-soft:        <16進数>;   /* サブパネル — 通常 --bg と --ink を約3%混ぜたもの */
  --bg-hover:       <16進数>;   /* タグ/チップのホバー */
  --card-bg:        <16進数>;   /* 不透明なカード塗りつぶし(ライトテーマの場合は白) */
  --ink:            <16進数>;   /* 主要テキスト */
  --ink-soft:       <16進数>;   /* --ink の約80% */
  --ink-mute:       <16進数>;   /* 約60% */
  --ink-faint:      <16進数>;   /* 約40% */
  --border:         <16進数>;   /* 控えめな区切り線 */
  --border-strong:  <16進数>;   /* 主要な区切り線 */
  --up:             <16進数>;   /* ポジティブな指標(デフォルトは緑系) */
  --down:           <16進数>;   /* ネガティブな指標(デフォルトは赤系) */
  --accent-ink:     <16進数>;   /* リンク */
  --font-mono:      "<ファミリー>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

その後:

  1. css/styles.css を開き、:root ブロックを見つけて値を置き換えます。
  2. index.html を開き、<head> 内の Google Fonts <link> を新しいフォントファミリーとウェイトに更新します。

5. 履歴書と入力からコンテンツを生成する

ステップ1の履歴書とその他の入力を使用して index.html を生成します。

  1. <head> — <title> = <表示名> — <履歴書から最初の役職>; <meta name="description"> はキャッチコピーから。

  2. ヒーロー:

    • <h1 class="hero-title"> ← 表示名
    • <p class="hero-location"> ← 所在地フレーズ
    • <p class="hero-tagline"> ← キャッチコピー
  3. タイムライン — 履歴書を解析して停止点にします。役職ごと、学位ごと、そしてユーザーが表示したい進行中の個人サイドプロジェクトカテゴリごとに1つの <li class="tl-stop"> を配置します。新しいもの → 古いもの(DOMの上から下)の順に並べます。 各停止点に短い data-experience スラッグを設定します(例: mars、vibe、coach、gatech)— フィルターが停止点とカードを関連付けるために使用します。関連するプロジェクトカードが1枚以上ある停止点にのみ tabindex="0" を追加します(その他は非アクティブのまま)。

    <li class="tl-stop tl-stop-work" data-experience="<スラッグ>" tabindex="0">
      <!-- tl-stop-work | tl-stop-edu | tl-stop-vibe (いずれかを選択) -->
      <svg class="tl-icon tl-icon-work" aria-hidden="true">
        <use href="#icon-wrench"/>       <!-- #icon-wrench | #icon-book | #icon-sparkle -->
      </svg>
      <div class="tl-info">
        <strong>会社 / 学校</strong>
        <span>役職 / 学位</span>
        <em>開始 — 終了</em>
        <i class="tl-loc">都市、州</i>
      </div>
    </li>
    

    プロジェクトカードが関連付けられていない学歴や過去の役職の停止点には tabindex="0" を付けないでください — js/main.js が読み込み時に自動検出し、非インタラクティブのままにします。

  4. プロジェクト — 履歴書の注目すべきプロジェクト/実績から生成された約6つの <article class="project-card"> ブロック。各カードは、それが由来する停止点と一致する data-experience スラッグを必ず持つ必要があります。そうしないとフィルターに参加しません。

    <article class="project-card" data-experience="<スラッグ>">
      <header class="project-head">
        <span class="project-tag">カテゴリ</span>
        <h3>プロジェクトタイトル</h3>
      </header>
      <p>履歴書の箇条書きから抜粋した1~2文の要約。</p>
      <dl class="project-metrics">
        <div><dt>指標</dt><dd class="up">+値</dd></div>
        <div><dt>指標</dt><dd>値</dd></div>
      </dl>
      <ul class="tag-list small"><li>ツール</li><li>ツール</li></ul>
    </article>
    

    指標の色付けには <dd class="up"> / <dd class="down"> を使用します。カードはデフォルトで折りたたまれてレンダリングされます — タグ、タイトル、ツールタグのみが表示され、ホバー/フォーカスで要約と指標が表示されます。要約は簡潔に保ってください。ホバー時のご褒美としてのみ存在します。

  5. チャットの挨拶 — ボットの最初のメッセージは index.html の #chat-panel 内(パネルの <div class="chat-log"> 内)のインラインHTMLです。これにより、ユーザーが初めてポップアウトを開いたときに即座にレンダリングされます。選択されたボット名とアバター絵文字を使用して書き換えます。形式:

    <div class="chat-msg chat-msg-bot">
      <span class="chat-avatar" aria-label="<ボット名>">絵文字</span>
      <div class="chat-bubble">
        <p>こんにちは、私は <strong><ボット名></strong> — <表示名> のAIアシスタントです。<表示名> の履歴書から学習しました。</p>
        <p>以下のことについて質問してください:</p>
        <ul>
          <li>会社 / 役職</li>
          <li>手法 / アプローチ</li>
          <li>プロジェクト / スキル / 学歴</li>
        </ul>
        <p>何か知りたいことはありますか?</p>
      </div>
    </div>
    
  6. コンタクト — メール + 提供された各ソーシャルURLを .connect-list 内の <li> として追加します。提供されていないプラットフォームの行は削除します。

6. 肖像写真を追加する

写真の場所をユーザーに確認します。リポジトリルートに raw.jpg としてコピーし、リサイズします。

cp <ユーザーの写真パス> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg

写真の背景が新しい --bg と合わない場合は、バンドルされたスクリプトで色を調整します。

cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <このスキルのディレクトリ>/scripts/shift-portrait.js \
  /path/to/my-site/raw.jpg \
  /path/to/my-site/assets/portrait.jpg \
  "#<あなたの背景16進数>"

第3引数を省略した場合のデフォルトは #fbf7eb です。raw.jpg は gitignore されています。

7. チャットボットを設定する(ユーザーが「いいえ」と答えた場合はスキップ)

7a. Worker

cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY

worker/wrangler.toml:

ALLOWED_ORIGIN = "https://<ユーザー名>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL          = "deepseek-chat"

worker/worker.js → SYSTEM_PROMPT — ユーザーの履歴書から書き換えます。セクション構造(About / Current role / Past roles / Education / Tool box)は維持します。また、ボット名とアバターを使用して冒頭のペルソナ文を書き換えます。

const SYSTEM_PROMPT = `あなたは「<ボット名>」<絵文字> — <表示名> の個人ウェブサイトに埋め込まれた、フレンドリーで簡潔なAIアシスタントです。…`;

デプロイ:

wrangler deploy

7b. クライアント

js/config.js:

window.SITE_CONFIG = {
  chatWorkerUrl: "https://<worker>.workers.dev",
};

js/chatbot.js — 上部の定数を更新:

const AVATAR = "<絵文字>";
const AVATAR_LABEL = "<ボット名>";

8. プレビューしてプッシュ

python3 -m http.server 8000       # http://localhost:8000

すべてのセクションをクリックして確認します。チャットをテストします。モバイル幅にリサイズします。その後:

git add .
git commit -m "initial: 個人サイト"
git push -u origin main

約60秒以内に https://<ユーザー名>.github.io/ で公開されます。

テンプレートアーキテクチャ(変更しないでください)

セクションレイアウト

すべてのセクションは .section-grid: 280px 1fr を使用します。280px の列は最も長いタイムラインラベルに適合します。すべてのラベルが短い場合は 240px に狭め、長い場合は 320px に広げます。

タイムライン

  • Projects の section-head 内にあり、タイトルのすぐ下、opacity: 0.45 で配置されます。ホバー、フォーカス、またはアクティブなフィルターにより 0.95 に引き上げられます。
  • DOM の順序 = 画面上の上から下の順序。 新しいもの → 古いもの。時間に比例せず、flex gap で均等に分布します。
  • デフォルトで3種類のアイコンがあります: #icon-wrench(仕事、.tl-stop-work)、#icon-book(教育、.tl-stop-edu)、#icon-sparkle(雰囲気/サイドプロジェクト、.tl-stop-vibe)。3つすべての <symbol> 定義は <header> の直後のSVGスプライトにあります。新しいアイコンカテゴリを追加するには:
    1. SVGパスで <symbol id="icon-foo"> を追加
    2. .tl-icon-foo { color: var(--ink-mute); } を追加
    3. <svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg> で参照
  • すべての停止点は data-experience="<スラッグ>" を持ちます。スラッグが少なくとも1つのプロジェクトカードと一致する停止点には tabindex="0" も追加され、js/main.js がフィルターインタラクションを有効にします。

プロジェクトフィルター(クリック + ホバー)

js/main.js によって完全に駆動され、設定は不要です。DOMを読み込み時にスキャンし、該当する場合にのみハンドラーを配線します。

  • 読み込み時に、data-experience スラッグが少なくとも1つの .project-card に存在するすべての停止点に .tl-stop-has-projects + role="button" + aria-pressed="false" が追加されます。関連カードのない停止点は非アクティブのままです。
  • ホバー/フォーカス インタラクティブな停止点 → 一時フィルター: 一致しないカードは .is-dim になります(グリッドに .is-filtering が追加され、CSS が暗くしたカードに display: none を適用 — レイアウトから削除され、単にフェードするわけではありません)。
  • クリック(または Enter / Space)→ ロック: 停止点に .is-locked が追加され、完全な不透明度、インク色のアイコン、下線付きの会社名になります。同じ停止点をもう一度クリックすると解除され、別の停止点をクリックすると切り替わります。
  • ロック中、別の停止点にホバーするとそのカードがプレビューされ、レールからの mouseleave(またはレールからの focusout)でプレビューが解除され、ロックされたフィルターに戻ります。

チャットパネル

  • #chat-panel は固定位置にあり、.chat-launcher が display: none を切り替えます。
  • .chat-log は flex-direction: column-reverse で、新しいメッセージを一番下に揃え、古いメッセージを上にスクロールさせます。
  • ユーザーメッセージは .chat-msg-user、ボットメッセージは .chat-msg-bot です。
  • chatbot.js はレート制限を適用します: 1分間に12メッセージ、連続して3メッセージまで。違反はトースト通知で示されます。

可変 CSS プロパティ

ページ全体に適用される13のトークン。新しいデザインの場合は、ステップ4のパレット作成+承認ワークフローを通じて進めてください。:root の値を直接編集しないでください。ユーザーがプロジェクトの「スタイル」感覚をあまり持っていない場合は、Playfair + Source Sans 3 の温かみのあるエディトリアルルックで妥協し、その後調整します。

関連スキル