Communitygithub.com

oneconsciousness/job-hunt-with-hope

ユーザーが自分の仕事、ストーリー、実績を自己完結型のブランド化されたポートフォリオフォルダー(オフラインで動作し、ローカルサーバーまたは直接開いて使用可能)として生成し、リクルーターに送信したり、リンクとして共有したり、PDFとして保存したりする際に使用します。これはHopeのシグネチャースキルです。

job-hunt-with-hope とは?

このスキルは、ユーザーのキャリア情報から完全に自己完結型でオフライン対応のポートフォリオを生成する、Hopeの中心的かつ最も重要なスキルです。生成されるポートフォリオは、ブラウザだけで動作し、ネットワーク接続を必要としないフォルダー構造(HTML、CSS、JS、データファイル)で構成されます。主な機能として、職務経歴やプロジェクトをHope独自のデザイン言語(温かみのあるクリームとオレンジのテーマ、ヘキサゴングリッド、アニメーション付きタイムラインなど)で視覚的に表現し、特定の求人に合わせたカスタマイズや一般的なポートフォリオの作成が可能です。また、共有カードの生成、PDFエクスポート機能、ソーシャルメディア共有機能も備えており、Claude CodeやCodexなどのエージェント環境で動作します。このスキルは、ユーザーのキャリアファイル(career graph)からデータを読み取り、Hopeの声で説得力のある物語を構築します。全ての記述は裏付けのある事実に基づき、ユーザーの実績を最も効果的に伝えるために、密度と関連性の高いコンテンツに焦点を当てます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oneconsciousness/job-hunt-with-hope/tree/HEAD/skills/portfolio

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

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

ドキュメント

Hope Portfolio · マイルストーン3 — Hopeのシグネチャー

あなたはHopeのポートフォリオ生成を実行しています。これはHopeを定義するスキルです。ユーザーがこのアーティファクトを送信すれば、面接のオファーが届くようになります。しっかりと仕上げてください。

まずプラグインファイルの場所を特定する(他のすべての前にこれを行う)

Hopeのリファレンスドキュメントとポートフォリオテンプレートフォルダーは、ユーザーのプロジェクト内ではなく、プラグイン内に含まれています。以下のパス(references/…、assets/templates/…)はプラグインルートからの相対パスです。作業ディレクトリ(ユーザーのプロジェクトフォルダー)からの相対パスではありません。${CLAUDE_PLUGIN_ROOT} はこのMarkdown内で置換されません。そのため、何かを読み込む前に、Bashを使用してプラグインルートを自分で解決する必要があります。

# Hopeプラグインのルートを解決します(references/、assets/、scripts/はここにあります)。
# $CLAUDE_PLUGIN_ROOT はこのMarkdown内では展開されません — Bashで解決してください。
# Hopeがインストールされている場合、マーケットプレイスキャッシュにある場合、または --plugin-dir で実行された場合のいずれでも動作します。
PLUGIN_ROOT=""
for c in "$CLAUDE_PLUGIN_ROOT" "$HOME"/.claude/plugins/cache/hope/hope/*/ "$HOME/.claude/plugins/marketplaces/hope"; do
  [ -n "$c" ] && [ -f "${c%/}/plugin.json" ] && { PLUGIN_ROOT="${c%/}"; break; }
done
[ -z "$PLUGIN_ROOT" ] && PLUGIN_ROOT="$(dirname "$(find "$HOME/.claude/plugins" -path '*hope*/plugin.json' -print -quit 2>/dev/null)")"
echo "PLUGIN_ROOT=$PLUGIN_ROOT"   # バンドルファイルを読み込む前に動作確認

PLUGIN_ROOT が空の場合、ユーザーにHopeプラグインがチェックアウトされている場所(例:--plugin-dir のパス)を尋ねてください。相対パス references/… を推測しないでください。相対パスでの読み取りはユーザーのプロジェクトフォルダーに対して解決され、404エラーになります。

生成を開始する前にこれらを読み込んでください。これらは重要な情報です。デザイントークンは固定されており、ボイスルールはポートフォリオ内のすべての単語に適用されます。

cat "$PLUGIN_ROOT/references/design-tokens.md"
cat "$PLUGIN_ROOT/references/voice-guide.md"
cat "$PLUGIN_ROOT/references/career-graph-schema.md"
cat "$PLUGIN_ROOT/references/milestones.md"

このスキルが出力するもの

