> For the complete documentation index, see [llms.txt](https://docs.siminsights.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siminsights.com/scoring-and-mastery/competency-models-in-hyperskill.md).

# Competency models in HyperSkill

Attaching a competency model to a simulation and setting user attributes from it.

In HyperSkill, you can add any deployed competency model to your own simulations. Once a model is added, HyperSkill records how every learner who plays the simulation performs on the model's user attributes. These are the leaf nodes of the model, shown as the green boxes in a competency model diagram (also called observable nodes). Every learner's score on each attribute is rated from 0.0 to 1.0, where 1.0 is the best performance and 0.0 is the worst.

A competency is not the same as a score. A score is displayed to the learner in that session only. A competency is a profile stat built from multiple simulations that measure the same skill. See [How scores work](https://docs.siminsights.com/scoring-and-mastery/how-scores-work).

After a learner session, the data is displayed on the dashboard. See Competency models in the HyperSkill Platform.

{% hint style="info" %}
Note: The default weighting for all user attributes is equal, meaning every user attribute contributes equally to the final overall performance rating of the learner.
{% endhint %}

## Add a competency model to a simulation

1. Open the **Settings** tab in the top bar of the simulation.
2. Open the **Data & Platform** tab in settings.
3. Add the desired competency model in the **Competency Models** section.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FbfB55ErYqqNjeXYiB61O%2FScreenshot%202026-06-24%20101852.png?alt=media&#x26;token=de4d7186-5bfe-4e0f-8092-9fe09de83597" alt=""><figcaption></figcaption></figure>

## Set user attributes

After adding a competency model, you can change user attributes in three ways:

* **Scenario Flow**: click the **Set User Attribute** State Action under the **Actions** tab.
* **Rules**: click the **Set User Attribute** option under the **then do all of these actions** tab.
* **Agents**: add a User Attribute output in the **Output** section of the **AI** tab.

{% hint style="info" %}
Note: Your account must have Skillful access to change user attributes through agents.
{% endhint %}

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FQF23HIROCZ2dsHnS5pBv%2FScreenshot%202026-06-24%20105255.png?alt=media&#x26;token=6e1f1417-a9d7-4b68-b0a9-1707f8ad367f" alt=""><figcaption><p>Example of the Set User Attribute action under the Scenario Flow tab.</p></figcaption></figure>

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FhFu7hsrqST1eYYtVYx5i%2FScreenshot%202026-06-24%20105352.png?alt=media&#x26;token=bc811827-dcd3-4ee8-965d-1d53d2558316" alt=""><figcaption><p>Example of the Set User Attribute action under the Rules tab.</p></figcaption></figure>

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FNR7Qh7BhnNkFB5ndZ1FZ%2FScreenshot%202026-06-24%20104957.png?alt=media&#x26;token=f513e244-cda3-43e9-8aa1-a3135339f6bc" alt=""><figcaption><p>Example of the Set User Attribute section of the Output tab for Agents.</p></figcaption></figure>
