Job Description Skill

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

🌐 English · 中文

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:

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

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:

• offer-toolkit-skill — the all-in-one bundle (JD · Resume · BQ)
• resume-builder-skill — Resume Builder & Beautifier (11 print-ready templates)
• Behavior-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)

License

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

Created by Dreameryanyan · LinkedIn · X · Xiaohongshu