A useful Codex skill turns one recurring task into a workflow Codex can recognize and follow. Give it a specific name and trigger, write the steps and expected output in SKILL.md, add supporting files only when they help, and test it against a clear success check. A skill does not automatically need an MCP server: use one when the workflow requires live information, authentication, or controlled actions.
What a Codex skill is—and what it is for
A Codex skill is a reusable set of instructions and supporting resources for a task. Its directory is centered on a SKILL.md manifest with front matter and workflow instructions; optional files can provide references, scripts, templates, or other assets. Skills are useful when a recognizable task recurs and a consistent process improves the result. OpenAI’s Skills guide and Build skills guide describe this structure.
Think of the skill as a playbook, not a general-purpose assistant personality. It should tell Codex what task it covers, when to use it, how to do the work, and what a satisfactory result looks like.
Start by giving the skill one clear job
Choose a recurring task
Pick a task with a recognizable goal and repeatable process—for example, turning meeting notes into an action list in a specified format. Avoid combining unrelated work, such as summarizing meetings, writing marketing copy, and updating a project tracker, in one skill. A narrow purpose makes the instructions easier to follow and the skill easier to select.
The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
Make the trigger understandable
The skill’s name and description help Codex determine when it is relevant. Use a descriptive name and say both what the skill does and the situation in which it should be used. A vague description such as “helps with documents” gives a weaker signal than “turns meeting notes into a concise action list when the user provides meeting notes.” OpenAI’s build guide recommends focusing a skill on a recognizable user goal.
What to put in SKILL.md
Write the core workflow in SKILL.md. Make the instructions explicit enough that Codex can act consistently without guessing about required inputs or the finished result. Include:
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
- When to use it: the request or conditions that should trigger the workflow.
- Inputs: what information or files Codex needs, and what to do if something is missing.
- Ordered steps: the actions to take, including decision points and any rules for handling exceptions.
- Output requirements: the format, level of detail, or other constraints for the result.
- A quality check: an observable way to tell whether the task was completed properly.
The following is an editorial starter template, not a quoted OpenAI form:
---
name: meeting-action-list
description: Turn supplied meeting notes into a concise action list when the user asks to extract follow-up work.
---
Use this skill when the user provides meeting notes and requests follow-up actions.
1. Gather the notes and identify decisions, owners, and deadlines.
2. Separate confirmed actions from open questions; do not invent missing owners or dates.
3. Produce a concise list with action, owner, and deadline where available.
4. Check that every listed action is supported by the notes and that missing details are labeled clearly.When to add references, scripts, or other files
Keep the manifest focused. Add supporting files when they enable the workflow rather than merely making the skill directory larger.
Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
- Reference file: Put detailed background material or a substantial policy in a separate file when including it all in the core instructions would make them unwieldy.
- Script: Include one when the task genuinely needs a repeatable executable action. A script can make that action consistent, but it also adds something to maintain.
- Template or asset: Add a reusable output template, example, or other resource when the workflow depends on it.
OpenAI’s skill-building guidance describes these as optional resources. For a workflow that can be carried out reliably through instructions alone, an instruction-only skill is a reasonable starting point; the evaluation article also describes it as the default recommendation in the skill-creator flow.
Decide whether the skill needs scripts or an MCP server
Instruction-only or script-backed
Use instructions alone when the job is primarily a sequence of decisions or writing steps. Add a script when the workflow needs an executable action that should run consistently. The choice depends on whether the task benefits from execution and repeatability enough to justify maintaining that code.
Rank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Standalone skill or skill plus MCP server
A skill can work on its own when its instructions and packaged resources are sufficient. An MCP server may be useful when the job needs live information, authentication, authorization, or controlled actions in an external service. The skill describes when and how to use available tools; the server provides supported data or actions. OpenAI explains this distinction in its build guide and Using skills overview.
Do not add an MCP server just because a workflow is called a skill. First identify what live data or action the task actually needs, then connect a suitable tool only if that requirement exists.
Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
Test the skill against its intended job
Before relying on a skill, define what a good result means and try representative requests. Check both whether the description helps select the skill in the right situation and whether the instructions produce the expected result once it is used.
- Trigger check: Try a request that should use the skill and a similar request that should not. Confirm the description distinguishes them as intended.
- Workflow check: Use a representative input and verify the required steps, decision rules, and output format were followed.
- Edge-case check: Try missing or ambiguous input and confirm the instructions prevent unsupported guesses or provide a useful way to proceed.
- Regression check: When you revise the skill, repeat the same checks to see whether the change fixed a problem without creating another.
For checks with unambiguous answers, use deterministic criteria—for example, whether required fields are present. For qualities that require judgment, such as clarity or relevance, use a rubric. OpenAI’s article on evaluating agent skills discusses combining these methods to identify improvements and regressions.
Where you can use and share a skill
OpenAI’s Codex app announcement says a skill created in the app can be used in the app, CLI, or IDE extension, and that skills checked into a repository can be shared with a team. Product setup and availability can differ, so check the instructions for the Codex surface you use.
OpenAI’s API skills guide also describes local-execution and hosted, container-based forms for API use. Those API arrangements are separate product contexts; do not assume their setup applies to every Codex app, CLI, or IDE workflow.
Recommended Free Tools
Quick Recap
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.
