> ## 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 overview

> How skills, skills profiles and learner actions fit together in Opigno Enterprise

Skills let you define what each learner is expected to be able to do, see what they can actually do today, and close the gap one skill at a time. The expected skills come from a **skills profile** (typically matching a job), and the way a learner can close each gap depends on how **critical** that skill is for them.

> [!NOTE]
>
> **NOTE:** Skills, skills profiles and AI-generated skill trainings are managed in the back office by **administrators** and **global content editors** (users with no hierarchy level assigned). Managers can review the skills claimed by learners within their own scope.

> [!NOTE]
>
> The Skills feature is available on the **Corporate** plan only.

## Key concepts

| Concept | Description |
| :- | :- |
| **Skill** | A competency in your organization's skill framework. Skills are organized in a tree: each skill has at most one parent. |
| **Top-level skill** | A skill with no parent. It is the root of its own branch. |
| **Sub-skill** | A skill nested under another skill. All sub-skills must be acquired before their parent skill can be worked on. |
| **Prerequisite** | A top-level skill whose whole branch must be completed before a learner can start another top-level skill's branch. |
| **Skills profile** | A reusable set of top-level skills, each with a criticality, that describes what is expected for a role. |
| **Target skill** | A top-level skill expected of a learner, either through their skills profile or assigned individually. |
| **Criticality** | How strictly a target skill must be proven: **Essential**, **Important** or **Accessory**. |

## Setting up skills: the overall process

Skills work end to end only when each of the following steps is in place. Follow them in this order.

**1. Create the skills**