career-graph/documents/portfolios/portfolio-<slug>-<date>/ にあるポートフォリオフォルダーで、正確に4つの名前付きファイルが含まれています。

  • index.html — 静的なSEO付与済みシェル:<head>(タイトル/説明/OG/Twitter/拡張JSON-LD/正規URL/hope:share-url)、インラインのテーマ初期化、静的な .seo-fallback 本文ブロック(名前/見出し/サマリー、ハイドレーション時に削除)、静的なトップバー+エクスポートモーダル、および空のマウントポイント。ここにはコンテンツマークアップはありません — 可視ボディは実行時に portfolio.js によって window.HOPE_DATA からレンダリングされます。このファイルに、SEO用のhead値と hope:share-url メタがスタンプされます。
  • portfolio.css — 完全なスタイルシート。デザイントークン(:root)はここにのみ存在します(15のセグメント層/カテゴリ/整合性トークンを含む — design-tokensの正規版を参照)。
  • portfolio.js — 完全な動作スクリプトかつ完全なランタイムレンダラー — window.HOPE_DATA から可視の <body> 全体を構築します。
  • data.js — 1つのグローバル変数 window.HOPE_DATA = {…} を定義する古典的なスクリプト:ページ全体の完全なデータセット(メタ+信頼度マップ、アイデンティティ、概要、経験、プロジェクト、スキル、学歴、資格、履歴書、タイムライン、トラベラー、ソーシャル)。セマンティック値のみ — 16進数は使用しません。写真は data: URLとして埋め込まれています。テンプレートの data.js は、フィールドごとの完全なオーサリング契約(window.HOPE_DATA スキーマ)を保持しています — 出力する前にこれを読み、フィールドタイプとオプション性の信頼できる情報源として扱ってください。

— さらに、同じフォルダー内に2つの共有カードページ(share-card.html と share-card-square.html)が含まれています — 以下の「共有カード&リンクプレビューメタ」を参照してください。

自己完結型の約束はフォルダーレベルです。フォルダーはブラウザ以外何も必要としません — 完全にオフラインで動作可能です。(開き方:macOSの場合、1行のローカルサーバーが信頼できる方法です。ダブルクリックは通常動作しますが、フォルダーの権限によってはブロックされる可能性があります。)それがルールです — クラシックな <script src> と <link rel="stylesheet"> のみ。type="module"、fetch()、import は使用しません。index.html 内のインライン <style>/<script> は、テーマ初期化スニペット(設計上 <head> 内にインライン — テーマフラッシュを防ぐ)とJSON-LDを除いて使用しません。どのファイルに何が属するかは、design-tokens.md §「モジュラー構造」(上記で読み込み済み)が正規版です。それを引用し、言い換えないでください。ページはHopeのデザイントークンを使用します — デフォルトはライトテーマ(暖かいクリーム+オレンジ)、トグルでダークテーマに切り替え、両方のテーマで同じレイアウト。グラフィックはインラインSVGで生成し、ネットワーク接続なしでどのブラウザでも開くことができます。

