> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opigno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills profiles

> Define the skills expected for a role, with their criticality, and assign them to learners

A skills profile is a reusable set of top-level skills, each with its own **criticality**, that describes what is expected for a role — for example *Sales manager* or *Quality engineer*. When you assign a profile to a learner, its skills become that learner's **target skills**, and the gap between these and the learner's current skills is what they work on.

> [!NOTE]
>
> **NOTE:** Skills profiles are managed by **administrators** and **global content editors**. Create your [skills](https://docs.opigno.com/skills/managing-skills.md) first: a profile can only contain existing top-level skills.

## Criticality

For each skill in a profile, choose how strictly it must be proven:

| Criticality | Meaning | Learner options |
| :- | :- | :- |
| **Essential** | Must be acquired through the skill training. | Start skill training |
| **Important** | Must be acquired. A quiz can fast-track it. | Start skill training, Test skill |
| **Accessory** | Can be self-declared without proof. | Start skill training, Test skill, Claim skill |

Sub-skills inherit the criticality of their top-level skill, and prerequisites inherit at least the criticality of the skills that depend on them. See [What learners can do, by criticality](https://docs.opigno.com/skills/overview.md#what-learners-can-do-by-criticality).

## Accessing skills profiles

Skills profiles are managed in the **Skills** section of the back office. The skills profiles overview page lists all existing profiles. From there, you can create, edit and delete profiles.

## Creating a skills profile manually

1. On the skills profiles overview page, click the button to add a new profile.
2. Enter the profile's **name**.
3. Add the profile's skills. For each skill:
   * select a **top-level skill** using the autocomplete field (new skills cannot be created here);
   * select its **criticality**: Essential, Important or Accessory.
4. Save the profile.

Skills profiles are translatable, and can be translated with AI like other content. See [Translations](https://docs.opigno.com/translations.md).

## Creating a skills profile from a job description with AI

Instead of building a profile from scratch, you can let AI draft it from a job description.

1. On the skills profiles overview page, click the button to **upload a PDF** with the job or role description.
2. The AI agent analyzes the document and creates a new, **unpublished** profile containing the applicable top-level skills, each with a suggested criticality.
3. Review the draft: remove or add skills, adjust criticalities, then publish the profile.

> [!NOTE]
>
> **NOTE:** The AI only selects skills from your existing skill framework — it never creates new skills. If it finds no applicable skill, a warning message is displayed and no profile is created.

## Viewing a profile's skills

The profile view shows its top-level skills with their criticality. For each skill:

* an icon indicates whether it has **prerequisites**; click it to display them as a tree, with the criticality of each prerequisite;
* another icon displays the skill's **sub-skills** as a tree.

## Assigning a skills profile to learners

Assign a profile to learners from **Manage users** on the learner platform.

* A learner can have **only one** skills profile. Assigning a new profile replaces the previous one.
* The profile's skills become the learner's target skills immediately.

### Assigning individual target skills

You can also assign a top-level skill to a learner individually, with its own criticality — for example, for a skill that is specific to that person and not to their role. Individual target skills are added to those of the learner's profile.

![Assign target skills action in Manage users](https://mintcdn.com/connect-i/Zismmh7okf2pVyjL/images/opigno-assign-arget-skill-learner.png?fit=max\&auto=format\&n=Zismmh7okf2pVyjL\&q=85\&s=a6084a7c5e1dfc4bc394bbf3365d4874)

## When a learner's profile changes

When a learner changes role and receives a new profile (or a new individual target skill):

* skills they have **acquired** are kept;
* skills they have **claimed** are kept, unless the skill now has a **higher criticality** than when it was claimed. In that case, the skill and all its sub-skills are reset, and the learner must prove them according to the new criticality.

## Following learners' progress

When a learner has target skills, their [statistics](https://docs.opigno.com/statistics.md) in the back office show a spider chart of those skills with their progress.

![User statistics spider chart of target skills](https://mintcdn.com/connect-i/Zismmh7okf2pVyjL/images/opigno-skills-chart.png?fit=max\&auto=format\&n=Zismmh7okf2pVyjL\&q=85\&s=f27ee9737966e29f857e3cfde77e5879)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.