Build your skill framework: top-level skills, their sub-skills, and any prerequisites between top-level skills. Optionally assign skills to activities. See [Managing skills](https://docs.opigno.com/skills/managing-skills.md).

**2. Create skills profiles**

Group top-level skills into profiles (for example, one per job) and set the criticality of each skill. You can create a profile manually or let AI draft one from a job description. See [Skills profiles](https://docs.opigno.com/skills/skills-profiles.md).

**3. Assign skills profiles to learners**

Assign one skills profile to each learner. Its skills become the learner's target skills. See [Assigning a profile to learners](https://docs.opigno.com/skills/skills-profiles.md#assigning-a-skills-profile-to-learners).

**4. Set the learners' initial skills**

From their **My Skills** interface, learners declare the skills they already have: by uploading their CV, from which AI suggests matching skills, or by claiming Accessory skills directly in the list. Skills that are not Accessory must then be approved by a manager or an administrator. See [Approving skills claimed by learners](https://docs.opigno.com/skills/approving-claimed-skills.md).

**5. Approve the AI-generated trainings and tests**

Each skill has one training and one question pool generated by AI. Review and approve them in the back office, from **Skills** > **Review training content**, before learners use them. See [Approving AI-generated trainings and tests](https://docs.opigno.com/skills/approving-skill-trainings.md).

**6. Learners close their skills gap**

Learners see their target skills with what is acquired and what is missing, and work through the missing skills one by one: they can **claim**, **test** or **train**, depending on the skill's criticality (see below).

## Skill statuses

For every skill, each learner has one of the following statuses, together with a progress percentage:

| Status | Meaning |
| :- | :- |
| **Acquired** | Verified by Opigno through a score: the learner passed the skill quiz, or answered 3 consecutive activities associated with the skill with a score above 90%. |
| **Claimed** | Declared without score-based verification: claimed by the learner (Accessory skills only) or approved by a manager from the learner's initial skills. |
| **Not acquired** | Neither acquired nor claimed yet. |

For a skill with sub-skills, progress reflects the share of its sub-skills already acquired or claimed. The skill reaches 100% only once all its sub-skills are complete and the skill itself is acquired or claimed.

## What learners can do, by criticality

A learner always works on skills that are **available** to them. A skill is **locked** while:

* some of its sub-skills are not yet acquired or claimed (learners progress through a branch from the bottom up), or
* the branch of a prerequisite skill is not yet complete.

![Locked Essential skill showing its prerequisite and progress](https://mintcdn.com/connect-i/NhsyrrIolaJeemg1/images/learner-skill-locked-prerequisites.png?fit=max\&auto=format\&n=NhsyrrIolaJeemg1\&q=85\&s=a4befa3d7b9bda7ae011ba5b05b1f6a1)

A skill locked until its prerequisite is complete

For an available skill, the options depend on its criticality for that learner:

| Criticality | Start skill training | Test skill | Claim skill |
| :- | :-: | :-: | :-: |
| **Essential** | ✓ (mandatory) | — | — |
| **Important** | ✓ | ✓ | — |
| **Accessory** | ✓ | ✓ | ✓ |

* **Start skill training** opens the skill's training. It ends with a quiz drawn from the skill's approved question pool.
* **Test skill** opens a quiz directly, so learners who already master the skill can prove it without taking the training.
* **Claim skill** marks the skill as **Claimed** (100%) without any proof and unlocks the next skill.

![Essential skill with acquired, locked and available sub-skills](https://mintcdn.com/connect-i/NhsyrrIolaJeemg1/images/learner-skill-essential.png?fit=max\&auto=format\&n=NhsyrrIolaJeemg1\&q=85\&s=4d12d9f12b88179ee874d3fe9467c9e1)

An Essential skill: sub-skills are completed bottom-up, and training is the only option

![Important and Accessory skills with their available actions](https://mintcdn.com/connect-i/NhsyrrIolaJeemg1/images/learner-skill-important-accessory.png?fit=max\&auto=format\&n=NhsyrrIolaJeemg1\&q=85\&s=b35a812d34769542b6b0601e071b640c)

Important skills offer Start training and Test skill; Accessory skills add Claim skill

### When the quiz score is below the minimum score

The minimum score is defined in the back office, in the **Skills** section, under **Skill training settings**.

| Criticality | After a failed test | After a failed training quiz |
| :- | :- | :- |
| **Essential** | — | The learner keeps taking new quiz attempts until they reach the minimum score. |
| **Important** | The learner must take the training. | The learner keeps taking new quiz attempts until they reach the minimum score. |
| **Accessory** | The learner can start the training or claim the skill. | The learner can **explore more** (take another quiz) or **stop there** (the skill is set to Claimed). |

Every successful quiz sets the skill to **Acquired** (100%).

> [!NOTE]
>
> Within this flow, only **Accessory** skills can end up as **Claimed**. **Important** and **Essential** skills always end up as **Acquired**, through a verified score. Two paths are not restricted by criticality: acquiring a skill through activities (always score-verified), and the initial skills approved by a manager (the human approval provides the check).

### How criticality is inherited

Criticality is set only on top-level skills, in the skills profile (or when a target skill is assigned individually).

* **Sub-skills** inherit the criticality of their top-level skill.
* **Prerequisites** inherit at least the criticality of the skills that depend on them. For example, if *Data analysis* is a prerequisite of an **Essential** skill, *Data analysis* is treated as **Essential** for that learner, even if the profile sets it as **Accessory**. Inherited criticality can raise a skill's criticality, never lower it.

## Where learners see their skills

Learners see their target skills on the **My Skills** page of the learner portal, in two tabs: **Skills profile** and **Individually assigned skills**. The page shows:

* their overall progress toward the profile, with the number of skills mastered, ready to start and still locked;
* their **skill shape**, a chart comparing their progress with the full profile;
* **Where to focus**: the top-level skills still to complete, with their criticality;
* the list of top-level skills with their criticality, which can be expanded to show sub-skills. Acquired and claimed skills, locked skills and the next suggested skill are clearly marked, and the available actions are shown on each skill.

![My Skills page with overall progress, skill shape chart and where to focus](https://mintcdn.com/connect-i/NhsyrrIolaJeemg1/images/learner-my-skills-summary.png?fit=max\&auto=format\&n=NhsyrrIolaJeemg1\&q=85\&s=228375c183e4bdc0126a805670e1981f)

The My Skills page of a learner

Clara, the AI assistant, is available at every step to explain the training content or clarify quiz questions.

## Related pages

> **[Managing skills](https://docs.opigno.com/skills/managing-skills.md)**
>
> Create skills, sub-skills and prerequisites.

> **[Skills profiles](https://docs.opigno.com/skills/skills-profiles.md)**
>
> Define the skills expected for a role and assign them to learners.

> **[Approving claimed skills](https://docs.opigno.com/skills/approving-claimed-skills.md)**
>
> Review the initial skills declared by learners.

> **[Approving AI-generated trainings](https://docs.opigno.com/skills/approving-skill-trainings.md)**
>
> Review the training and question pool of each skill.


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