Sandbox
@yanliudesign/job-description-skill

Claude skill for JD analysis and offer strategy reports

This skill reads a job description, compares it with your resume, and produces a one-page HTML offer strategy report. The report includes a should-I-apply verdict, match score, interview questions, salary check, gap analysis, and a six-week action plan.

98 stars14 forksUpdated 1mo ago
Who it's for

Builders who want their agent to decode job descriptions, score fit, and draft application strategy.

What it delivers

You can decide whether to apply and what to fix next without manually decoding the JD yourself.

What it does

JD decode flow

Breaks a job description into company signals, role scope, and hidden expectations.

Match scoring

Compares the JD against your resume with must-have, nice-to-have, and hidden-signal scoring.

Resume tailoring

Suggests how to adjust a resume for the role without inventing experience.

Interview prediction

Lists likely interview questions based on the JD and fit gaps.

Should-I-apply verdict

Gives a go or no-go recommendation with reasons and follow-up actions.

HTML offer strategy report

Assembles the outputs into a single report with sections, gauges, and export buttons.

How to get it

  1. 1Behavior-question-skill — Behavioral interview / story bank
    See a dream job → JD Skill (decode · match · should-I-apply)
                         ↓ decide to apply
                      Resume Skill (tailor + polish)
                         ↓ get the interview
                      BQ Skill (mine stories · mock interview)

README

中文 · English

🔍 Job Description Skill


Decode any JD → get a one-page Offer Strategy report. Should I apply · how well I match · top interview questions.

License Version Sections Stars

Claude Code Codex OpenCode OpenClaw Hermes

📦 Part of the offer-toolkit-skill — the full job-hunt bundle (JD · Resume · BQ). Install the bundle to get all three in one shot.

A Claude skill for reading job descriptions. Give it a JD and your resume, and it hands back an HTML report telling you: whether this job is worth applying to, how well you match it, where the gaps are, what interviews will probably ask, whether the salary is reasonable, and what to do over the next six weeks. A JD is rarely just a recruiting blurb — it's usually the hiring manager's real expectations wrapped in HR boilerplate, and this skill unwraps that.


How it works — just 3 steps

Invoke the skill with anything like "help me with this job" / "走一下这个 JD" and you go through exactly:

  1. Paste the JD — link or full text.
  2. Give it your resume — three options:
    • 🅰️ Upload / paste your full resume (recommended)
    • 🅱️ Paste your full LinkedIn
    • 🅲️ No resume yet → short self-introduction. Results will be flagged as "unverified against a real resume" and you'll be nudged toward Resume Skill to build one.
  3. HTML report auto-opens — a single-file Offer Strategy Report is generated to ~/Desktop/Claude skills/offer-strategy-<slug>.html and pops open in your browser. Inside: TL;DR verdict, two gauges, the 10 sections below, and in-page Export PDF / Export Markdown buttons.

That's the whole thing. No multi-step wizard, no separate "只解码" / "只算匹配度" outputs to wade through — the 5 internal flows (Decode / Match / Tailor / Predict / Should I Apply) all run silently and assemble into the same HTML report.

If you explicitly want only one flow ("only decode this" / "just match score") the skill skips the report and gives you the raw output for that one flow.


Offer Strategy Report · the 10-section framework

Every wizard run ends with a single-file HTML report at ~/Desktop/Claude skills/offer-strategy-<slug>.html. Fixed 10-section spine, plus a TL;DR preamble and a key-metrics gauge block:

Offer Strategy Report preview

Hero of an actual run — verdict + assumptions + TL;DR + two gauges, plus the in-page Export PDF / Export Markdown buttons in the bottom right.

More screenshots: English gallery · 中文相册

▶ Video walkthrough (~2 min)

▶ Play 2-min walkthrough — Anthropic × Product Designer, Claude Code

⬆ First 8 seconds auto-play as a preview. Click to watch the full 2-minute walkthrough — live run against a real Anthropic JD (paste JD → attach resume → HTML report opens in your browser, ~15 MB, opens in a new tab). 中文版本 · Chinese walkthrough.

