> For the complete documentation index, see [llms.txt](https://emotiv.gitbook.io/cortex-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://emotiv.gitbook.io/cortex-api/advanced-bci/mentalcommandgetskillrating.md).

# mentalCommandGetSkillRating

This method returns the skill rating of a mental command action, or the overall mental command skill rating. This is a measure of how often you can trigger the desired action as measured in the previous trainings. A higher rating indicates stronger ability to perform that action.

{% hint style="warning" %}
**Deprecated**: this method is superseded by [mentalCommandBrainMap](/cortex-api/advanced-bci/mentalcommandbrainmap.md) and will be removed in the future.
{% endhint %}

## Parameters

| Name        | Type     | Required | Description                                                                                |
| ----------- | -------- | -------- | ------------------------------------------------------------------------------------------ |
| cortexToken | `string` | yes      | A token returned by [authorize](/cortex-api/authentication/authorize.md).                  |
| profile     | `string` | no       | A profile name.                                                                            |
| session     | `string` | no       | A session id returned by [createSession](/cortex-api/session/createsession.md).            |
| action      | `string` | no       | The mental command action. If omitted, then this method returns the overall skill ratting. |

You must set one of these 2 parameters: **profile** or **session**. [Read this](/cortex-api/advanced-bci.md#profile-name-or-session-id) for details.

## Result

The result is a `number` that is the requested skill rating.

## Examples

{% tabs %}
{% tab title="Request" %}

```javascript
{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "mentalCommandGetSkillRating",
    "params": {
        "cortexToken": "xxx",
        "session": "xxx",
        "action": "push"
    }
}
```

{% endtab %}

{% tab title="Response" %}

```javascript
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": 0.25
}
```

{% endtab %}
{% endtabs %}