> 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.md).

# Competency models

Competency models, also known as ontologies, define the skills a simulation scores.

Competency models, also known as ontologies, are the main tool behind the Scoring Feedback feature. They define the skills (also called user attributes) and the scoring structure used to evaluate learner performance during a simulation. This lets a simulation connect user actions to measurable skills and produce consistent performance ratings and skill mastery percentages.

Results from a competency model are logged to the learner's account and used to track performance over time. This is different from a score shown only inside a simulation, which is not logged to user data. See How scores work.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FKdWvNSUPXIizAqXJWBc6%2FScreenshot%202026-06-23%20103604.png?alt=media&#x26;token=a9857c1e-354f-410a-bda9-60500ada5e97" alt=""><figcaption><p>Example of the Sales Excellence Competency Model. Each of the green boxes represent user attributes that can be directly measured and included into HyperSkill.</p></figcaption></figure>

{% hint style="info" %}
**Access to features regarding competency models requires special permission that is only granted upon request.** To request access, contact <support@siminsights.zendesk.com>.
{% endhint %}

## How the three tools fit together

Competency models rely on SimGenie, HyperSkill Studio and HyperSkill Platform together:

1. **SimGenie**: models are created and managed here. See Competency models in SimGenie.
2. **HyperSkill Studio**: models are deployed here to power scoring inside simulations. See Competency models in HyperSkill.
3. **HyperSkill Platform**: the resulting scores and session data are reviewed here. See Competency models in the HyperSkill Platform.

For how the resulting numbers are calculated, see How scores work.