Communitygithub.com

アップスキル

追跡中の求人情報と候補者のプロフィールを比較してスキルギャップを特定し、優先順位付きのギャップヒートマップと学習リソースを含む学習計画を作成します。

アップスキル とは?

**Upskill** スキルは、求人追跡ファイルと候補者の現在のプロフィールを分析し、スキルギャップを特定して、優先順位付きのギャップヒートマップと学習計画を生成するAIエージェントスキルです。主にClaude Codeや類似のエージェンツール向けに設計されており、`/upskill` コマンドで全求人を集約分析する「集約モード」と、`/upskill <URL>` で特定の求人を分析する「対象モード」の2つの動作モードをサポートします。Step 1〜8の詳細な手順に従い、ハードスキルの差分、ドメイン知識やソフトスキルの合成分析、優先順位付きのヒートマップ生成、具体的なWeb検索結果に基づく学習リソースの選択、依存関係を考慮した学習順序の提案、そしてレポートの保存までを自動化します。設定は `$JOB_SEARCH_HOME` 環境変数で管理され、候補プロフィール、求人追跡ファイル、出力ディレクトリを指定します。このスキルは、求人市場での競争力を高めたい開発者やキャリアチェンジを目指すユーザーに特に有用で、「upskill」「skill gaps」「what should I learn」「learning plan」「upskill report」といったトリガーで起動できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SongGithub/personal-skills/tree/HEAD/job-search/skills/upskill

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

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

ドキュメント

アップスキル は何をしますか?

追跡中の求人と候補者の現在のプロフィールを分析してスキルギャップを見つけ、ギャップヒートマップと具体的な学習リソース(検索結果に基づく)と学習順序を含む学習計画を作成します。

設定

  • 候補プロフィール: $JOB_SEARCH_HOME/profile.md
  • 追跡中の求人: $JOB_SEARCH_HOME/integrations.yaml の tracker_path
  • レポートは $JOB_SEARCH_HOME/upskill/ 以下に書き込まれます

起動方法

  • /upskill — 集約モード: 追跡ファイルの全行を対象
  • /upskill <URL> — 対象モード: 1件の求人情報、URLから取得

ステップ1 — モードの検出

引数なし → 集約モード。URLあり → 対象モード。URLはステップ2のために保持します。

対象モードでは、役職と企業からレポートスラッグを生成します。例: <企業スラッグ>-<役職スラッグ>

ステップ2 — データの読み込み

集約モード

  1. 追跡ファイルを読み込みます。列: date, company, sector, role, role_type, channel, status, contact_person, fit_rating, notes, cv_file, cover_letter_file, source
  2. 各行の role, company, fit_rating を記録します。fit_rating は0〜100で、ギャップの重み付けに使用します(低い評価は、その役職がより多くのギャップを露呈したことを意味します)。
  3. 現在のスキルを取得するために $JOB_SEARCH_HOME/profile.md を読み込みます。
  4. $JOB_SEARCH_HOME/upskill/ 内で最新の report-YYYY-MM-DD.md を探します。存在する場合は、ステップ8の差分のために読み込みます。

対象モード

  1. WebFetch で求人情報を取得します。
  2. タイトル、企業、必須スキル、推奨スキル、責任、ドメインコンテキストを抽出します。
  3. $JOB_SEARCH_HOME/profile.md を読み込みます。
  4. 追跡データは使用しません。

ステップ3 — パス1: ハードスキルの差分

集約モード。 完全な求人情報はないため、role、sector、notes から必要なスキルを推測します。source に有効なURLがある場合は取得しても構いません。無効または欠落しているものはスキップします。

スキル出現頻度マップを作成し、適合度で重み付けします。各ジョブは (100 - fit_rating) / 100 の重みを1出現につき与えます。最終スコアは fit_weight × occurrence の全ジョブにわたる合計です。

対象モード。 明示的な必須スキルと推奨スキルを取得します。重みは等しくします。必須スキルを推奨スキルより優先し、各グループ内ではアルファベット順に並べます。

