Communitygithub.com

Yukiniro/skills - フロントエンド履歴書

履歴書をインタラクティブでアニメーション豊かな単一ページHTML履歴書サイトに変換します。視覚的な探索を通じてユーザーの好みの美観を発見し、非デザイナーでもプロ品質のWeb履歴書を作成できます。

skills - フロントエンド履歴書 とは?

このスキルは、ユーザーが提供する履歴書データ(PDF、DOCX、Markdown、プレーンテキスト、JSON Resume、または直接入力)から、完全に自己完結型でアニメーション豊かなHTML履歴書を生成します。フロントエンドフレームワークやビルドツールに依存せず、単一のHTMLファイルとして出力されるため、どこでも簡単に配布・表示できます。 コアとなる哲学は「見せること、語らないこと」であり、ユーザーの気分や希望するトーンに基づいて3つのビジュアルプレビューを自動生成し、好みのデザインを選択できるようにします。これにより、デザイン経験のないユーザーでも、視覚的な比較を通じて自分に合ったスタイルを発見できます。 生成される履歴書には、スクロールトリガーアニメーション、フローティングナビゲーション、アニメーションスキルバー、印刷用スタイルシート、アクセシビリティ対応(WCAG AA準拠)、レスポンシブデザインなど、生産性向上に役立つ多数のインタラクティブ機能が標準で含まれています。 このスキルは、Claude Code、Cursor、Codexなど、ファイルシステムへのアクセスとHTMLファイルの生成・表示が可能なAIエージェントプラットフォームで動作するように設計されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yukiniro/skills/tree/HEAD/skills/frontend-resume

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

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

ドキュメント

フロントエンド履歴書

依存関係ゼロ、アニメーション豊かなHTML履歴書ページを作成します。ブラウザだけで完全に動作します。視覚的な探索を通じてユーザーが好みの美観を発見し、本番品質のインタラクティブな履歴書を生成できるように支援します。

基本理念

  1. 依存関係ゼロ — インラインCSS/JSを使用した単一HTMLファイル。npmもビルドツールも不要。
  2. 見せること、語らないこと — ビジュアルプレビューを生成し、ユーザーに好きなものを選んでもらいます。
  3. 特徴的なデザイン — ありきたりな「AI生成」的な美観は避けます。各履歴書はカスタムメイドであるべきです。
  4. 印刷対応 — すべての履歴書には、クリーンなPDF出力のための@media printスタイルを必ず含めます。
  5. アクセシブル — セマンティックHTML、キーボードナビゲーション、動きの軽減対応、WCAG AAコントラスト。

フェーズ0: モード検出

ユーザーの希望を判断します:

モードA: ファイルから — ユーザーが履歴書ファイル(.pdf、.docx、.md、.txt、.json)を提供 → フェーズ1へ モードB: テキストから — ユーザーが履歴書の内容をテキストで提供 → フェーズ1へ モードC: 拡張 — ユーザーが既存のHTML履歴書を持っている → ファイルを読み込み、フェーズ2へ


フェーズ1: コンテンツ抽出と構造化

ステップ1.1: ファイル抽出(モードAのみ)

ユーザーの履歴書ファイルに対して scripts/extract_resume.py を実行します:

python [skill-dir]/scripts/extract_resume.py <resume_file>

サポートされるフォーマットと依存関係:

フォーマット拡張子Python依存関係備考
PDF.pdfpdfplumber(推奨)または PyPDF2pip install pdfplumber
Word.docxpython-docxpip install python-docx
Markdown.mdなし見出し、リスト、太字/斜体を解析
プレーンテキスト.txtなしすべて大文字の行を見出しと推定
JSON Resume.jsonなし(組み込み json)jsonresume.org スキーマ; すでに構造化済みのため、ステップ1.2をスキップ可能

必要な依存関係がない場合、スクリプトはインストール手順を表示します。

抽出されたコンテンツを確認のためにユーザーに提示します。JSON Resumeファイルの場合、データはすでに構造化されているため、ユーザーが調整したい場合を除き、マッピングされたセクションを直接提示してステップ1.3に進みます。

ステップ1.2: コンテンツの構造化

