Guides
    codex-cli
    subagents
    skill-md

    Codex Subagents and Skills: Complete Setup Guide (2026)

    Codex shipped subagents in March 2026. Here's how to set them up with skills for parallel coding workflows.

    June 23, 20265 min read
    Share:

    Codex shipped subagents to GA on March 14, 2026. You can now spawn up to 8 parallel agents from a single task, each with its own dedicated context window and cloud sandbox. Combined with SKILL.md skills, this turns Codex from a single-threaded coding assistant into a parallel development team.

    Quick Answer: Codex subagents let you run up to 8 parallel workers from one task. Install SKILL.md skills to give each worker domain expertise. Skills go in your project's .codex/skills/ directory.

    How Codex subagents work

    Codex uses a manager-worker model. You give it a complex task. The manager decomposes it into subtasks and spawns worker agents in parallel cloud sandboxes. Each worker has its own context window, so the auth refactor agent doesn't share context with the test-writing agent.

    Workers can run terminal commands, edit files, and run tests in their sandbox. Results are collected by the manager and presented to you for review.

    Setting up skills for subagents

    Skills are installed at the project level:

    your-project/.codex/skills/skill-name/SKILL.md
    

    Or globally:

    ~/.codex/skills/skill-name/SKILL.md
    

    Every subagent inherits the installed skills. When a worker is assigned a testing subtask, it naturally activates testing-related skills. When another worker handles documentation, it picks up documentation skills.

    Best skills for Codex subagents

    Code review skills. Have the manager spawn a review agent that checks every other agent's output. This is the easiest way to catch issues in parallel workflows.

    Testing framework skills. Each testing worker benefits from knowing your specific framework patterns. Jest, Pytest, Vitest, Playwright.

    Git automation skills. When parallel agents produce changes, you need clean commits. A git skill ensures conventional commit messages and proper branch management.

    DevOps skills. If subagents are generating infrastructure code, a DevOps skill keeps Docker, Terraform, and CI/CD configs consistent.

    Browse all Codex-compatible skills at agensi.io/skills.

    Codex subagents vs Claude Code Agent Teams

    Both support parallel agents with dedicated context windows. Codex allows up to 8 parallel workers with cloud sandboxing. Claude Code Agent Teams use shared task lists and direct messaging between agents. Codex is better for delegated, autonomous work. Claude Code is better for coordinated, interactive work.

    Both support the same SKILL.md format. Your skills work in either tool.


    Related: Best Codex CLI Skills 2026 and How to Install Skills in Codex CLI.

    Frequently Asked Questions

    Codex shipped subagents to General Availability on March 14, 2026. This feature allows users to spawn up to 8 parallel agents from a single task, each equipped with its own dedicated context window and cloud sandbox, transforming Codex into a parallel development team.

    Codex subagents allow you to spawn up to 8 parallel agents from a single task. Each of these agents operates with its own dedicated context window and cloud sandbox, enabling the decomposition and execution of complex tasks in parallel, similar to a development team.

    For project-level skill installation, SKILL.md files should be placed in the `.codex/skills/skill-name/` directory within your project's root folder. This ensures that every subagent working within that specific project inherits and can utilize the installed skills relevant to their assigned subtasks.

    Codex subagents operate using a manager-worker model where the manager decomposes a complex task into subtasks and spawns worker agents in parallel cloud sandboxes. Each worker agent is assigned its own dedicated context window, preventing context bleed between agents working on different aspects, such as an auth refactor agent and a test-writing agent.

    The primary benefit of installing code review skills for Codex subagents is to have the manager spawn a dedicated review agent that checks the output of every other agent. This approach is highly effective for catching potential issues early in parallel workflows, ensuring code quality and consistency across various subtasks.

    A key difference is that Codex subagents support up to 8 parallel workers with individual cloud sandboxing, making it better for delegated, autonomous work. Claude Code Agent Teams, while also supporting parallel agents with dedicated context windows, use shared task lists and direct messaging between agents, which is more suited for coordinated, interactive work.