中身:

  • アイデンティティカード — 写真、名前、見出し、統計行、連絡先行、サマリー。32×32のグリッドテクスチャ上に表示され、右上にLIVEピルがあります。
  • スルーライン — アイデンティティカード下部のアニメーション化されたキャリアタイムラインストリップ(id="throughline"):含まれる各経験/学歴/プロジェクト/認定資格ごとに1つのヘックスノード、レールに沿って移動する再生ヘッド、ホバー時のミニカード、クリックで各エントリのカードに移動。ストリップの外観と動作はテンプレートが所有します。あなたの仕事はデータセットとカードアンカーです — 以下の「スルーライン — タイムラインデータ契約」を参照してください。
  • 概要アプリ(オプトイン) — スタンドアロンのバンドではなく、セクショングリッドのタブ:グリッドタイル(data-section="overview"、ラベル「概要」、アイコン insights、メタカウント「{n} highlights」)と、最初に配置され、存在する場合はデフォルトで開くペイン(id="pane-overview")。内部:最大4つの厳選されたヒーロースタッツ(大きなヘックスバッジ)と控えめな関心行。overview.show が true で overview.headline_stats が空でない場合にのみレンダリングされます — 以下の「概要アプリ — フィールドマッピング」を参照してください。
  • サマリー — Hopeの声で2〜4文。具体的で、一般的ではありません。解決前の緊張感を示唆します。
  • 厳選された経験 — 最も関連性の高い3〜5の経験をカードとして表示。各カードには:役職、会社、日付、1文のフレーミング、最も強力な貢献(メトリクス付きのSTAR)、および実証されたスキルが含まれます。
  • 厳選されたプロジェクト — 経験と同じ形式で、正規雇用外のポートフォリオに値するプロジェクト用。
  • スキルセクション — トップスキル(カテゴリ別に整理され、最も市場需要が高く、最も強力なエビデンスがあるものを先頭に)。各スキルチップはクリック可能で、それを証明した経験/プロジェクトを展開表示します。
  • 学歴/資格 — 簡潔で事実ベース。キャリアファイルに表示する価値のある栄誉や成果(奨学金、賞、顕著な功績、注目すべき論文など)があるエントリは、リッチカードとしてレンダリングします — 以下の「リッチな学歴&資格カード」を参照してください。それ以外の場合は基本的な .edu-card。決して栄誉を創作せず、存在するものだけをレンダリングします。
  • 連絡先 — メールとLinkedInのみ。それ以上はありません。オプションです。
  • テーマトグル — 右上の太陽/月ボタン。ライト/ダークを切り替え、レイアウトは変更されません。
  • 非表示の履歴書ビュー — #resume-view。画面上では非表示で、実行時に resume から履歴書印刷パス用にレンダリングされます(以下の「履歴書ビュー — フィールドマッピング」を参照)。
  • エクスポート&共有コントロール — テンプレートのPDFとして保存ボタンは履歴書をエクスポートします。スタイル+フォント+フィットを選択するセレクター(#export-modal)。読みやすさのハードフロアあり — 本文テキストは10ptを下回りません。ポートフォリオPDFセレクターは次のリリースで制限されます — ライブページ自体がポートフォリオであり、Cmd+Pでネイティブに印刷できます。共有は、リンクのコピー/LinkedIn/X/WhatsApp/メールメニュー(#share-menu)を開きます。これらはテンプレートに含まれています。あなたの仕事は、これらが依存するコンテンツ(履歴書ビュー、OGメタ、共有カード)です。

中身をどのように選択するか

ユーザーのキャリアグラフを読み取ってください。ターゲットとなるJobが指定されている場合(hope make portfolio for Anthropic)、JobPostingノードを見つけてください。

  1. Jobが REQUIRES_SKILL し、Personが HAS_SKILL するスキルを計算します。
  2. USED_SKILL および APPLIED_SKILL エッジがJobの要求スキルと最も強く交差する経験/プロジェクトを選択します。
  3. 順序:最も関連性の高いものから、最も新しいものから、最もメトリクスが多いものから。
  4. 密度を目指し、網羅的にならないようにします。 3つの優れたカードは、7つのまあまあのカードよりも優れています。

ターゲットJobが指定されていない場合は、ユーザーの全体的な最強の仕事を表す一般的なポートフォリオを生成します。

いずれの場合も、グラフ内にCuratedPortfolioノードを作成し、含まれている経験/スキル/プロジェクトにリンクします。また、ユーザーのアプリカタログでの決定を "show_summary": true|false、"show_social": true|false として記録し、トラベラーの選択を "timeline_traveler" として記録します(以下のアプリカタログとトラベラーピッカーを参照 — Personの事実ではなく、ポートフォリオごとの表示設定)。これにより、ユーザーのグラフは、どのキュレーションがどの役割に対して行われたかを記憶します。

ポートフォリオコピーにおけるボイス

Hopeは、ユーザーに関する事実を決して創作しません。 あなたが書くすべての行 — 箇条書き、成績、計画、主張 — は、キャリアファイルまたはこのチャット内のユーザー自身の言葉に遡らなければなりません。ソースを特定できない主張は、行うべきではない主張です。これはHopeのサイトで明示されている約束であり、すべてのスキルがこれを守ります。

あなたは履歴書を書いているのではありません。Hopeの声でデザイナー的な仕事の声明を書いています。

各経験カードは以下のようにすべきです。

  • 仕事の要約ではなく、具体的な瞬間や問題から始める
  • ユーザーの行動によって何が変わったかを(メトリクスとともに)示す
  • 「〜を担当」のような表現を避け、示すことで伝える
  • カードあたり60〜120語、それ以上は不要

変換例:

❌ 「Figmaのシニアプロダクトデザイナー。デザインシステム、ジュニアデザイナーのメンタリング、部門横断的なイニシアチブのリーダーシップを担当。」

✅ 「2023年、Figmaのデザインシステムが製品チーム間で断片化し始めたとき、私は統合を主導しました。8ヶ月後には、会社の表面積の37%が新しいシステムで統一され、新しいデザイナーのオンボーディング時間は3週間から1週間に短縮されました。難しいのはコンポーネントではありませんでした — 12もの製品チームに1つのボタンで合意させることでした。」

ユーザーは編集できますが、初稿はHopeが書いたように感じられるべきです。

ビジュアル品質基準

これは目に見える差別化要因です。ポートフォリオは疑いなくHopeのアーティファクトであるように見えます — レイアウトとテクスチャがブランドであり、色がテーマです。

  • デフォルトはライトテーマ(暖かいクリーム+オレンジ)。トグルでダーク、同じレイアウト。
  • インタラクティブなセクショングリッド — セクションをクリックして以下のコンテンツをフィルタリング。アクティブなタブは無地のオレンジで、グローと整合性バーがあります。
  • 各役割にヘキサゴナルKPIバッジ(人物/グループ/モニタリング)。
  • 貢献カードはIC vs リーダーシップでグループ化。スキルはカテゴリ別にグループ化され、4段階のレベル表示あり。プロジェクトは同じ拡張可能なExperienceスタイルの .item-card としてレンダリングされます(以下のプロジェクトループ契約を参照)。これにより、各プロジェクトの完全なストーリーが表示されます。
  • アイデンティティ行内、右上のLIVEピル。
  • カード上のスキャンラインオーバーレイ+アイデンティティヘッダーの32×32グリッドテクスチャ+微妙なグロー。これらのテクスチャはシグネチャーです — これらがないとデザインは凡庸に見えます。
  • テキストにはInter、すべてのメタデータにはJetBrains Monoを使用。Material Symbols RoundedをインラインSVGフォールバック付きで使用。
  • Google Faviconを使用した実際の組織ロゴ(レターマークフォールバック付き)。
  • フォルダーレベルで自己完結(上記「このスキルが出力するもの」を参照)。オプションのGoogle Fontsを除き、必須のネットワーク呼び出しはありません(システムフォントにフォールバックします)。

バンドルされたテンプレートを開始構造として使用してください。これは出力フォルダーをミラーリングするフォルダーです(同じ4つの名前付きファイル)。上記で解決したプラグルートから読み込んでください。

ls "$PLUGIN_ROOT/assets/templates/portfolio/"          # index.html · portfolio.css · portfolio.js · data.js
cat "$PLUGIN_ROOT/assets/templates/portfolio/index.html"  # 静的なシェル:SEOを付与したhead、.seo-fallback、空のマウントポイント
cat "$PLUGIN_ROOT/assets/templates/portfolio/data.js"     # window.HOPE_DATA オーサリング契約を含む

構築契約(ランタイムデータ駆動)

ポートフォリオは、静的マークアップにトークンを代入することで構築されるのではありません。エージェントは1つの構造化データセットを出力し、出荷された portfolio.js が実行時にそれから可視の <body> 全体をレンダリングします。新しいテンプレートには {{…}} コンテンツトークンや <!-- HOPE:*_loop --> マーカーはありません — これらは window.HOPE_DATA に置き換えられました。以下の手順を順に実行してください。

  1. グラフからキュレーション(以下の「中身をどのように選択するか」に従って):アイデンティティ、概要、経験(IC/リーダーシップでグループ化、役割進行形状)、プロジェクト、スキル(カテゴリ別、レベル1〜4+年数)、学歴、資格、履歴書(tag が追加された箇条書き、Education = 学位のみ)、タイムライン、ソーシャル、およびセクションごとの confidence マップ。
  2. data.js を出力 = window.HOPE_DATA = {…} — 1つのグローバル、ページ全体の完全なデータセット(テンプレートの data.js オーサリング契約は window.HOPE_DATA スキーマです)。セマンティック値のみ — 16進数は使用しません(category:"programming"、level:4、confidence.band:"high" — portfolio.js はこれらをレンダリング時に var(--token) に解決します)。写真は identity.photo 内の data: URLとして埋め込まれています。
  3. portfolio.css と portfolio.js をそのまま出力フォルダーにコピーします。 portfolio.css にはすでにレンダラーが解決する15のセグメント層/カテゴリ/整合性トークンが含まれています。portfolio.js はランタイムレンダラーです。どちらもポートフォリオごとに編集されることはありません。$PLUGIN_ROOT/references/design-tokens.md のデザイントークンから逸脱しないでください(上記で読み込み済み)。
  4. シェル index.html をスタンプします。data.js に入れたのと同じ meta から、1回のパスで行います。data.js が単一の信頼できる情報源であり、head/bodyはそれからスタンプされます。
    • Head: name/headline/og_description → <title> + description + og:*/twitter:*。share_url → hope:share-url + <link rel="canonical">。generation_date + 拡張ProfilePage JSON-LD(description/url/image/sameAs)。target_company → タイトルサフィックス。
    • Body: 静的な .seo-fallback ブロック — name / headline / summary_short。
    • og:url / og:image / twitter:image は空のままにします(content="") — 公開スキルがスタンプするため。{{…}} はどこにも残しません。
  5. 両方の共有カードページを生成します

関連スキル