job-description-skill

Decodes job descriptions and resumes into a bilingual HTML offer strategy report.

109|15|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/yanliudesign/job-description-skill --skill job-description-skill-yanliudesign
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: job-description-skill
Source: https://github.com/yanliudesign/job-description-skill
Command: npx skills add https://github.com/yanliudesign/job-description-skill --skill job-description-skill-yanliudesign

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Job seekers struggle to tell what a job description really means, whether they match it, and whether applying is worth the effort. This Skill translates JD marketing language into the hiring manager's actual expectations, scores resume fit with an explicit rubric, predicts interview questions, and assembles everything into a single-file HTML Offer Strategy Report. ## Core Features & Use Cases - Five-layer JD decoding: Extracts the hiring manager's real needs, Must Haves, Nice to Haves, Hidden Signals, and level/team-stage judgment from any JD, using a keyword-to-intent dictionary. - Formula-based match scoring: Computes a Match Score (0.6/0.2/0.2 weighted across Must/Nice/Hidden) with three-tier gap classification and hiring-manager risk analysis, always as ranges rather than single points. - 10-section HTML report: Generates a bilingual (EN/ZH) single-file report with verdict, gauges, match matrix, salary reality check, referral playbook, top 10 interview questions, and a 6-week action plan, with in-page Export PDF and Export Markdown buttons. - Use Case: Paste an Anthropic Product Designer JD plus your resume, and receive an auto-opened HTML report telling you whether to apply (star rating), your 80-88% match range, two gaps with 4-week fixes, and the top interview questions to prepare. ## Quick Start Analyze this job description against my resume and generate the offer strategy report.

Frequently Asked Questions about job-description-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a job description against my resume?▼

Paste the JD link or full text, then provide your resume, LinkedIn full text, or a short self-introduction. The skill decodes the JD, computes a weighted match score with gaps and risks, and generates an HTML report that opens in your browser.

What does the offer strategy report include?▼

The report contains a TL;DR verdict with a 1-5 star rating, match score and interview probability gauges, company background, JD deep decode, a line-by-line JD-to-resume match matrix, gap cards, salary reality check, referral playbook, top 10 interview questions, and a 6-week action plan.

Can I run only one flow like match score without the full report?▼

Yes. If you explicitly ask for a single flow such as only decoding the JD or only computing the match score, the skill skips report generation and returns that flow's raw text output. The full HTML report is the default only for complete runs.

Does the job description analysis work without a resume?▼

Yes, via a short self-introduction path, but all match, tailor, and gap conclusions are flagged as unverified against a real resume. The skill recommends building a formal resume with the companion Resume Skill afterward.

Why does the exported PDF lose Chinese characters?▼

macOS system CJK fonts like PingFang SC cannot be embedded in PDFs. The report template loads Noto Sans SC and Noto Serif SC from Google Fonts and places them before system fonts in the CSS stack so Chinese text embeds correctly when saving as PDF.

How is the match score calculated?▼

Match Score equals 0.6 times Must Have score plus 0.2 times Nice to Have score plus 0.2 times Hidden Signal fit, with each requirement rated full, partial, or miss against resume evidence. Results are always given as ranges, and missing a must-have caps the total score.