# assign-skills

Tags: fort | armok | units

Command: `assign-skills`

Adjust a unit’s skills.

Skills are defined by their token and their rank. You can see a list of valid skill tokens by running `devel/query --table df.job_skill` or by browsing the wiki.

## Usage

    assign-skills [--unit <id>] <options>

## Example

    assign-skills --reset --skills [ WOODCUTTING 3 AXE 2 ]

Clears all the unit skills, then adds the Wood cutter skill (competent level) and the Axeman skill (adequate level).

## Options

`--unit <id>`

  The target unit ID. If not present, the currently selected unit will be the target.

`--skills [ <skill> <rank> [<skill> <rank> ...] ]`

  The list of the skills to modify and their ranks. Rank values range from -1 (the skill is not learned) to 20 (legendary + 5). It is actually possible to go beyond 20 (no check is performed), but the effect on the game may not be predictable. There must be a space before and after each square bracket.

`--reset`

  Clear all skills. If the script is called with both this option and `--skills`, first all the unit skills will be cleared and then the listed skills will be added.

## Skill ranks

Here is the mapping from rank value to description:

Rank | Rank description
--- | ---
0 | Dabbling
1 | Novice
2 | Adequate
3 | Competent
4 | Skilled
5 | Proficient
6 | Talented
7 | Adept
8 | Expert
9 | Professional
10 | Accomplished
11 | Great
12 | Master
13 | High Master
14 | Grand Master
15+ | Legendary

For more information, please see: https://dwarffortresswiki.org/index.php/DF2014:Skill#Skill_level_names