use-cases/reusable-codex-skills.md Codex Docs, 2026-04-29 00:50 UTC → 2026-05-07 20:02 UTC

1# Save workflows as skills | Codex use cases1---

2 2name: Save workflows as skills

3Codex use cases3tagline: Create a skill Codex can keep on hand for work you repeat.

4 4summary: Turn a working Codex thread, review rules, test commands, release

5![](/assets/OpenAI-black-wordmark.svg)5 checklists, design conventions, writing examples, or repo-specific scripts

6 6 into a skill Codex can use in future threads.

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)7skills:

8 8 - token: $skill-creator

9Codex use case9 url: https://github.com/openai/skills/tree/main/skills/.system/skill-creator

10 10 description: Gather information about the workflow, scaffold a skill, keep the

11# Save workflows as skills11 main instructions short, and validate the result.

12 12bestFor:

13Create a skill Codex can keep on hand for work you repeat.

14 

15Difficulty **Easy**

16 

17Time horizon **5m**

18 

19Turn a working Codex thread, review rules, test commands, release checklists, design conventions, writing examples, or repo-specific scripts into a skill Codex can use in future threads.

20 

21## Best for

22 

23 - Codified workflows you want Codex to use again.

24- Teams that want a reusable skill instead of a long prompt pasted into every thread.

25 

26# Contents

27 

28[← All use cases](https://developers.openai.com/codex/use-cases)

29 

30Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/reusable-codex-skills/?export=pdf)

31 

32Turn a working Codex thread, review rules, test commands, release checklists, design conventions, writing examples, or repo-specific scripts into a skill Codex can use in future threads.

33 

34Easy

35 

365m

37 

38Related links

39 

