> For the complete documentation index, see [llms.txt](https://docs.ag5.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ag5.com/skills/rating-scales.md).

# Rating scales

### 1. What is a rating scale?

A rating scale is a scale that can be used in skills management to define the skill level of an employee for a specific skill. 

### 2. What is the purpose of a rating scale?

The purpose is to have an accurate understanding of someone's skill level. 

### 3. How to create and use rating scales?

In AG5 you are able to create multiple rating scales. But, you can only use one rating scale per skill. So it is important to define what rating scale you want to use for your skill. 

The important attributes of a rating scale level are: 

* **Name**: This is the name of the level.
* **Description**: Here you can describe the meaning of the level. 
* **Code**: Here you can use a unique code for this level.

> The level descriptions can be made visible while adding results. 

![](https://cdn.elev.io/file/uploads/tfNHbase18C9irCYFEYUJIWBYNbJEZKpwfnSxeUHdUg/ozHKS-lU0EqL0555rkcHRRisSsjDSziIJRrI7qzWnhs/RatingScales-a6c-VnY.jpg)

You can create/define a new rating scale on the rating scale page. For this, you go to Organization > Rating scales. See the below video on how to create a new rating scale. 

![](https://cdn.elev.io/file/uploads/D1BCUVNmpfyNXS3qGXZdLFMfdrUiR9tXejv0vEBzhc4/wiLoocwZMLK4Ke9CWoDUQVXd9ej8sOfqPGlf0tG1X1g/CreateARatingscale-Tbc.gif)

### 4. Skill-specific level descriptions?

Each skill has a certain rating scale. And this rating scale can be used for different skills.  But, the meaning of each rating scale level can be different per skill. And to make sure every user has the same understanding of what exactly each level means you can describe each level within the skill detail page. 

Read in [this article](/skills/level-descriptions.md) all about defining skill-specific level descriptions.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ag5.com/skills/rating-scales.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.