生のテキストを構造化されたセクションにパースします:

  • header: 名前、肩書/タグライン、所在地、連絡先(メール、電話、LinkedIn、GitHub、ポートフォリオ)
  • about: プロフェッショナルサマリー
  • experience[]: 会社名、役職、期間、所在地、箇条書き
  • education[]: 学校名、学位、期間、表彰/GPA
  • skills{}: カテゴリ別にグループ化、オプションの習熟度(0-100)
  • projects[]: プロジェクト名、説明、使用技術、リンク
  • certifications[]: 認定名、発行機関、日付(オプション)
  • languages[]: 言語、習熟度(オプション)

構造化された内容を確認のためにユーザーに提示します。「これは正しいでしょうか?追加、削除、または変更するセクションはありますか?」と尋ねます。

ステップ1.3: セクションの優先順位

AskUserQuestionで質問:

  • ヘッダー: 「レイアウト」
  • 質問: 「どのセクションを最も目立たせたいですか?」
  • オプション:
    • 「経験重視」 — 職歴を中心に(シニアプロフェッショナル向け)
    • 「スキル重視」 — 技術スキルを前面に(開発者/エンジニア向け)
    • 「プロジェクト重視」 — ポートフォリオ/プロジェクトを強調(デザイナー/フリーランサー向け)
    • 「バランス」 — 全セクションに均等な重み

フェーズ2: スタイル発見

ステップ2.0: スタイルパス

質問: 「履歴書のスタイルはどのように選びたいですか?」

  • 「オプションを見せて」 — 3つのビジュアルプレビューを生成(推奨) → ステップ2.1へ
  • 「何が欲しいかわかっている」 — プリセットリストから直接選択 → 以下のプリセットピッカーを表示

利用可能なプリセット:

プリセット雰囲気最適な対象
Midnight Architect洗練された、高級感エグゼクティブ、コンサルタント
Neon Terminalハッカー風、デベロッパー向けソフトウェアエンジニア、DevOps
Dark Luxeエレガント、エディトリアルクリエイティブディレクター、マーケティング
Cosmic Depth大胆、未来的テックファウンダー、AI/MLエンジニア
Clean Slateミニマル、スイスデザイン風デザイナー、プロダクトマネージャー
Paper Craft温かみのある、触感的ライター、教育者、アカデミック
Soft Blueprint技術的、親しみやすいエンジニア、データサイエンティスト
Brutalist Mono生々しい、反デザインブランドストラテジスト、目立ちたい人
Sage Garden自然から着想、落ち着いたHR、ウェルネス、教育者
Retro Inkビンテージエディトリアルジャーナリスト、パーソナルブランド

ユーザーが直接選択した場合、フェーズ3にスキップします。

ステップ2.1: ガイド付き発見

質問1 — ムード(複数選択可、最大2つ):

  • 「プロフェッショナル/権威的」 — 確立された、信頼できる
  • 「クリエイティブ/個性的」 — ユニーク、デザイン重視
  • 「モダン/技術的」 — クリーン、開発者向け
  • 「温かみ/親しみやすい」 — フレンドリー、感じの良い

質問2 — トーン:

  • 「明るい」 — クリーン、印刷向き
  • 「暗い」 — 大胆、画面最適化
  • 「どちらでも」 — スタイルに任せる

ステップ2.2: 3つのプレビューを生成

ムードとトーンに基づいて、3つのプリセットを選択します。references/STYLE_PRESETS.md で完全なプリセット定義を参照してください。

ムードからプリセットへのマッピング:

ムード暗い明るいスペシャリティ
プロフェッショナルMidnight Architect, Dark LuxeClean Slate, Soft Blueprint—
クリエイティブDark Luxe, Cosmic DepthPaper CraftBrutalist Mono, Retro Ink
モダン/技術的Neon Terminal, Cosmic DepthSoft BlueprintBrutalist Mono
温かみDark LuxePaper Craft, Sage GardenRetro Ink

.claude-design/resume-previews/ に3つのミニHTMLプレビューを生成:

.claude-design/resume-previews/
├── style-a.html
├── style-b.html
└── style-c.html

各プレビュー: 自己完結型(約80〜120行)、ヒーローセクション + 1つの職歴エントリ + スキルバーを表示。美観を伝えるのに十分な内容。

これらのありきたりなパターンは絶対に使用しないでください:

  • 表示用フォントにInter、Roboto、Arial
  • 背景白に紫グラデーション、一般的なインディゴ #6366f1
  • すべて中央揃えでバリエーションなし
  • 過剰なグラスモーフィズム

ステップ2.3: 選択

