mcpField
R
resume-review

resume-review

github.com/trainwithshubham生産性45188 回インストール26 週間前に更新
リポジトリ

resume-review について

PDFの履歴書を求人票と照らし、採用担当者とATSの観点から評価するスキルです。候補者の経験レベルや市場に応じて、採点、キーワードの不足、優先すべき修正を提示します。

主な機能

  1. 01PDF履歴書と求人票のレビュー
  2. 025項目の採点基準
  3. 03ATS解析上の問題の診断
  4. 04求人キーワードの不足分析
  5. 05STAR形式での箇条書き修正
  6. 06経験レベルと市場に応じた助言

活用シーン

  1. 01求人に合わせた履歴書の調整
  2. 02ATS解析上の問題の発見
  3. 03応募前の修正作業の優先順位付け

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/trainwithshubham/skills --skill resume-review

インストール後、Claude Code で/resume-reviewを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
ats-rules.md
devops-rules.md
keywords-bank.md
market-specific.md
scoring-rubric.md

詳細

履歴書のレビュー

プロの採用担当者とATSの両方の視点から、履歴書をレビューします。ユーザーにスコアと明確な診断を伝え、30分で取り組める改善策を提示してください。

このレビューの基本理念は、シンプルな事実に基づいています。**履歴書は読まれるのではなく、スキャンされます。**まず機械にスキャンされ、その後、注意を向ける時間が6秒しかない人間にスキャンされます。履歴書の75%は、人間の目に触れる前にATSで不採用になります。レビューでは、どちらの読者も等しく重視してください。

レビューを始める前に必要なもの

必要なものは2つです。どちらか一方でも足りない場合は、レビューを始める前に依頼してください。

  1. 履歴書 — PDFファイルです。必ずPDFで共有するようユーザーに依頼してください(ユーザーが.docxやプレーンテキストを提案した場合も、決してそれを依頼しないでください。PDFを解析するときにATSが何を認識するかを確認したいためです)。
  2. 応募先の職務記述書 — テキストの貼り付け、またはリンクです。職務記述書は、キーワードの照合と70/30のカスタマイズ分析の基準になります。

ユーザーが履歴書だけを提供した場合は、次のように尋ねてください。「履歴書を確認しました。どの職種を目指していますか?職務記述書を貼り付けるか、リンクを送ってください。その内容に合わせてレビューします。」

ユーザーが職務記述書だけを提供した場合は、PDFの送付を依頼してください。

履歴書を読む

PDFに対してReadツールを使用してください。10ページを超えるPDFにはpagesパラメーターが必要ですが、履歴書は2ページを超えるべきではありません。2ページを超える履歴書を見つけた場合、それ自体をレポートの指摘事項に含めてください。

読む際は、ATSのパーサーが何を認識するかを頭の中でシミュレーションしてください。

  • 複数列のレイアウトでは、読み取り順序が崩れます
  • 画像やアイコン内のテキストは、ATSから認識できません
  • 表は解析を妨げることがよくあります
  • 標準的でないセクション名(「職務経験」ではなく「私の歩み」など)は、キーワード抽出を混乱させます
  • ヘッダーやフッターが読み飛ばされることがあります

解析上の問題は、疑いではなく具体的な指摘事項として挙げてください。

分析の枠組み

ステップ1:候補者のレベルを判定する

経験年数の合計と職務のシニア度を確認します。次のように分類してください。

  • 未経験者(0~1年) — プロジェクトと学歴を最も重視します。1ページを想定してください。プロジェクトのセクションは必須であり、任意ではありません。
  • 中堅(2~5年) — 職務経験のセクションが中心になります。1~2ページです。指標を含む成果の箇条書きが差別化につながります。
  • シニア/リード(5年以上) — リーダーシップを示す要素、アーキテクチャに関する意思決定、規模を示す実績が重要です。最大2ページです。直近の職務に最も多くのスペースを割いてください。

レベルによって期待される内容は異なります。未経験者にシニア向けの基準を適用しないでください。

ステップ2:応募先の市場を判定する