#SectionWhat it answers
TL;DR · one-minute verdictShould I apply? ⭐ 1–5.
Key metricsMatch Score gauge + Interview Probability gauge.
1Company backgroundWho runs this place, what are the cultural signals, what shipped in the last 12–24 months.
2Product analysis for this roleWhat product / surface this role owns + the 4 core design challenges + the real scope behind the JD.
3JD deep decodeWhy this JD reads the way it does (JD 解码精华 + Hidden Signal dictionary hits).
4JD ↔ resume line-by-line matchMust Have cards + full Match Matrix (3 columns: JD ask / resume evidence / score+gap) + Nice + 10-dim Hidden Signal radar.
5Gap — what to upgrade2–4 gap cards with severity (high/middle) + 4-week mitigation.
6Why apply / why not3 reasons each side. Every "why not" comes with an HM probe response.
7Salary reality checkJD band + market data + negotiation talking points.
8Next stepCareer arc fit + referral playbook (who, DM template) + portfolio audit (4-week action list).
9Top 10 interview questions面试预测预览. Full Top 20 + behavior stories → hand off to BQ Skill.
106-week action planWeek-by-week to-dos: before applying / after applying / before interview.

The report supports Export to PDF (CJK-safe Noto font embedding) and Export to Markdown (single-file MD download). Spec: frameworks/offer-strategy-report.md · skeleton: examples/offer-strategy-template.html.


Three rules

  1. Decode before you act — Decoding the JD first is mandatory before doing match or tailor. Matching against the wrong target means the match is wrong.
  2. Never fabricate — Never invent experience, skills, or numbers the candidate didn't claim. If real evidence is missing, mark it ❌.
  3. One thing at a time — No mixing. If the decode step left ambiguity, clarify before moving on.

File Structure

job-description-skill/
├── SKILL.md                      # Entry · routing · three rules
├── prompts/                      # Execution prompts for each flow
│   ├── jd-decoder.md
│   ├── match-score.md
│   ├── resume-tailor.md
│   ├── interview-predictor.md
│   └── should-i-apply.md
├── frameworks/                   # Reusable frameworks / rubrics
│   ├── decode-patterns.md        # JD keyword → real intent dictionary
│   ├── match-rubric.md           # Scoring rubric (Must / Nice / Hidden)
│   ├── resume-tailoring.md       # Three-version resume strategy
│   ├── go-no-go.md               # ⭐ rating + interview probability formula
│   └── offer-strategy-report.md  # Final HTML report — sections, visual system, content rules
├── examples/                     # Reference skeletons (no personal data)
│   └── offer-strategy-template.html
└── jd-bank/                      # Local cache of analyzed JDs (gitignored)
    ├── _index.md                 # Index
    └── _jd-template.md           # Starter template for new JDs

How it thinks

  • A JD reflects three layers — company signals, the hiring manager's real expectations, and the product / role in question. The skill's job is to see through the HR packaging to those three.
  • Decide before you optimize — most candidates keep polishing resumes for the wrong roles. Decide whether to apply at all first.
  • Every score has a formula — not magic. Every Match Score and Interview Probability comes from an explicit formula in frameworks/. Disagree with the premise? You can argue back.

Related skills

Pairs with these two — decode the JD here, then hand off:

See a dream job → JD Skill (decode · match · should-I-apply)
                     ↓ decide to apply
                  Resume Skill (tailor + polish)
                     ↓ get the interview
                  BQ Skill (mine stories · mock interview)

License

MIT — fork it, remix it, ship your own version.

Created by Dreameryanyan · LinkedIn · X · Xiaohongshu

Files in the repo

Repository payload9 top-level entries
  • docs
  • examples
  • frameworks
  • jd-bank
  • prompts
  • .gitignore
  • README.md
  • README.zh.md
  • SKILL.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k
ayghri/
i-have-adhd

A skill to stop your coding agent from burying the answer. ADHD-friendly output.

38k
mvanhorn/
last30days-skill

AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary

62k
Nanako0129/
sepia

De-AI writing skill for any Agent Skills-compatible agent (77+ via the Skills CLI), with native plugins for Claude Code, Codex, Grok Build, and Antigravity. Narrative-architecture repair for fiction, venue-matched rules for professional prose. Based on StoryScope (arXiv:2604.03136).

2.5k
Imbad0202/
academic-research-skills

Academic Research Skills for Claude Code: research → write → review → revise → finalize

48k