Skill Gap Analysis
Identify missing skills between a candidate's current profile and a target role or career goal.
POST /v1/hiring/skill-gap-analysis
Compares a candidate's current skills and experience against a target role or career aspiration. Returns a prioritised gap list, learning recommendations, and estimated time-to-readiness.
Required inputs
| Field | Type | Notes |
|---|---|---|
input.user_id | string | Your platform's user ID |
input.profile | ProfileInput | Current skills and experience |
Optional inputs
| Field | Type | Notes |
|---|---|---|
input.resume | ResumeInput | Resume text for additional context |
input.job_description | JobDescriptionInput | Target role to analyse gaps against |
input.career_goals | CareerGoalsInput | Target role if no JD is provided |
Example request
curl -X POST https://api.liyaengine.ai/v1/hiring/skill-gap-analysis \
-H "Authorization: Bearer $LIYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"user_id": "usr_123",
"profile": {
"skills": ["JavaScript", "React", "Node.js"],
"experience_level": "mid",
"years_of_experience": 3
},
"job_description": {
"title": "Senior Full-Stack Engineer",
"description": "...",
"required_skills": ["TypeScript", "AWS", "system design", "PostgreSQL"]
}
}
}'Response
{
"success": true,
"data": {
"output": {
"target_role": "Senior Full-Stack Engineer",
"overall_readiness": {
"overall_score": 58,
"confidence": { "score": 0.85, "level": "high" },
"components": [
{ "name": "Skill Coverage", "score": 55, "weight": 0.6, "feedback": "Missing TypeScript and AWS, both listed as required." }
],
"interpretation": {
"level": "developing",
"summary": "Solid JS/React/Node foundation, but three required skills are not yet demonstrated."
}
},
"skill_gaps": [
{
"skill": "TypeScript",
"current_level": "none",
"target_level": "advanced",
"gap_severity": "critical",
"importance_for_goal": 90,
"estimated_time_to_close": "2-4 weeks",
"learning_resources": [
{ "resource_type": "tutorial", "title": "Official TypeScript docs", "cost": "free", "relevance_score": 95 },
{ "resource_type": "course", "title": "Execute Program TypeScript course", "cost": "low", "relevance_score": 88 }
],
"practice_suggestions": ["Convert an existing JS project to TypeScript"]
},
{
"skill": "AWS",
"current_level": "none",
"target_level": "intermediate",
"gap_severity": "critical",
"importance_for_goal": 85,
"estimated_time_to_close": "6-8 weeks",
"learning_resources": [],
"practice_suggestions": ["Deploy a small Node.js service to AWS Lambda + API Gateway"]
},
{
"skill": "system design",
"current_level": "basic",
"target_level": "advanced",
"gap_severity": "important",
"importance_for_goal": 70,
"estimated_time_to_close": "8-12 weeks",
"learning_resources": [],
"practice_suggestions": ["Practice designing 2-3 systems per week with feedback"]
}
],
"learning_path": [
{ "phase": "Weeks 1-4", "focus_area": "TypeScript fundamentals", "skills_to_develop": ["TypeScript"], "milestones": ["Ship a TypeScript-converted service"], "time_commitment": "5-8 hours/week" }
],
"quick_wins": [
{ "action": "Convert one existing JS module to TypeScript", "impact": "Demonstrates immediate applied learning", "time_required": "1 weekend" }
],
"timeline": {
"estimated_total_time": "12-16 weeks",
"readiness_projection": [
{ "date": "2026-04-01", "projected_readiness": 58 },
{ "date": "2026-06-01", "projected_readiness": 80 }
]
},
"actions": [
{ "action_id": "create_learning_plan", "action_type": "primary", "title": "Build learning plan", "priority": 1 }
],
"confidence": { "score": 0.85, "level": "high" }
}
}
}