Normalize skill labels¶

POST /lexi/api/v1/skills/normalize_labels

This endpoint converts skill labels into shorter, cleaner and more consistent versions.

Purpose¶

It prevents unnecessary variants in a catalog.

Examples:

Before	After
`Advanced negotiation`	`Negotiation`
`Communication strategy definition`	`Communication strategy`
`French language proficiency`	`French language`
`API design`	`API design`
`SQL`	`SQL`
`writing reliable SQL queries`	`Writing reliable SQL queries`

Request from Lexi¶

{
  "skills": [
    "Advanced negotiation",
    "Communication strategy definition"
  ],
  "skillFormat": "noun-only"
}

Processing¶

AI Hub receives the list of labels.
A style rule is added when skillFormat is supplied.
The LLM simplifies each label without changing its meaning.
It preserves the original language.
It returns a mapping from the original label to the normalized label.

Generation uses the configured mini profile. Labels start with an uppercase letter while preserving acronyms and proper-name capitalization; this does not mean capitalizing every word. A short, clear label that already complies retains its exact wording and capitalization unless a supplied format rule requires a grammatical change. For example, API design stays API design, not API Design. The prompt explicitly checks sentence case: Writing reliable SQL queries keeps ordinary words lowercase while preserving SQL. Original mapping keys retain their exact input spelling and casing.

Response to Lexi¶

{
  "Advanced negotiation": "Negotiation",
  "Communication strategy definition": "Communication strategy"
}

Useful contexts¶

Context	Effect
`noun-only`	Enforces a noun form. Example: `manage a project` becomes `project management`.
`verb-subject`	Enforces an action form. Example: `project management` becomes `manage projects`.
Free text	Adds a custom style rule.

The generated lexi HTTP reference is the authoritative source for parameters, schemas, responses and examples.