Skip to content

Sacarima/Ai-Job-Description

Repository files navigation

AI Job Description Skill Matrix

A tiny developer-facing tool that takes a job description (JD), runs it through an LLM-powered extractor (with a deterministic fallback), and returns a structured skill matrix + summary you can copy the json as needed.

AI JD Skill Matrix preview

1- Works with or without an OpenAI API key
2- Strongly typed with Zod + TypeScript
3- Clean UI built with Next.js App Router + Tailwind
4- Fallback parser (regex + keyword maps) so you always get a result


Features

  • Paste any job description into a textarea and click Analyze.

  • See a pretty-printed JSON result with the following shape:

    {
      title: string;
      seniority: "junior" | "mid" | "senior" | "lead" | "unknown";
      skills: {
        frontend: string[];
        backend: string[];
        devops: string[];
        web3: string[]; 
        other: string[];
      };
      mustHave: string[];
      niceToHave: string[];
      salary?: {
        currency: "USD" | "EUR" | "PLN" | "GBP";
        min?: number;
        max?: number;
      };
      summary: string;
    }

Running the app locally

  1. Clone the repo

    git clone https://github.com/<your-username>/ai-jd-skill-matrix.git
    cd ai-jd-skill-matrix
    
    npm install

or

pnpm install

OPENAI_API_KEY=your-openai-key-here

LLM feature flags

NEXT_PUBLIC_LLM_ENABLED=true NEXT_PUBLIC_LLM_STREAM_ENABLED=true

Optional safety limit for server-side calls

LLM_MAX_CALLS=20

About

Next.js app that converts job descriptions into a structured skill matrix with optional OpenAI analysis

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors