cli/resources/skills/methods/create/index.md 2026-05-05 23:00 UTC to 2026-05-07 21:57 UTC

1## Create a new skill.

2 

3`$ openai skills create`

4 

5**post** `/skills`

6 

7Create a new skill.

8 

9### Parameters

10 

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

12 

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

14 

15### Returns

16 

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

18 

19 - `id: string`

20 

21 Unique identifier for the skill.

22 

23 - `created_at: number`

24 

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

26 

27 - `default_version: string`

28 

29 Default version for the skill.

30 

31 - `description: string`

32 

33 Description of the skill.

34 

35 - `latest_version: string`

36 

37 Latest version for the skill.

38 

39 - `name: string`

40 

41 Name of the skill.

42 

43 - `object: "skill"`

44 

45 The object type, which is `skill`.

46 

47### Example

48 

49```cli

50openai skills create \

51 --api-key 'My API Key'

52```

53 

54#### Response

55 

56```json

57{

58 "id": "id",

59 "created_at": 0,

60 "default_version": "default_version",

61 "description": "description",

62 "latest_version": "latest_version",

63 "name": "name",

64 "object": "skill"

65}

66```