Job Fit Agent

AI agent that evaluates candidate-role fit by analysing a resume alongside a job description, delivering a role-fit gap analysis report with actionable insights.

OVERVIEW

A job-fit evaluation agent that takes a resume and a job description as inputs and produces a structured compatibility report. The output covers skill alignment, experience gaps, qualification matches, culture-fit signals, and role-fit insights, giving both candidates and hiring managers an objective baseline for the conversation.

ARCHITECTURE

The agent operates through a Next.js API route that validates both inputs, applies per-IP rate limiting, constructs a dual-document analysis prompt, and streams structured evaluation results via SSE through OpenRouter. The client renders the fit report progressively as scored dimensions with evidence from both the resume and job description.

FUNCTIONALITY

  • Dual-input interface accepting resume text and job description simultaneously
  • Overall fit score with dimensional breakdown across skills, experience, qualifications, and culture signals
  • Gap analysis identifying missing requirements and suggesting mitigation strategies
  • Strength highlights matched with specific evidence from the resume
  • Role-fit insights surfaced from identified gaps and strengths
  • Streaming SSE delivery for progressive rendering of evaluation sections
  • Per-IP rate limiting with explicit 429 and retry-after contract
  • Model fallback chain for availability under provider failures

HOW IT WORKS

The user submits both a resume and a job description. The API validates input lengths, applies rate limits, then sends a structured evaluation prompt to OpenRouter with SSE streaming. The model analyses alignment across multiple dimensions including technical skills, domain experience, qualifications, and soft signals, producing scored sections with cited evidence from both documents. The client renders results as a progressive fit report with an overall score, dimensional breakdown, gap analysis, and actionable role-fit insights.

OUTCOMES

  • Gives candidates an objective view of their fit before applying or interviewing
  • Helps hiring managers structure interviews around identified gaps and strengths
  • Reduces bias by grounding evaluation in explicit evidence from both documents
  • Maintains operational safety with rate limits, input validation, and model fallback routing