# 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](https://emotiv.gitbook.io/cortex-api/advanced-bci/mentalcommandbrainmap) and will be removed in the future.
{% endhint %}

## Parameters

| Name        | Type     | Required | Description                                                                                           |
| ----------- | -------- | -------- | ----------------------------------------------------------------------------------------------------- |
| cortexToken | `string` | yes      | A token returned by [authorize](https://emotiv.gitbook.io/cortex-api/authentication/authorize).       |
| profile     | `string` | no       | A profile name.                                                                                       |
| session     | `string` | no       | A session id returned by [createSession](https://emotiv.gitbook.io/cortex-api/session/createsession). |
| 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](https://emotiv.gitbook.io/cortex-api/advanced-bci/..#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 %}