use-cases/reusable-codex-skills.md Codex Docs, 2026-04-15 06:44 UTC → 2026-05-07 20:02 UTC

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

2 2name: Save workflows as skills

3[← All use cases](https://developers.openai.com/codex/use-cases)3tagline: Create a skill Codex can keep on hand for work you repeat.

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

5Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/reusable-codex-skills/?export=pdf)5 checklists, design conventions, writing examples, or repo-specific scripts

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

7Turn 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.7skills:

8 8 - token: $skill-creator

9Easy9 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

115m11 main instructions short, and validate the result.

12 12bestFor:

13Related links

14 

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

16 

17## Best for

18 

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

20- 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

15 thread.

16starterPrompt:

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]

21 22 

22## Skills & Plugins

23 23 

24- [Skill Creator](https://github.com/openai/skills/tree/main/skills/.system/skill-creator)24 Use these sources when creating the skill:

25 

26 Gather information about the workflow, scaffold a skill, keep the main instructions short, and validate the result.

27 25 

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

29| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |27 Codex answer]

30| [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. |

31 28 

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

30 ticket]

33 31 

34Use $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]

35 Use these sources when creating the skill:

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

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

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

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

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

41 33 

42Use $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]34 - Scripts or commands to reuse: [test command], [preview command],

43 Use these sources when creating the skill:35 [log-fetch script], [release command]

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

45- Source: [paste a Slack thread, PR review link, runbook URL, docs URL, or ticket]37 - Good output: [paste the Slack update, changelog entry, review comment,

46 - Repo: [repo path, if this skill depends on one repo]38 ticket, or final answer you want future threads to match]

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

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

41 url: /codex/skills

42---

49 43 

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

51 45 

88 89 

89Most 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.

90 91 

91- my-skill/

92 

93 - SKILL.md Required: instructions and metadata

94 - references/ Optional: longer docs

95 - scripts/ Optional: repeatable commands

96 - assets/ Optional: templates and starter files

97 

98## Skills you could create92## Skills you could create

99 93 

100Use 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:

104- **`$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.

105- **`$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.

106- **`$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.

107 

108## Related use cases

109 

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

111 

112### Create a CLI Codex can use

113 

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

115 

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

117 

118### Create browser-based games

119 

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

121 

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

123 

124### Iterate on difficult problems

125 

126Give Codex an evaluation system, such as scripts and reviewable artifacts, so it can keep...

127 

128Engineering Analysis](https://developers.openai.com/codex/use-cases/iterate-on-difficult-problems)