October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk4 min

Codex Skills: What They Do and How to Create and Use Them

Codex skills package reusable instructions for recurring tasks. Learn how to write SKILL.md, add resources, choose a location, and test a skill’s behavior.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Codex skills are reusable workflow folders that tell Codex how to handle a recurring task: when the workflow applies, what steps to follow, and what result to return. A skill’s required entrypoint is SKILL.md; optional references, scripts, templates, and assets can support it. Skills guide Codex’s work rather than replacing its tools.

What is a Codex skill?

A skill packages instructions for a recognizable, repeatable goal. It can shape planning, tool use, and command execution by spelling out the workflow and its boundaries. The instructions are reusable; Codex still uses its available capabilities to carry them out. OpenAI describes this distinction in its Skills – Plugins documentation.

As an Amazon Associate I earn from qualifying purchases.

A skill is most useful when a task benefits from a consistent sequence, output format, or set of guardrails. It should focus on one goal, not become a catchall collection of unrelated instructions.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What goes in a SKILL.md file?

Each skill folder needs a SKILL.md file. Its front matter identifies the skill with a name and description; the Markdown body gives Codex the operational instructions. The description matters because it helps Codex decide when the skill applies. State both what the skill does and the conditions that should trigger it, while reserving the detailed procedure for the body. See OpenAI’s Build skills guide.

Useful instructions define the expected inputs, workflow, output, boundaries, and checks. They should also say what to do when information is missing, ambiguous, or outside the skill’s scope. Keep the entrypoint focused: a short, precise workflow is easier to apply than repeated generic advice.

Optional supporting files

Add resources only when they make the workflow more useful or reliable. For example, a skill might include:

  • references/ for detailed domain rules or documentation that is only relevant in certain situations.
  • scripts/ for repeatable, deterministic processing.
  • assets/ for templates or files used in the output.

Link supporting material from SKILL.md and explain when Codex should use it. OpenAI recommends keeping the main instructions concise and putting detailed background in supporting files where appropriate. See the OpenAI skills guide.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

How to create a Codex skill

  1. Choose a recurring task. Pick work with a clear, repeatable goal where consistent steps, output, or safeguards matter. Avoid combining unrelated workflows.
  2. Define its trigger. Choose a concise name and write a description that says what the skill does and when Codex should use it. Make the trigger specific enough that nearby, unrelated requests do not activate it.
  3. Write SKILL.md. Add YAML front matter for name and description, then write the procedure in Markdown. Specify expected inputs, steps, output, limits, and checks; describe when to ask a follow-up question or stop.
  4. Add only useful resources. Include references, scripts, templates, or assets if they support a real part of the workflow. Keep detailed or conditional guidance outside the main instructions when that makes them easier to maintain.
  5. Put the skill where the current Codex setup can discover it. OpenAI’s Codex evaluation guidance documents .codex/skills/<skill-name>/SKILL.md as a repository-scoped example and ~/.codex/skills/<skill-name>/SKILL.md as a user-scoped example. The first suits a workflow tied to one project; the second is an example for a workflow intended across personal projects. Check current Codex guidance for the product surface and setup you use.
  6. Test its behavior. Try direct and natural indirect requests, incomplete inputs, a nearby request that should not trigger the skill, and edge cases. Check both whether Codex selects the skill appropriately and whether the resulting work meets concrete quality criteria. OpenAI’s skill evaluation article discusses testing selection and task success as separate questions.

How does Codex know when to use a skill?

The name and description help Codex identify relevant skills. The description should make the workflow and its trigger conditions explicit; detailed steps belong in the body, not crammed into the metadata. OpenAI’s build guide explains this division.

Test the trigger separately from the outcome. A skill might be selected for the right request but still produce incomplete work, or it might perform well when explicitly invoked but fail to activate for a natural indirect request. Try both types, along with negative and incomplete cases, and assess the result against checks that matter for the workflow.

Should a skill use instructions only or include scripts?

Start with instructions when the workflow can be explained clearly as a sequence of decisions and actions. Add a script when a repeated calculation or file operation benefits from deterministic processing. Supporting scripts are optional, not a requirement for every skill.

A skill can also guide Codex in using an MCP server, but the two serve different purposes: the skill describes the workflow, while an MCP server supplies live information and controlled actions. A skill can be useful without an MCP server when the task only needs packaged instructions and resources. OpenAI explains the distinction in its Skills – Plugins documentation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Where can Codex skills be used?

Skill setup and availability depend on the product surface and workspace configuration. The repository- and user-scoped paths above are documented Codex examples, not a guarantee that every setup discovers skills in the same way. Check instructions for the Codex product you are using before relying on a particular installation route.

OpenAI also documents skills in other product contexts, but their availability and setup should not be treated as identical to Codex. For example, the ChatGPT Help Center article describes eligibility and workspace settings for ChatGPT; those details do not establish general Codex account requirements.

Review a skill before using it with tools

Because a skill can influence planning and tool use, inspect its instructions and supporting resources before relying on it for work involving tools or network access. Make sure the requested workflow, permitted actions, and boundaries are clear, and treat untrusted instructions cautiously. OpenAI’s skills guidance discusses these safety considerations.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.