プレビューを提示し、ユーザーに1つを選んでもらうか、要素を組み合わせるか尋ねます。


フェーズ3: 履歴書の生成

選択されたプリセットに対して、以下のリファレンスファイルを読み込みます:

  • references/STYLE_PRESETS.md — 完全なCSS変数、フォントURL、カラーパレット、アニメーションスタイル
  • references/RESUME_COMPONENTS.md — インタラクティブコンポーネントのCSS/JSパターン
  • references/HTML_ARCHITECTURE.md — ベースHTMLテンプレート、必須CSS、JSアーキテクチャ、印刷スタイル、アクセシビリティチェックリスト

出力

自己完結型の単一HTMLファイルを生成:

  • すべてのCSSは <style> にインライン
  • すべてのJSは <script> にインライン
  • Google Fonts / Fontshare は <link> 経由(グレースフルデグラデーション対応)
  • セマンティックHTML5構造

必須機能

  1. スクロールトリガー表示 — IntersectionObserver を使用して要素がアニメーション表示
  2. フローティングナビゲーション — アクティブセクションを追跡する固定ナビゲーション
  3. アニメーションスキルバー — スクロールでビューに入ると塗りつぶし
  4. スクロールプログレスバー — 上部の細いバー
  5. トップに戻るボタン — スクロール後に表示
  6. 印刷用スタイルシート — 白背景、アニメーションなし、URL表示可能な @media print
  7. 動きの軽減 — @media (prefers-reduced-motion: reduce) でアニメーションを無効化
  8. レスポンシブ — すべてのサイズで clamp() を使用、モバイルからデスクトップまで動作

確認チェックリスト

提供前に以下を確認:

  • すべてのタイポグラフィで clamp(min, preferred, max) を使用
  • すべてのスペーシングで clamp() またはビューポート単位を使用
  • セマンティックHTML(<header>、<main>、<section>、<nav>)
  • 印刷スタイルが含まれており機能する
  • 動きの軽減が考慮されている
  • ナビゲーション、ボタン、プログレスバーにARIAラベルが付与されている
  • カラーコントラストがWCAG AAを満たしている
  • 外部リンクに target="_blank" rel="noopener" が設定されている

フェーズ4: デリバリー

  1. クリーンアップ — .claude-design/resume-previews/ が存在する場合は削除
  2. 開く — ブラウザで起動: open [filename].html
  3. サマリー:
インタラクティブな履歴書の準備ができました!

ファイル: [filename].html
スタイル: [Style Name]
セクション: [list]

機能:
- スクロールトリガーアニメーション
- アニメーションスキルバー
- インタラクティブタイムライン
- フローティングナビゲーション
- 印刷対応(Ctrl+P)
- すべての画面サイズでレスポンシブ

カスタマイズ方法:
- 色: 上部の:root CSS変数を編集
- フォント: フォントインポートリンクを変更
- アニメーション: .revealクラスのタイミングを変更
- コンテンツ: HTML内のテキストを直接編集

調整が必要な場合はお知らせください。

トラブルシューティング

PDF抽出でテキストが少ない場合: PDFが画像ベース(スキャン)である可能性があります。ユーザーにテキストコンテンツを直接提供してもらうよう依頼してください。

DOCX抽出で構造が欠落している場合: 一部のDOCXファイルは標準の見出しスタイル(Heading 1/2/3)を使用していません。抽出プログラムはフォールバックとして個々のフォントサイズを使用します。それでも構造が不明確な場合は、ユーザーにどの行がセクションヘッダーかを確認してもらってください。

JSON Resumeのフィールドが欠落している場合: JSONはオプションセクション(プロジェクト、資格など)を省略する場合があります。利用可能なものを提示し、ユーザーに不足しているセクションを手動で追加するか尋ねてください。

Markdownフロントマターの干渉: YAMLフロントマターのデリミター(---)は自動的にスキップされます。履歴書のコンテンツ自体が区切り線として --- を使用している場合もスキップされますが、通常は問題ありません。

フォントが読み込まれない場合: フォントURLを確認してください。font-family 宣言にシステムフォントのフォールバックが含まれていることを確認してください。

アニメーションがトリガーされない場合: IntersectionObserverが初期化されていることを確認してください。.visible クラスが追加されているか確認してください。

印刷出力がおかしい場合: @media print ブロックが存在することを確認してください。アニメーションが無効化され、背景が白になっているか確認してください。

関連スキル