Communitygithub.com

RiverAi7z/pdf-resume-skills

PDF履歴書から魅力的な個人ウェブサイトを構築します。ユーザーがPDF履歴書/CVから個人サイト、ポートフォリオサイト、オンライン履歴書を作成したい場合に使用します。履歴書をウェブサイトに変換する、CVからポートフォリオを構築する、プロフェッショナルな経歴に基づいたランディングページを作成するといった要望にも対応します。

pdf-resume-skills とは?

このスキルは、PDF形式の履歴書から、ユーザーの職業、個性、好みを反映した、プロダクションレベルの個性的な個人ウェブサイトを生成します。最大の特徴は、AI生成サイトにありがちな「どのサイトも同じに見える」という美的収束を避けるために、タイポグラフィ、カラーパレット、モーション、背景に至るまで、綿密で独創的なデザインガイドラインを採用している点です。ワークフローは、まず`uv`スクリプトまたはpdf-reader MCPを使ってPDFからデータを抽出し、次にユーザーの職種を分析して適切な美的方向性を決定します(例:ソフトウェアエンジニアにはターミナル風、デザイナーには実験的な雰囲気)。その後、ユーザーと対話的にデザインの好みを聞き出し、カラープレビューなどのツールを使ってリアルタイムで選択肢を可視化します。最終的には、カスタムCSSプロパティ、アニメーション、テクスチャ背景などを駆使して、単なるテンプレートではない、その人だけのサイトを構築します。Claude CodeやCursorなどのAIエージェント環境で動作することを前提として設計されています。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add RiverAi7z/pdf-resume-skills

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

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

ドキュメント

Resume Website Builder (履歴書ウェブサイトビルダー)

PDF形式の履歴書から、個性的でプロダクションレベルの個人ウェブサイトを構築します。ウェブサイトは、ユーザーの職業、個性、デザインの好みを反映し、一般的なテンプレートのように見えないようにします。


デザインの美的指針

コードを書き始める前に、これを肝に銘じてください:AIが生成するウェブサイトの最大の失敗要因は「美的収束」(すべてのサイトがぼんやりと似通ってしまうこと)です。これを何としても避けてください。あなたの仕事は、この人に「本当に、具体的にデザインされた」と感じられるものを作ることです。

タイポグラフィ

その人の分野にふさわしい、美しく、珍しく、適切なフォントを選んでください。目標は、誰かが気づいてコメントするような組み合わせです。安全なフォールバックではありません。

禁止フォント(使い古されて無個性になっているもの):Inter、Roboto、Arial、Helvetica、system-ui、-apple-system、Space Grotesk、Poppins。これらは「選択」ではなく「デフォルト」です。

使用すべき個性的なGoogle Fonts(職業や美的感覚に合ったものを選び、すべてを使わないこと):

編集/表現力豊かなセリフ体:

  • Cormorant Garamond — ロマンチック、文学的な、ファッションエディトリアルな高級感
  • Playfair Display — クラシックな活版印刷風、コントラストの強いストローク
  • Fraunces — 風変わりなオプティカルセリフ、意外性のある個性
  • Instrument Serif — 洗練されて現代的、静かな自信
  • DM Serif Display — パンチの効いたモダンセリフ
  • Abril Fatface — 超ハイコントラスト、存在感のある見出し
  • Yeseva One — アールデコの温かみ、親しみやすい権威
  • Cinzel — クラシックなローマ風荘厳さ

クリーンだが個性的なサンセリフ体:

  • Syne — 幾何学的、デザイン先進的、現代的
  • Unbounded — 太字、グリッドに完璧、ウェブネイティブ
  • Plus Jakarta Sans — 温かみとモダンさがあり、Interとは一線を画す
  • Outfit — 個性のあるフレッシュな幾何学体
  • DM Sans — クリーンだが無機質ではない
  • Josefin Sans — エレガントな幾何学的ミニマリズム

本文用(読みやすく、個性的):

  • Lora — 温かみのあるセリフ体、文学的、長文でも読みやすい
  • Source Serif 4 — エディトリアルとしての信頼性
  • Spectral — エレガントなデジタルセリフ体
  • Literata — 読書のために精密に設計された

技術者/開発者向けの美的感覚:

  • JetBrains Mono — 開発者としての信頼性
  • IBM Plex Mono — コーポレートテック、構造的
  • Space Mono — レトロデジタル、個性的
  • Fira Code — リガチャ、ハッカーの美的感覚

表現力豊か/ニッチな美的感覚向け:

  • Exo 2 — SF的な精密さ
  • Orbitron — 宇宙時代(使いすぎに注意 — 適切な人には完璧)
  • Rajdhani — 角張った、技術的なエネルギー