プロフィールとの差分。 profile.md に既に存在するものは削除します。寛大に扱い、プロフィールが何らかの形で言及しているスキルはギャップとはみなしません。残ったものがハードスキルギャップリストです。集約モードではスコア順、対象モードでは必須スキル優先→アルファベット順にランク付けされます。

ステップ4 — パス2: 合成分析

差分が見逃しそうなギャップについて考察します:

  • ドメイン知識 — 馴染みのない業界や問題領域
  • ソフトスキル — 仕事の進め方、コミュニケーション、リーダーシップでプロフィールがカバーしていないもの
  • ツールとプロセス — 求人全体に現れるフレームワーク、クラウドサービス、方法論
  • 資格 — 複数の求人で推奨として挙げられている認定資格

各ギャップに [domain]、[soft]、[tooling]、[credential] のタグを付けます。パス1のギャップを重複して記載しないでください。

ステップ5 — ギャップヒートマップ

両方のパスを1つの優先順位付きテーブルに統合します:

  • Critical — 高加重のハードスキル、またはほとんどのジョブにわたるドメインギャップ
  • High — 中程度のハードスキル、または一貫したソフト/ツーリングギャップ
  • Medium — 低頻度のハードスキル、または少数の役割でのギャップ
  • Low — 1回限りの言及
優先度スキル / 領域タイプギャップソース
CriticalKubernetesHard4/5 jobs, score 3.2
HighSecurity domain knowledgeDomainLLM synthesis
MediumAWS (advanced)Hard2/5 jobs, score 1.1
Low………

続行する前にこのテーブルを出力して、ユーザーが何をもとに作業しているかを確認できるようにします。

対象モードでは、求人情報の表現に基づいて優先順位を付けます: 必須 → Critical/High、推奨 → Medium、推測 → Medium/Low。

ステップ6 — 学習計画

Critical と High のすべてのギャップをカバーし、さらに5つ未満のギャップしかない場合は Medium もカバーします。

各ギャップについて:

  1. WebSearch で最新の評判の良いリソースを検索します。結果が古くならないように、クエリに現在の年を含めます。例: "best <skill> course <year> site:reddit.com OR coursera.org"
  2. 2〜3のリソースを選択します。 講義のみよりハンズオンラボを優先。ツーリングギャップには公式ドキュメント、ドメインギャップには書籍を優先します。名前、URL、適合する理由を1行で示します。
  3. 学習方向性を記述します。 候補者が既に知っていることに合わせてカスタマイズします。何をスキップすべきか、どこから始めるべきかを示します。
  4. 実用レベルの習得までの時間を見積もります(~20h)。 多めに見積もります。

アルファベット順ではなく、テーマ別の見出しでグループ化します: クラウド&インフラストラクチャ、MLOps、ドメイン知識、セキュリティ、ソフトスキルと業務の進め方、認定資格。

### クラウド&インフラストラクチャ

**Kubernetes** `[Hard]` — ~20h
- [リソース](url) — ハンズオンラボ、理論よりも実践的
- [公式ドキュメント](url) — 基本を押さえた後のリファレンス

学習方向性: コンテナの基本は既にカバー済み — Podスケジューリングから始め、次にServiceとDeploymentへ。マニフェストと`kubectl`に習熟してからHelmに触れること。

ステップ7 — 推奨学習順序

  1. 依存関係を優先 — BにAが必要な場合、Aを先に配置し、依存関係をメモする
  2. 同じ階層内では Critical → High → Medium の順
  3. 早い成功体験を優先 — 勢いをつけるために、短時間で終わるMediumギャップを最初に持ってくるのも可
  4. ドメイン知識は最後 — 実際のプロジェクトと並行して学習する
#トピックタイプ推定時間備考
1KubernetesHard~20hステップ3の前提条件
2CI/CDパイプラインTooling~10h
3セキュリティドメイン知識Domain~15h実際のプロジェクトと並行して

合計推定時間: ~45h

ステップ8 — レポートの作成と保存

