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

1## Get a skill by its ID.

2 

3`$ openai skills retrieve`

4 

5**get** `/skills/{skill_id}`

6 

7Get a skill by its ID.

8 

9### Parameters

10 

11- `--skill-id: string`

12 

13 The identifier of the skill to retrieve.

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 retrieve \

51 --api-key 'My API Key' \

52 --skill-id skill_123

53```

54 

55#### Response

56 

57```json

58{

59 "id": "id",

60 "created_at": 0,

61 "default_version": "default_version",

62 "description": "description",

63 "latest_version": "latest_version",

64 "name": "name",

65 "object": "skill"

66}

67```