組み合わせの原則: 表示用/見出し用フォントを1つ、本文用フォントを1つ選びます。これらは対照的であるべきです — ドラマチックなセリフ体の見出しとクリーンなサンセリフ体の本文、または正確なモノスペース体の見出しと温かみのあるセリフ体の本文など。退屈な組み合わせとは、両方のフォントが同じ重みに感じられる組み合わせのことです。

色とテーマ

強力でまとまりのあるパレットにコミットしてください。色を均等に散りばめた控えめなパレットはアマチュアっぽく見えます。1つの支配的な色 + 1つのシャープなアクセント色 + 注意深く選ばれたニュートラル色は、ほとんどの場合、3つの均等な重みの色よりも強力です。

禁止色の組み合わせ(陳腐で予想通り):

  • 白地に紫/バイオレットのグラデーション(デフォルトの「AI美的感覚」)
  • 白地にティール+コーラル(使い古されたスタートアップのパレット)
  • 一般的なダークモード:#1a1a1a 背景 + 白いテキスト + 青いアクセント
  • コントラストや緊張感のないフラットなパステルカラー

参考にすべき個性的なパレットのアーキタイプ(正確にコピーせず、適応させること):

  • 深い森 #1a2e1a + 温かいゴールド #c9a84c + クリーム #f5f0e8 — 有機的な権威
  • 深夜のネイビー #0d1b2a + エレクトリックシアン #00d4ff + 白 — 技術的な正確さ
  • 温かみのある黒 #1a1208 + アンバー #f59e0b + アイボリー — エディトリアルな温かみ
  • チャコール #2a2a2a + ラスト #c0392b + オフホワイト #fafaf7 — 大胆な自信
  • 深いバーガンディ #3d0c02 + シャンパン #e8d5b7 + アイボリー — アカデミックな高級感
  • ほぼ黒 #0e0e0e + アシッドライム #a8d729 + 白 — 技術的なエッジ
  • スレート #2c3e50 + 深いコーラル #ff6b4a + クリーム — 温かいモダニズム
  • オフホワイト #fafaf8 + インク #1a1a2e + テラコッタ #c4602a — 地に足のついた温かみ
  • 暗いバイオレット #1a0533 + ホットピンク #ff6b9d + 白 — クリエイティブなマキシマリズム

ユーザーによってライトテーマとダークテーマを積極的に変えてください。 「より技術的に見える」という理由でダークをデフォルトにしないでください。強いエディトリアルパレットを持つライトサイトも同様に印象的です。

すべての色にCSSカスタムプロパティを使用します:

:root {
  --color-bg: #1a2e1a;
  --color-surface: #243824;
  --color-accent: #c9a84c;
  --color-text: #f5f0e8;
  --color-muted: #8a9e8a;
}

モーション

1つのよく練られたエントランスシーケンスは、10の散らばったマイクロインタラクションよりも多くの喜びを生み出します。ページの読み込みを、単一の振り付けられた瞬間と考えてください。

効果的なパターン:

/* 読み込み時の段階的表示 — 増加するanimation-delayを適用 */
@keyframes fadeUp {
  from { opacity: 0; transform: translateY(24px); }
  to   { opacity: 1; transform: translateY(0); }
}
.hero-name    { animation: fadeUp 0.6s ease forwards; animation-delay: 0.1s; }
.hero-title   { animation: fadeUp 0.6s ease forwards; animation-delay: 0.25s; }
.hero-tagline { animation: fadeUp 0.6s ease forwards; animation-delay: 0.4s; }
.hero-cta     { animation: fadeUp 0.6s ease forwards; animation-delay: 0.55s; }
  • デフォルトで opacity: 0 を使用し、opacity: 1 にアニメーション — クリーンで構成可能
  • ホバー状態では transition: all 0.2s ease を使用 — 反応が良いと感じられる速さ
  • スクロールトリガーによる表示:IntersectionObserver + セクションがビューポートに入るためのCSSクラス切り替えを使用
  • 境界線、下線、ハイライトには:アニメーション化された width または clip-path 変換が正確で意図的に感じられる

避けること: particle.js / canvasパーティクルエフェクト、過度なバウンス、コンテンツと戦うパララックス、合計で約1秒以上、コンテンツの表示を遅らせるアニメーション。

背景

ベタ塗りは怠惰なデフォルトです。すべての背景には、少なくとも1つの深みまたはテクスチャのレイヤーが必要です。

テクニック:

/* メッシュグラデーション — 複数のラジアルグラデーションを重ねる */
background:
  radial-gradient(ellipse at 20% 50%, rgba(201,168,76,0.15) 0%, transparent 60%),
  radial-gradient(ellipse at 80% 20%, rgba(0,212,255,0.08) 0%, transparent 50%),
  #0d1b2a;