40[Agent skills](https://developers.openai.com/codex/skills)

41 

42## Best for

43 

44 - Codified workflows you want Codex to use again.13 - Codified workflows you want Codex to use again.

45- Teams that want a reusable skill instead of a long prompt pasted into every thread.14 - Teams that want a reusable skill instead of a long prompt pasted into every

46 15 thread.

47## Skills & Plugins16starterPrompt:

17 title: Create a Skill From My Context

18 body: >-

19 Use $skill-creator to create a Codex skill that [fixes failing Buildkite

20 checks on a GitHub PR / turns PR notes into inline review comments / writes

21 our release notes from merged PRs]

48 22 

49- [Skill Creator](https://github.com/openai/skills/tree/main/skills/.system/skill-creator)

50 23 

51 Gather information about the workflow, scaffold a skill, keep the main instructions short, and validate the result.24 Use these sources when creating the skill:

52 25 

53| Skill | Why use it |26 - Working example: [say "use this thread," link a merged PR, or paste a good

54| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |27 Codex answer]

55| [Skill Creator](https://github.com/openai/skills/tree/main/skills/.system/skill-creator) | Gather information about the workflow, scaffold a skill, keep the main instructions short, and validate the result. |

56 28 

57## Starter prompt29 - Source: [paste a Slack thread, PR review link, runbook URL, docs URL, or

30 ticket]

58 31 

59Use $skill-creator to create a Codex skill that [fixes failing Buildkite checks on a GitHub PR / turns PR notes into inline review comments / writes our release notes from merged PRs]

60 Use these sources when creating the skill:

61- Working example: [say "use this thread," link a merged PR, or paste a good Codex answer]

62- Source: [paste a Slack thread, PR review link, runbook URL, docs URL, or ticket]

63 - Repo: [repo path, if this skill depends on one repo]32 - Repo: [repo path, if this skill depends on one repo]

64- Scripts or commands to reuse: [test command], [preview command], [log-fetch script], [release command]

65- Good output: [paste the Slack update, changelog entry, review comment, ticket, or final answer you want future threads to match]

66 33 

67[Open in the Codex app](codex://new?prompt=Use+%24skill-creator+to+create+a+Codex+skill+that+%5Bfixes+failing+Buildkite+checks+on+a+GitHub+PR+%2F+turns+PR+notes+into+inline+review+comments+%2F+writes+our+release+notes+from+merged+PRs%5D%0A%0AUse+these+sources+when+creating+the+skill%3A%0A-+Working+example%3A+%5Bsay+%22use+this+thread%2C%22+link+a+merged+PR%2C+or+paste+a+good+Codex+answer%5D%0A-+Source%3A+%5Bpaste+a+Slack+thread%2C+PR+review+link%2C+runbook+URL%2C+docs+URL%2C+or+ticket%5D%0A-+Repo%3A+%5Brepo+path%2C+if+this+skill+depends+on+one+repo%5D%0A-+Scripts+or+commands+to+reuse%3A+%5Btest+command%5D%2C+%5Bpreview+command%5D%2C+%5Blog-fetch+script%5D%2C+%5Brelease+command%5D%0A-+Good+output%3A+%5Bpaste+the+Slack+update%2C+changelog+entry%2C+review+comment%2C+ticket%2C+or+final+answer+you+want+future+threads+to+match%5D "Open in the Codex app")34 - Scripts or commands to reuse: [test command], [preview command],

35 [log-fetch script], [release command]

68 36 

69Use $skill-creator to create a Codex skill that [fixes failing Buildkite checks on a GitHub PR / turns PR notes into inline review comments / writes our release notes from merged PRs]37 - Good output: [paste the Slack update, changelog entry, review comment,

70 Use these sources when creating the skill:38 ticket, or final answer you want future threads to match]

71- Working example: [say "use this thread," link a merged PR, or paste a good Codex answer]39relatedLinks:

72- Source: [paste a Slack thread, PR review link, runbook URL, docs URL, or ticket]40 - label: Agent skills

73 - Repo: [repo path, if this skill depends on one repo]41 url: /codex/skills

74- Scripts or commands to reuse: [test command], [preview command], [log-fetch script], [release command]42---

75- Good output: [paste the Slack update, changelog entry, review comment, ticket, or final answer you want future threads to match]

76 43 

77## Create a skill Codex can keep on hand44## Create a skill Codex can keep on hand

78 45 

115 89 

116Most skills start as a `SKILL.md` file. `$skill-creator` can add longer references, scripts, or assets when the workflow needs them.90Most skills start as a `SKILL.md` file. `$skill-creator` can add longer references, scripts, or assets when the workflow needs them.

117 91 

118- my-skill/

119 

120 - SKILL.md Required: instructions and metadata

121 - references/ Optional: longer docs

122 - scripts/ Optional: repeatable commands

123 - assets/ Optional: templates and starter files

124 

125## Skills you could create92## Skills you could create

126 93 

127Use the same pattern when future threads should read the same runbook, run the same CLI, follow the same review rubric, write the same team update, or QA the same browser flow. For example:94Use the same pattern when future threads should read the same runbook, run the same CLI, follow the same review rubric, write the same team update, or QA the same browser flow. For example:

131- **`$frontend-skill`** keeps Codex close to your UI taste, existing components, screenshot QA loop, asset choices, and browser polish pass.98- **`$frontend-skill`** keeps Codex close to your UI taste, existing components, screenshot QA loop, asset choices, and browser polish pass.

132- **`$pr-review-comments`** turns review notes into concise inline comments with the right tone and GitHub links.99- **`$pr-review-comments`** turns review notes into concise inline comments with the right tone and GitHub links.

133- **`$web-game-prototyper`** scopes the first playable loop, chooses assets, tunes game feel, captures screenshots, and polishes in the browser.100- **`$web-game-prototyper`** scopes the first playable loop, chooses assets, tunes game feel, captures screenshots, and polishes in the browser.

134 

135## Related use cases

136 

137[![](/images/codex/codex-wallpaper-2.webp)

138 

139### Create a CLI Codex can use

140 

141Ask Codex to create a composable CLI it can run from any folder, combine with repo scripts...

142 

143Engineering Code](https://developers.openai.com/codex/use-cases/agent-friendly-clis)[![](/images/codex/codex-wallpaper-1.webp)

144 

145### Create browser-based games

146 

147Use Codex to turn a game brief into first a well-defined plan, and then a real browser-based...

148 

149Engineering Code](https://developers.openai.com/codex/use-cases/browser-games)[![](/images/codex/codex-wallpaper-2.webp)

150 

151### Deploy an app or website

152 

153Use Codex with Build Web Apps and Vercel to turn a repo, screenshot, design, or rough app...

154 

155Front-end Integrations](https://developers.openai.com/codex/use-cases/deploy-app-or-website)