履歴書と職務記述書を組み合わせて、次の点から推測してください。

  • インド — Naukriのプロフィールへの言及、CTCの記載、インド企業、インドの電話番号形式
  • 海外/リモート — タイムゾーンに関する情報、リモート勤務に特化した表現、インド以外の企業や勤務地
  • 不明 — ユーザーに次のように尋ねてください。「インド国内、海外/リモート、または両方の職種への応募ですか?」

市場の違いによって、アドバイスは大きく変わります(インドでは写真、CTC、通知期間に関する情報、リモートではタイムゾーンや非同期コミュニケーションに関する情報が重要です)。

ステップ3:5つの項目で採点する

合計は100点です。詳細な基準については、references/scoring-rubric.mdの評価基準を使用してください。採点時には、そのファイルを読んでください。

項目点数評価内容
ATSとの互換性25解析のしやすさ、形式、セクション見出し、フォント、ファイル形式、略語の扱い
キーワードと職務記述書との一致度25キーワードの密度、分類、提供された職務記述書との一致度
成果と指標20STAR方式の箇条書き、数値化された成果、力強い動詞、能動態
構成と長さ15レベルに適した長さ、セクションの配分、逆時系列順
連絡先とプロフェッショナルとしての印象15業務用メールアドレス、LinkedIn、GitHub、勤務地、問題となる情報(写真/生年月日など)がないこと
Step 4: 7つの致命的な欠点をチェックする

ここが診断の要です。それぞれの欠点について、✓(該当)または ✗(問題なし)を付けます。

  1. ツールの羅列 — 分類も習熟度の目安もなく、30個以上のツールをテキストの塊として列挙している
  2. 数値指標ゼロ — 数字、規模、成果を示さず、「CI/CDパイプラインを管理」のような箇条書きをしている
  3. 「Responsible for...」/代名詞 — 行動を曖昧にする受動態(「Responsible for monitoring...」など)、または未熟な文章だと受け取られる代名詞(I、me、we、he、she、his、her)を使っている。箇条書きは力強い動詞から始め、主語の代名詞は使わないでください。
  4. ありきたりな概要 — 「成長できる機会を求める、情熱あふれるエンジニア」(見つけたらすぐ削除してください)
  5. 複数ページにわたる冗長さ — 新卒者は1ページ超、経験者は2ページ超
  6. プロジェクト欄がない — 新卒者にとっては致命的です。経験者にとっても、他の候補者と差別化する大きな機会を逃しています。
  7. キーワードを無視している — JDの表現に合わせていないスキル(例:履歴書には「K8s」、JDには「Kubernetes」と書かれている場合、ATSはこれらを同等として扱いません)

履歴書に2つ以上の欠点がある場合は、目立つように指摘してください。それがユーザーに連絡が来ない理由であることがほとんどです。

それぞれの項目について詳しいルール(重要な理由や書き換え方)を知りたい場合は、references/devops-rules.mdをお読みください。

Step 5: JDと照合する — 70/30チェック

「70/30ルール」とは、優れた候補者はマスター履歴書(70%は固定)を用意し、応募先ごとに30%を調整する(スキルの順序、箇条書きで強調する内容、概要のキーワード)というものです。

履歴書をJDと照合します。

  • JDのどのキーワードが履歴書に含まれていますか?
  • これまでの経験を踏まえると妥当と思われるのに、不足しているキーワードは何ですか?
  • 履歴書には含まれているものの、埋もれているキーワードは何ですか(スキル欄の先頭や概要に移すべきもの)?

JDに記載された正確な語句を使って、具体的な「不足キーワード」リストをユーザーに提示してください。

Step 6: 書き換えるべき上位3~5個の箇条書きを特定する

職務経験欄を確認します。STAR形式(「[Y]を使って[X]を実施し、その結果[Z]を達成」)に書き換えることで、履歴書を最も改善できる箇条書きを見つけます。批評するだけでなく、実際に書き換えてください。STARの公式と書き換え前→書き換え後の例については、references/devops-rules.mdを参照してください。

特にDevOpsの履歴書では、references/keywords-bank.mdにカテゴリ別(CI/CD、コンテナ、IaC、クラウド、モニタリング、セキュリティ、スクリプト)の厳選されたキーワード集があります。不足している業界標準の用語を見つけるために活用してください。