/* 微妙なグリッドパターン */
background-image: linear-gradient(rgba(255,255,255,0.03) 1px, transparent 1px),
                  linear-gradient(90deg, rgba(255,255,255,0.03) 1px, transparent 1px);
background-size: 48px 48px;

/* SVGフィルターによるグレインテクスチャ */
filter: url(#grain); /* feTurbulenceフィルターを定義したSVG */

/* 斜めストライプのアクセント */
background: repeating-linear-gradient(
  -45deg,
  transparent,
  transparent 8px,
  rgba(201,168,76,0.05) 8px,
  rgba(201,168,76,0.05) 9px
);

背景テクニックを全体的な美的感覚に合わせてください。ターミナル風の開発者サイトには微妙なスキャンライン効果、高級金融サイトには非常に薄いリネンテクスチャなど。


ワークフロー

ステップ 1: 履歴書PDFを抽出する

以下のアプローチを順に試してください。まずスクリプトを試し、失敗した場合のみMCPにフォールバックします。

オプション A: uvスクリプト(推奨)

uv を使用して抽出スクリプトを実行します。uv がインストールされていれば、追加のセットアップなしで依存関係を自動的に処理します。

uv run .claude/skills/resume-website/scripts/pdf-extract.py <path-to-resume.pdf>

uv がインストールされていない場合は、最初にインストールするようにユーザーに指示します:

  • macOS / Linux:
    curl -LsSf https://astral.sh/uv/install.sh | sh
    
  • Windows (PowerShell):
    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
    

インストール後、上記のスクリプトコマンドを再実行します。

オプション B: pdf-reader MCP(フォールバック)

何らかの理由でスクリプトが失敗した場合は、pdf-reader MCPにフォールバックします。インストールされているか確認し、されていない場合はインストールします:

claude mcp add pdf-reader -- npx @sylphx/pdf-reader-mcp

インストール後、Claude Codeを再起動してMCPを使用可能にします。次に、MCPの read_pdf ツールを使用して履歴書の内容を抽出します。

ステップ 2: 履歴書を読み取り、分析する

pdf-reader MCPを使用してユーザーの履歴書PDFを読み取ります。以下を抽出して整理します:

  • 名前と連絡先情報(メール、電話、所在地、LinkedIn、GitHub、ポートフォリオリンク)
  • 職種 / 見出し
  • 職務経験(会社、役職、期間、実績)
  • 学歴(学位、機関、期間)
  • スキル(技術スキル、ソフトスキル、言語)
  • プロジェクト(ある場合)
  • 資格、賞、出版物(ある場合)
  • 要約 / 目的(ある場合)

ステップ 3: ユーザーの職業を分析する

ユーザーの仕事によって、ウェブサイトの美的方向性が決まります。デザインをそのプロフェッショナルなアイデンティティに合わせますが、表面的な分類にとどまらないようにします。ヘッジファンドの「ソフトウェアエンジニア」とデザインエージェンシーのそれでは異なる美的感覚を持ちます。

職業カテゴリ美的方向性フォントの出発点色の方向性
ソフトウェアエンジニア / 開発者ターミナル風、正確、ダーク推奨JetBrains Mono または IBM Plex Mono + クリーンなサンセリフ体暗い背景 + エレクトリックなアクセント(シアン、グリーン、アンバー)
デザイナー / クリエイティブディレクター大胆、実験的、強いタイポグラフィの存在感表現力豊かなディスプレイセリフ体 + 幾何学的サンセリフ体ハイコントラスト、意外性のある組み合わせ
データサイエンティスト / アナリスト構造化、分析的、データ可視化風正確なサンセリフ体 + 読みやすいセリフ体の本文深いネイビー/スレート + シャープな単一アクセント
マーケティング / ビジネスエディトリアルマガジン風、自信、CTA駆動ハイコントラストなセリフ体見出し + 温かみのあるサンセリフ体温かい支配色 + 大胆なアクセント
アカデミック / 研究者学者風、セリフ体多用、知的なミニマリズムCormorant または Spectral + Lora 本文クリーム/アイボリー + インク + 1つの温かいアクセント
ヘルスケア / 医療クリーン、信頼できる、落ち着いた権威DM Sans または Plus Jakarta Sans + 読みやすい本文落ち着いたニュートラル + 信頼できるアクセント
ファイナンス / コンサルティング高級感、権威、洗練Cinzel または Yeseva One + エレガントな本文セリフ体暗色 + ゴールド/シャンパン、または深いネイビー + シルバー
アーティスト / フォトグラファーギャラリー風、画像重視、ドラマチックAbril Fatface または Syne + ミニマルな本文彼らの作品に依存 — 多くの場合、ほぼ黒 + 1つの大胆な色
プロダクトマネージャーモダン、整理された、メトリクス重視Instrument Serif + クリーンなサンセリフ体自信のあるミッドトーン + 鮮明なアクセント
教師 / 教育者温かみ、親しみやすさ、読みやすさFraunces または DM Serif + 温かみのあるサンセリフ体本文暖色系、明るめの輝度
法律権威、伝統的、構造的Cinzel または Playfair Display + セリフ体本文濃いネイビーまたはチャコール + ゴールド
フリーランサー / ジェネラリスト個人ブランドの表現 — 履歴書の詳細から決定性格に依存性格に依存

これを出発点として、特定の履歴書から明らかになるユーザーの性格、経験年数、業界のコンテキストに基づいて適応させます。

ステップ 4: ユーザーのデザインの好みを尋ねる

AskUserQuestion ツールを使用してデザインの好みを収集します。ユーザーはデザイン用語を知らない可能性があるため、フレンドリーで非技術的な方法で質問します。

重要な原則:各質問は、ユーザーがすでに回答した内容に適応する必要があります。 すべての質問を事前にまとめて、あらかじめ生成されたオプションを提示しないでください。後続の質問の選択肢は、ユーザーが以前に選んだものに依存します。タイポグラフィについて尋ねる前に、ライトかダークかを知らなければ、間違ったフォントを提案することになります。

ラウンド 1 — アンカーとなる決定:雰囲気 + トーン

全体的な雰囲気とライト/ダークの方向性について一緒に尋ねます。これらは、以降のすべてが分岐する2つの軸だからです。職業に合わせた3〜4の美的方向性を生成します(例:ソフトウェアエンジニアには「ターミナル/精密」、デザイナーには「エディトリアル/表現力豊か」)。あなたのトップ推奨から始め、それがなぜその人に特に適しているかを説明します。「驚かせてください」オプションを含めます。

回答を得たら、それを以降のすべてのアンカーとして保持します。

ラウンド 2 — 色 + ビジュアルスタイル(ラウンド 1 に適応)

次に、選択されたテーマ内で実際に機能するカラーパレットオプションを生成します。ユーザーがライトを選んだ場合はライトパレットを表示します。「5つのオプションがあり、そのうち3つはダーク」と表示しないでください。ビジュアルスタイルについても同様に、選択された雰囲気と一貫性のあるスタイルを表示します。デザインの美的指針のパレットアーキタイプを出発点として、それらを適応させます。

色を視覚的に表示する: 色の質問をする前に、一時的な color_preview.html ファイルを生成し、ブラウザで開いてユーザーが実際のスウォッチを見られるようにします。その後、名前または番号で選択するように依頼します。

3〜4のパレットオプションを生成します。各パレットには、背景、サーフェス、アクセント、テキストの色を含める必要があります。HTMLは次のように記述します:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>パレットを選んでください</title>
<style>
  body { font-family: sans-serif; padding: 32px; background: #f5f5f5; }
  .palettes { display: flex; flex-wrap: wrap; gap: 24px; }
  .palette { border-radius: 12px; overflow: hidden; width: 260px; box-shadow: 0 2px 12px rgba(0,0,0,0.12); }
  .swatch { height: 56px; display: flex; align-items: center; padding: 0 16px; font-size: 13px; font-weight: 500; }
  .label { padding: 14px 16px; background: white; }
  .label h3 { margin: 0 0 4px; font-size: 15px; }
  .label p { margin: 0; font-size: 12px; color: #666; }
</style>
</head>
<body>
<h2>カラーパレットを選択</h2>
<div class="palettes">
  <!-- 各パレットオプションについてこのブロックを繰り返す -->
  <div class="palette">
    <div class="swatch" style="background:#1a2e1a; color:#f5f0e8;">背景</div>
    <div class="swatch" style="background:#243824; color:#f5f0e8;">サーフェス</div>
    <div class="swatch" style="background:#c9a84c; color:#1a2e1a;">アクセント</div>
    <div class="swatch" style="background:#f5f0e8; color:#1a2e1a;">テキスト</div>
    <div class="label">
      <h3>1. フォレスト &amp; ゴールド</h3>
      <p>有機的な権威 — 深いグリーン、温かいゴールド、クリーム</p>
    </div>
  </div>
</div>
</body>
</html>

カレントディレクトリに color_preview.html として保存し、open color_preview.html を実行します。ユーザーに伝えます:「ブラウザでカラープレビューを開きました。どのパレット番号が良いか見てみてください。」

ユーザーが選択した後、color_preview.html を削除して続行します。

関連スキル