name: codex-mcp description: Use this codex-mcp skill to instruct another AI Agent to invoke a tool or execute a workflow on your behalf for the following scenario, 1.When you are requested to invoke a mcp tool that you don't have access (can use ListMcpResourcesTool to check) such as context7, github, linear, jira; 2.When you are requested to execute a complex workflow that require interacting with multiple mcp tools and bash CLI commands for example github-project-create-items, github-project-list-items workflows;

codex-mcp

You MUST check whether codex CLI and MCP server are available in the current bash environment with this bash command: codex mcp list. If not available, run the following bash command to install the codex CLI: npm install -g @openai/codex. Then inform user to perform authentication with an OpenAI account by running codex login. Ignore this instruction if the CLI and MCP server are already available.

Tools

mcp__codex__codex

Run a Codex session. Accepts configuration parameters matching the Codex Config struct. Supported properties:

Response:

mcp__codex__codex-reply

Continue a Codex session by providing the conversation id and follow-up prompt. Supported properties:

Response:

Operational Requirements

• Always route qualifying requests through mcp__codex__codex with sandbox set to danger-full-access (MUST) , approval-policy set to never (MUST) and model set to gpt-5.4-mini (SHOULD).
• When an unknown MCP tool name is requested, use ListMcpResourcesTool to confirm if it is available. If not available, delegate to codex to invoke this MCP tool by crafting a prompt with all necessary information and file references.
• When you need to run a command that would emit large stdout output but only a subset of that output is needed, MUST provide a precise prompt when delegating via mcp__codex__codex so the downstream agent knows which portion of the large output to collect or which external tool to execute.
• Prefer passing context via a local file when delegating: include a relative path prefixed with @ inside the prompt (example prompt: "use mcp Github to submit all review feedback comments in this file @ghpr-code-review/pr_47_feat_e2e_tests_review_feedback.md Make sure to include correct line number for each comment").
• When mcp__codex__codex returns a result requiring your follow-up, continue the conversation with mcp__codex__codex-reply, reusing the threadId present in the previous response (must be a valid UUID).

Image Generation

When the user requests to generate an image, delegate to mcp__codex__codex using model set to gpt-5.5 (REQUIRED for image generation). The downstream Codex agent must:

• Copy the generated image file to the current working directory (cwd).
• Return the absolute path of the copied image file in the response.

When crafting the prompt, include explicit instructions such as:

"Generate an image of {description}. Copy the output image to the current working directory and respond with the absolute path of the copied image file."

Example delegation parameters:

• model: gpt-5.5
• cwd: the user's current working directory (absolute path)
• sandbox: danger-full-access
• approval-policy: never
• prompt: e.g. "Generate a PNG image of a red origami fox sitting on a stack of books in a cozy library, soft warm lighting, shallow depth of field. Copy the output to the current working directory, and respond with ONLY the absolute path of the copied image file (no extra commentary)."

After receiving the response, surface the absolute path of the generated image to the user.

Known MCP Server Tools

• When github MCP server tool (mcp__github, mcp__github__*) is requested, see mcp-github-usage.md for detailed usage instructions. Use the information in this file to craft a precise prompt when delegating via mcp__codex__codex so the downstream agent can use the github MCP server tool exactly as intended.
• When linear MCP server tool (mcp__linear, mcp__linear__*) is requested, see mcp-linear-usage.md for detailed usage instructions. Use the guidance in this file to compose precise prompts when delegating via mcp__codex__codex so the downstream agent invokes Linear tools correctly.
• When context7 MCP server tool is requested, see mcp-context7-usage.md for detailed usage instructions.