use-cases/reusable-codex-skills.md Codex Docs, 2026-04-14 12:29 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

5Turn 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.5 checklists, design conventions, writing examples, or repo-specific scripts

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

7Easy7skills:

8 8 - token: $skill-creator

95m9 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

11Related links11 main instructions short, and validate the result.

12 12bestFor:

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

14 

15## Best for

16 

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

18- 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]

19 22 

20## Skills & Plugins

21 23 

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

23 25 

24 Gather information about the workflow, scaffold a skill, keep the main instructions short, and validate the result.26 - Working example: [say "use this thread," link a merged PR, or paste a good

27 Codex answer]

25 28 

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

30 ticket]

27 31 

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

29 Use these sources when creating the skill:

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

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

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

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

34- Good output: [paste the Slack update, changelog entry, review comment, ticket, or final answer you want future threads to match]34 - Scripts or commands to reuse: [test command], [preview command],

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

36 

37 - Good output: [paste the Slack update, changelog entry, review comment,

38 ticket, or final answer you want future threads to match]

39relatedLinks:

40 - label: Agent skills

41 url: /codex/skills

42---

35 43 

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

37 45 

74 89 

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

76 91 

77- my-skill/

78 

79 - SKILL.md Required: instructions and metadata

80 - references/ Optional: longer docs

81 - scripts/ Optional: repeatable commands

82 - assets/ Optional: templates and starter files

83 

84## Skills you could create92## Skills you could create

85 93 

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

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

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

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

93 

94## Related use cases

95 

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

97 

98### Create a CLI Codex can use

99 

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

101 

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

103 

104### Create browser-based games

105 

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

107 

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

109 

110### Iterate on difficult problems

111 

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

113 

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