## Create a new skill.

`$ openai skills create`

**post** `/skills`

Create a new skill.

### Parameters

- `--files: optional array of string or string`

  Skill files to upload (directory upload) or a single zip file.

### Returns

- `skill: object { id, created_at, default_version, 4 more }`

  - `id: string`

    Unique identifier for the skill.

  - `created_at: number`

    Unix timestamp (seconds) for when the skill was created.

  - `default_version: string`

    Default version for the skill.

  - `description: string`

    Description of the skill.

  - `latest_version: string`

    Latest version for the skill.

  - `name: string`

    Name of the skill.

  - `object: "skill"`

    The object type, which is `skill`.

### Example

```cli
openai skills create \
  --api-key 'My API Key'
```

#### Response

```json
{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}
```