# skills-directory/skill-codex architecture

> Architecture diagram of the GitHub repository skills-directory/skill-codex, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skills-directory/skill-codex
- Repository: https://github.com/skills-directory/skill-codex

## Overview

This repository is a Claude Code skill for using the Codex CLI, not a standalone application. The main workflow is: a user requests code work, Claude activates the skill, and the skill’s instructions guide Claude in running Codex for analysis or editing; Claude then summarizes the result. The README also documents model, reasoning-effort, and sandbox selection, plus session resumes. No source excerpts were provided, so the graph reflects documented behavior only; it does not assert implementation details beyond the skill’s documented role.

Main entry points: [`plugins/skill-codex/skills/codex/SKILL.md`](https://github.com/skills-directory/skill-codex/blob/main/plugins/skill-codex/skills/codex/SKILL.md) (Codex skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_claude["Claude Code"]
node_skill["Codex skill<br/>[SKILL.md]"]
node_codex["Codex CLI"]
node_repository["Target repository"]
node_result["Analysis or edits"]

node_user -->|"requests work"| node_claude
node_claude -->|"activates"| node_skill
node_skill -->|"guides use"| node_claude
node_claude -->|"runs commands"| node_codex
node_codex -->|"analyzes or edits"| node_repository
node_codex -->|"produces"| node_result
node_claude -->|"summarizes"| node_user

click node_skill "https://github.com/skills-directory/skill-codex/blob/main/plugins/skill-codex/skills/codex/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_user toneBlue
class node_claude,node_codex,node_repository,node_result toneIndigo
class node_skill toneTeal
```

## Components

### Other components

- **User**
- **Claude Code**
- [Codex skill](https://github.com/skills-directory/skill-codex/blob/main/plugins/skill-codex/skills/codex/SKILL.md): `plugins/skill-codex/skills/codex/SKILL.md`
- **Codex CLI**
- **Target repository**
- **Analysis or edits**

## Connections

- User → Claude Code: requests work
- Claude Code → Codex skill: activates
- Codex skill → Claude Code: guides use
- Claude Code → Codex CLI: runs commands
- Codex CLI → Target repository: analyzes or edits
- Codex CLI → Analysis or edits: produces
- Claude Code → User: summarizes