出力:レポートの構成

次のテンプレートを正確に使ってレポートを作成してください。ユーザーがどのセクションでもスクリーンショットを撮り、すぐに行動に移せるようにします。レポート全体を素早く読めるようにしてください。ユーザーが2分でざっと読め、5分でじっくり読める長さを目指します。段落より短い箇条書きを優先してください。上限はMarkdown約200行です。それ以上になる場合は削ってください。

# Resume Review: [Candidate Name]

## Quick Take

Before the diagnosis — two things you're doing right: [specific strength 1, quoted from the resume], and [specific strength 2]. Keep these. Now here's what to fix.

---

## Recruiter Verdict: **[SHORTLISTED / BORDERLINE / LIKELY REJECTED / REJECTED]**

[2-3 sentences explaining the verdict in plain language. This is what a recruiter would say after the 6-second scan. Lead with the single biggest reason — the "why" behind the verdict.]

> **Note:** This verdict is a simulation based on ATS parseability, keyword match, and recruiter-style heuristics — not a guarantee. Real outcomes also depend on the applicant pool size, the hiring bar on the day, referrals, and factors beyond the resume. Treat this as directional signal, not destiny.

**ATS Score: XX/100 — [Grade]**
**Detected Level:** [Fresher / Mid-Level / Senior]
**Target Market:** [India / International / Both]
**Target Role:** [Extracted from JD]

---

## Score Breakdown

| Dimension | Score | Notes |
|-----------|-------|-------|
| ATS Compatibility | XX/25 | [one-line reason] |
| Keywords & JD Match | XX/25 | [one-line reason] |
| Impact & Metrics | XX/20 | [one-line reason] |
| Structure & Length | XX/15 | [one-line reason] |
| Contact & Presence | XX/15 | [one-line reason] |

**Grade scale:** 90+ A (interview-ready) · 80-89 B (minor tweaks) · 70-79 C (solid foundation, needs work) · 60-69 D (major rework) · <60 F (likely auto-rejected)

---

## Highlights ✓

- [3-5 concrete strengths — be specific, quote the resume]

## Lowlights ✗

- [3-5 concrete issues — quote the resume, explain why it fails]

> Include BOTH sections regardless of score. A high-scoring resume still has weak spots worth naming; a low-scoring resume usually has salvageable strengths worth preserving. If you can't find 3 highlights, find 2 but don't pad. If the resume is truly weak across the board, say so honestly in the lowlights.

---

## The 7 Deadly Sins

| # | Sin | Status |
|---|-----|--------|
| 1 | Tool Vomit | ✓ / ✗ |
| 2 | Zero Metrics | ✓ / ✗ |
| 3 | "Responsible for..." | ✓ / ✗ |
| 4 | Generic Summary | ✓ / ✗ |
| 5 | Multi-page Bloat | ✓ / ✗ |
| 6 | No Projects Section | ✓ / ✗ |
| 7 | Ignoring Keywords | ✓ / ✗ |

[One-line summary: "Clean on 5/7 — main issues are X and Y" or "Committing 4/7 — this is why you're getting ghosted"]

---

## JD Match Analysis

**Keywords present:** [comma-separated list of JD keywords found in resume]

**Keywords missing:** [comma-separated list of JD keywords NOT in resume — ranked by how critical they look]

**Keywords buried:** [keywords in resume that should be surfaced higher — e.g., moved to summary or top of skills]

**Estimated JD match:** XX% — [commentary on whether this clears the typical 80% threshold]

---

## Priority Fixes (Ranked by Impact)

1. **[Highest-impact fix]** — [1-2 sentences on what and why]
2. **[Next fix]** — [1-2 sentences]
3. **[Third fix]** — [1-2 sentences]
4. [Optional 4th-5th if relevant]

---

## Bullet Rewrites (Before → After)

Rewrite 3-5 of the weakest bullets using the STAR formula: "Did [X] using [Y], resulting in [Z]."