順序: ヘッダーとモード → 前回のレポートからの差分(集約モードのみ) → ギャップヒートマップ → 学習計画 → 推奨学習順序

  • 集約モード: $JOB_SEARCH_HOME/upskill/report-YYYY-MM-DD.md
  • 対象モード: $JOB_SEARCH_HOME/upskill/report-YYYY-MM-DD-<企業スラッグ>-<役職スラッグ>.md — 小文字、スペースはハイフンに、特殊文字は削除

差分セクション(集約モードのみ): クローズされたギャップ は前回のヒートマップにあったが現在プロフィールに存在するスキル。新しいギャップ は現在のヒートマップエントリで前回のレポートに存在しないもの。前回のレポートがない場合はセクション全体を省略します。

保存されたパスをユーザーに確認します。

ルール

  1. リソースを捏造しないでください。 WebSearch が実際に返したもののみを引用します。
  2. すべてのリソースクエリに現在の年を含めます。
  3. 対象モードは追跡ファイルを完全に無視します。
  4. プロフィールのマッチングは寛大に行います。 何らかの形で言及されているスキルはギャップではありません。
  5. ヒートマップを学習計画の前に出力します。
  6. Lowギャップの学習リソースは、依頼がない限り提供しません。
  7. 常にレポートを保存します。 ターミナル出力で十分に見えても保存します。
  8. 企業名のスラッグは求人情報から生成します。 捏造したり推測したりしないでください。

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

SongGithub/personal-skills

Applies a direct, plain-spoken, Australian-English communication style to any text drafted — chat replies, emails, Slack/Teams messages, tickets, PR and commit descriptions, docs. Use whenever drafting prose, not just visual or code artifacts. Skip when the user explicitly asks for a different tone or voice.

SongGithub/personal-skills

A reusable HTML document design system for CVs, one-pagers and short reports — design tokens, layout, typography, print-to-PDF rules and accessibility. Use when generating or restyling a self-contained HTML document meant to be read on screen or printed to PDF.

SongGithub/personal-skills

End-to-end job application workflow. Screen a posting, tailor the HTML CV from the master template, print it to PDF, archive the artifact, and file the result against the configured tracker. Triggers on apply, apply to jobs, submit application, tailor and send CV.

SongGithub/personal-skills

CV attach workflow. Generate a tailored HTML CV for a tracked role, attach the rendered artifact back to its tracker item, then verify the attachment actually landed. Covers template selection, tailoring order, upload headers, and read-back verification.

SongGithub/personal-skills

First-principles reasoning for a startup or a job search, in the spirit of Elon Musk's "zero restart" framing: survival cashflow, the idiot index, and the physical first step. 第一性原理创业与求职法 — 从马斯克「归零重启」思维出发,用生存现金流、白痴指数、长期物理第一步三个步骤,指导创业和求职

SongGithub/personal-skills

How to file a job opportunity as a Jira issue — summary format, required fields, duplicate check, description formatting and attachments. Applies when tracker_backend is jira. Use when a job posting becomes a tracker record, and when creating or updating job records on a Jira board.

SongGithub/personal-skills

Assistant for job applications: evaluating job postings, tailoring CVs, writing cover letters, and preparing for interviews. Triggers on keywords like: job posting, job application, CV, cover letter, resume, interview prep, job fit, career, application, apply, SEEK

SongGithub/personal-skills

Job scraper. Searches job boards for new positions matching the candidate profile, deduplicates against previously seen jobs and the tracker file, then presents new matches with a quick fit assessment. Triggers on: job scrape, find jobs, search jobs, new jobs, /scrape.

SongGithub/personal-skills

Screen job opportunities, prepare job records and tailored CVs, and verify the result against current salary, title, source, and document-quality preferences. Applies to job boards and scheduled searches.

SongGithub/personal-skills

Trello card rules for the job-search tracker. Enforces case-insensitive and fuzzy duplicate detection before any card is created, title formatting, lane placement from config, and logging each card to the tracker database. Applies whenever a job posting becomes a card.

関連スキル