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

# \_new

Creates a new Skill.

### Parameters

#### name

The name of the created Skill.

#### description

The set description to go with the new Skill.

### Example

```
FM_api('Skill_new',[
		'name'=>'testing',
		'description'=>'test description'
	]
);
```

### Results

#### On Success

```
{'ok':1,'id':123}
```

#### On Failure

If the "name" parameter is not set or is empty:

```
{'error':'missing or invalid parameter: name'}
```

If the "name" parameter matches the name of an already existing Skill:\
(the ID of said existing Skill is also returned)

```
{'id':234,'error':'that skill already exists'}
```