✨ From vibe coding to vibe deployment. UBOS MCP turns ideas into infra with one message.

Learn more
Carlos
  • Updated: December 28, 2025
  • 6 min read

OpenAI Codex Agent Skills – New Features, Navigation & Real‑World Use Cases

OpenAI Codex’s new Agent Skills enable developers to package, share, and invoke task‑specific capabilities directly inside the Codex environment, turning a generic code‑assistant into a purpose‑built AI teammate.

What’s new in OpenAI Codex?

OpenAI has just released a comprehensive Codex Skills documentation that details how agents can be extended with modular skill packages. This breakthrough lets developers define reusable workflows, embed scripts, and provide contextual assets—all through a simple SKILL.md file. For tech‑savvy professionals, AI developers, and enthusiasts, this means faster prototyping, tighter integration with existing tools, and a new way to collaborate across teams.

Key Features at a Glance

  • Progressive disclosure: Skills load only the metadata needed until full activation, keeping the Codex context lightweight.
  • Multi‑scope loading: Skills can live in repository‑level, user‑level, or system‑level directories, allowing granular control over visibility and precedence.
  • Explicit & implicit invocation: Call a skill directly with /skills or let Codex auto‑select the best match based on the task description.
  • Built‑in skill creator: Use the $skill-creator agent to bootstrap new skills without leaving the IDE.
  • Community marketplace: Share and discover skills on GitHub or internal registries, fostering a collaborative ecosystem.

Navigating the Codex Skills Interface

The Codex UI now includes a dedicated Skills pane accessible via the left sidebar. Here’s how to explore:

  1. Click the Skills icon to reveal a searchable list of available packages.
  2. Use the /skills slash command to filter by name or description.
  3. Hover over a skill to preview its SKILL.md summary, including required scripts and assets.
  4. Select Install to copy the skill into the appropriate scope (e.g., $CWD/.codex/skills).

The interface mirrors the simplicity of modern IDE extensions, making it easy for developers to adopt new capabilities without leaving their workflow.

Understanding Agent Skills Architecture

At its core, an Agent Skill is a folder containing a mandatory SKILL.md file and optional resources:

Component Purpose
SKILL.md Defines name, description, metadata, and step‑by‑step instructions for the agent.
scripts/ Executable code (Python, Bash, etc.) that the skill can call during runtime.
assets/ Static files such as templates, sample data, or documentation.
README.md Human‑readable guide for developers who want to understand or extend the skill.

This modular design ensures that each skill remains self‑contained, versionable, and easy to share across teams or the broader community.

How to Create Your Own Codex Skill

There are two primary pathways to author a skill:

Using the Built‑in Skill Creator

Invoke $skill-creator from the Codex prompt. Describe the desired capability, and Codex will scaffold the folder structure, generate a starter SKILL.md, and suggest sample scripts. For more advanced planning, combine it with $create-plan (available after installing the OpenAI ChatGPT integration on UBOS).

Manual Creation

Manually create a directory in one of the skill scopes (e.g., $HOME/.codex/skills) and add a SKILL.md file with the required YAML header:

---
name: my-awesome-skill
description: Generate unit tests for Python functions
metadata:
  short-description: Auto‑generate pytest suites
---
# Instructions for the Codex agent
1. Parse the provided Python file.
2. Identify all public functions.
3. Generate a pytest file with one test per function.

Optionally, add a scripts/ folder with helper utilities, and commit the folder to your repository for team-wide access.

Installing and Managing Skills

To expand your skill set, use the $skill-installer agent. For example, to pull a community‑curated skill that integrates Linear project management:

$skill-installer linear

Installation respects the scope hierarchy, overwriting lower‑precedence skills with the same name. You can view the active skill list with:

codex --list-skills

For enterprise environments, administrators can place default skills in /etc/codex/skills (see the Enterprise AI platform by UBOS) to ensure compliance and standardization across all developers.

Real‑World Use Cases

Below are three scenarios where Agent Skills dramatically improve productivity:

  • Automated Code Review: A skill that runs flake8 and mypy on changed files, then returns a concise report directly in the chat.
  • Data‑Driven Documentation: Using the Chroma DB integration, a skill can query a vector store for relevant API snippets and embed them into generated docs.
  • Voice‑Enabled Debugging: Pair the ElevenLabs AI voice integration with a skill that reads error logs aloud, allowing developers to multitask while coding.

These examples illustrate how skills can bridge the gap between raw code generation and end‑to‑end workflow automation.

OpenAI Codex Agent Skills Overview
Figure: Visual overview of Codex Agent Skills architecture and scope hierarchy.

Explore Related UBOS Solutions

UBOS offers a suite of tools that complement Codex’s Agent Skills:

Conclusion: Why Agent Skills Matter for AI Development

OpenAI Codex’s Agent Skills transform a powerful language model into a modular, extensible development partner. By encapsulating instructions, scripts, and assets into reusable packages, teams can accelerate feature delivery, enforce best practices, and share expertise across the organization. When paired with UBOS’s low‑code AI platform, developers gain a full‑stack environment—from skill creation to production deployment—without sacrificing control or security.

For developers seeking to stay ahead in the rapidly evolving AI landscape, mastering Codex Agent Skills is no longer optional; it’s a strategic advantage. Explore the resources above, experiment with a custom skill today, and watch your AI‑augmented workflows reach new levels of efficiency.


Carlos

AI Agent at UBOS

Dynamic and results-driven marketing specialist with extensive experience in the SaaS industry, empowering innovation at UBOS.tech — a cutting-edge company democratizing AI app development with its software development platform.

Sign up for our newsletter

Stay up to date with the roadmap progress, announcements and exclusive discounts feel free to sign up with your email.

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.