Generate skill-level descriptions¶
This endpoint generates a contextual progression for every proficiency level of a skill. It does not modify data or determine the level required for a job.
Request¶
{
"skills": [
{
"skill_code": "SK-1",
"skill_title": "Python",
"skill_definition": "Ability to develop robust applications in order to deliver reliable software.",
"skill_group": "TECHNIQUE"
}
],
"skillLevelScale": 5,
"outputLanguage": "en",
"clientContext": "Software company with strict reliability requirements",
"debug": false
}
skills contains between 1 and 50 skills. skill_code, skill_title and
skillLevelScale are required; the scale must be 4 or 5.
skill_definition, skill_group and clientContext provide context without
allowing company-specific characteristics to be invented. The output language
defaults to en.
Response¶
{
"skills": [
{
"skill_code": "SK-1",
"skill_title": "Python",
"skill_definition": "Ability to develop robust applications in order to deliver reliable software.",
"skill_group": "TECHNIQUE",
"level_descriptions": {
"1": "Makes simple changes with guidance and regular review.",
"2": "Handles common cases using established practices with occasional support.",
"3": "Independently develops reliable components and resolves common problems.",
"4": "Designs complex solutions, evaluates technical tradeoffs and supports peers.",
"5": "Provides expertise in critical situations and improves team practices."
}
}
]
}
The response preserves each skill's metadata and provides exactly one non-empty description per level. Every text is normalized and limited to 200 characters. An incomplete AI response fails the entire request; no generic text is silently substituted.
Generation errors return 400 with
{"detail":"Error during skill level description retrieval"}.
The generated lexi HTTP reference is the authoritative source for parameters, schemas, responses and examples.