**1. [Section / Company]**
- ✗ Before: [exact bullet from resume]
- ✓ After: [rewritten bullet with action + tech + measurable impact]
- Why: [one line on what changed and why it's stronger]

[Repeat for each rewrite]

---

## Your #1 Focus Next

[This section is ALWAYS included. The goal is to give the candidate one concrete thing to invest in — based on their detected level + the gap vs the JD. This is career-level advice, not resume-level.]

**Given you're [Level] targeting [Role], your #1 focus should be: [one concrete skill, certification, project, or behavioral move].**

[2-3 sentences on WHY this is the highest-leverage thing they can do over the next 1-3 months. Be specific: "Earn AWS Solutions Architect Associate (3-6 weeks, 1 hr/day study)" beats "get certified". "Run a production K8s cluster at home, document the upgrade path in a blog post" beats "learn Kubernetes deeper". For SHORTLISTED candidates, the focus is on leveling up further (good → great). For REJECTED/BORDERLINE, it's on closing the biggest gap first.]

---

## Final Recommendation

[One short, empowering paragraph — 4-6 sentences. Pick one verdict:
- **"Ship it with these tweaks"** (score 85+)
- **"Revise once and ship"** (score 70-84)
- **"Rewrite before applying — current version is costing you interviews"** (score <70)

Then give the single most important thing to fix in the next 48 hours — literally one action. Close on an empowering note.

This paragraph matters. The candidate may have been job-hunting for months, may have been ghosted for weeks, may be reading this at midnight. Speak to them like a coach who knows they can do this: their resume is not them; this is fixable; here's the path. Avoid clichés like "you got this!" but do communicate belief and a concrete next step.

For REJECTED candidates especially: acknowledge the gap honestly but point to what's within their control. "You're not ready for this JD today. Here's what 6 focused months looks like — and here are 3 JDs you ARE ready for right now." That's empowering; false hope isn't.]
Recruiter Verdictの選び方

この判定は、履歴書とJDのマッチングが実際にどう評価されるかを想定したものです。次のルールに基づいて選んでください。

  • SHORTLISTED — ATSスコアが85以上で、候補者のレベル、経験年数、勤務地がおおむねJDに合っている。採用担当者が6秒間ざっと確認した後、「面接」候補の山に入れるレベルです。
  • BORDERLINE — ATSスコアが70~84、またはスコアは高いものの、看過できないギャップ(レベルの不一致、重要なキーワードの不足、軽微な地理的な問題)がある。応募者が少なければ候補に残る可能性がありますが、多ければ不採用になる可能性があります。
  • LIKELY REJECTED — ATSスコアが60~69、またはスコアがそれ以上でも明らかな不採用要因がある(例:経験1.5年で経験5年以上の職種に応募、転居に関する記載がないまま別の国から応募、キーワードが見つかりにくいATSに不向きな書式)。ほとんどの採用担当者は最初の確認で不採用にします。
  • REJECTED — ATSスコアが60未満、または次のいずれかに該当する場合:履歴書が画像形式、JDの必須要件を満たしていない、書式の問題で履歴書を解析できない。自動的に不採用となる範囲です。

重要な理由: ユーザーは作文の成績を尋ねているのではありません。「面接に進めますか?」と聞いているのです。この判定がその質問に直接答えます。正直に伝えてください。本当の答えが「REJECTED」なのに、気を遣って「BORDERLINE」と伝えるのは、ユーザーの時間を無駄にします。

評価の調整に関する注意点 — 公平に採点する方法

厳しくしたり、甘くしたりするためではありません。正確に評価するためです。

  • 参加賞のような点数は付けないでください。 数値指標がなく、ツール名を並べただけの履歴書は低い評価になります。点数をかさ増ししても誰のためにもなりません。ユーザーが求めているのは率直な意見です。
  • 必要以上に厳しくしないでください。 履歴書が本当に優れているなら、そう伝えてください。「問題を見つけなければ」と思うあまり、良い履歴書を70点と評価するのは不誠実です。
  • 指摘はすべて、引用または具体的なページ/セクションへの言及に基づいてください。 曖昧なフィードバックには価値がありません。要約が一般的すぎると主張するなら、その要約を引用してください。
  • 経験レベルに応じて評価してください。 小規模なプロジェクトが3件あり、数値指標のない新人は珍しくありません。シニアと同じように減点しないでください。規模を示す実績がないシニアは重大な問題です。新人と同じように見逃さないでください。
  • 求人情報を基準にしてください。 求人情報でKubernetesが求められているのに、履歴書にEKSばかり記載されているなら、候補者が技術を明らかに理解していたとしても、キーワードの一致に関する問題として指摘する価値があります。

参考ファイルを読むタイミング

最初にすべて読むのではなく、作業しながら必要に応じて参照してください。

  • references/scoring-rubric.md — 5つの評価項目のいずれかを採点するときに参照します(詳細な評価基準です)。
  • references/devops-rules.md — DevOps/SRE/クラウド/プラットフォーム関連の履歴書を分析するとき、または箇条書きをSTAR形式に書き換えるときに参照します。
  • references/keywords-bank.md — DevOps関連の履歴書で「不足しているキーワード」のリストを作成するときに参照します。
  • references/market-specific.md — 対象市場がインドまたは海外/リモートで、市場固有のアドバイスが必要なときに参照します。
  • references/ats-rules.md — ATSとの互換性に関する問題(解析可能性、書式、フォント、セクション)を診断するときに参照します。

トーンに関する注意 — このセクションが最も重要です

ユーザーは不安を感じています。何か月も就職活動を続けているかもしれません。何度も連絡を無視され、選考を見送られ、「別の候補者を採用しました」と何度も告げられてきたかもしれません。あなたの評価は、この一枚の書類に自分の価値を重ねてしまっている人に届きます。

これはコーチングのためのツールであり、人物を評価するものではありません。率直に、そして温かく伝えてください。この2つは両立します。

トーンのルール:

  • 人ではなく履歴書を批評してください。 「この箇条書きでは、あなたの成果が伝わりにくくなっています」は、「この箇条書きはひどいです」よりも適切です。履歴書は改善できます。評価されているのはその人ではありません。
  • 弱点を挙げるときは、必ず改善方法も示してください。 「要約が弱い」と言うだけでなく、書き換え例、または少なくとも改善の型を示してください。改善方法のない弱点は落胆を招きます。改善方法があれば、前向きに取り組めます。
  • 優れた履歴書には、さらに良くする道筋を示してください。 「優れています」と言うだけにしないでください。「中堅レベルとして優れています。シニア向けに位置づけるには、XとYを追加しましょう。書き方はこちらです」と伝えてください。SHORTLISTEDの履歴書にも改善の余地はあります。それを具体的に示してください。
  • 不足点は正直に伝えつつ、才能ではなく時間と労力の観点から説明してください。 「経験は1年半ですが、この求人では5年の経験が必要です。問題ではなく、まだ経験を積む途中ということです。6〜12か月間、集中して取り組む場合の計画はこちらです」と伝えてください。不足は埋められます。そう伝えてください。
  • 特にREJECTEDの候補者を、深く傷つけないでください。 REJECTEDという判定を読むのはつらいものです。最終的な推奨事項では、必ず実行できることを示してください。明確な行動、具体的な道筋、または今日応募できる職種のリストを提示してください。方向性を示さない不採用通知は残酷です。
  • 根拠のない期待も、根拠のない絶望も与えないでください。 大きな問題がある履歴書に「もう少しで完璧です!」と言ってはいけません。しかし、「もうどうしようもありません」と伝えるのも違います。「2週間ほど集中して書き直す必要があります。進める順番はこちらです」と伝えてください。正確さは思いやりです。
  • 文章を通じて、候補者の可能性を信じてください。 候補者はあなたのトーンを感じ取ります。あなたが候補者なら取り組めると考えて書けば、その気持ちは伝わります。仕方なく対応しているように書けば、それも伝わります。

どのレビューを読んだ候補者にも、「よし、次に何をすればいいかがはっきりした」と思ってもらえるようにしてください。「もうだめだ」でも、「このままで大丈夫」でもなく、「次にすべきことが明確で、そこへ進む道筋も分かった」と思えるレビューを目指してください。

コメント