jd-process

Normalize raw job descriptions into scored JD files and tracker entries.

4|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/ferez96/career-path-2026 --skill jd-process
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jd-process
Source: https://github.com/ferez96/career-path-2026/tree/main/docs/skills/jd-process
Command: npx skills add https://github.com/ferez96/career-path-2026 --skill jd-process

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the manual effort of turning a messy raw job description into a structured, scored, and tracker-ready opportunity entry.

Core Features & Use Cases

  • End-to-end JD normalization: Extracts job summary fields and skill/responsibility sections into a standardized template without guessing missing company details.
  • Company research & reuse: Reuses or refreshes a canonical company brief, then ties it to the role for fit analysis.
  • Fit/gap scoring + reporting: Computes a weighted fit score against your master profile, summarizes gaps, and produces optional analysis/decision reports.
  • Opportunity tracker integration: Prepares YAML snippet and updates the JD catalog with the new or re-opened role logic.

Quick Start

Use the jd-process skill with your raw JD text or the path to data/raw/<FILENAME>, then confirm the extracted company label (if missing) and choose whether to generate the optional analysis reports.

Frequently Asked Questions about jd-process

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

FAQPage Schema
How do I normalize raw job descriptions into a structured YAML template?

To normalize a job description, provide the raw JD text or a file path to trigger extraction into a standardized template. This process parses summary fields and skill sections into structured YAML frontmatter without guessing missing company details.

How does fit scoring work against a master profile with configurable weights?

Fit scoring computes a weighted match score by comparing normalized JD requirements against your master profile. It summarizes identified gaps and generates optional analysis or decision reports to help evaluate whether the opportunity aligns with your career goals.

Can I reuse and refresh existing company briefs for new job description intake?

Yes, company research and reuse allows you to refresh a canonical company brief and tie it to a new role. This ensures consistent employer context across multiple job descriptions without manually re-entering background information for fit analysis.

How do I track job opportunities and update the JD catalog for re-opened roles?

Opportunity tracking prepares a YAML snippet for the tracker schema and updates the JD catalog. It performs ID collision checks against config/jd_catalog.csv and applies conditional branching logic to handle new roles, re-posts, and re-opened positions automatically.

What is gap analysis and when do I need it for career planning workflows?

Gap analysis identifies missing skills or experience between a job description and your master profile during the scoring process. It is needed when evaluating role fit for career planning, producing summarized gap outputs that highlight areas for development before applying.

Do I need YAML frontmatter to automate job description processing?

Yes, YAML frontmatter-driven execution is required to automate end-to-end JD intake, normalization, and scoring. It drives the template extraction, company brief reuse, fit scoring, and opportunity tracker integration across the entire career planning workflow.