Everything Codex CLI

Production-ready Codex CLI rules and skills for consistent, high-quality coding.

This repo is a Codex-first replacement of the original Claude config set. It keeps the best workflows but ships them in Codex-compatible formats.

---

What's Inside

everything-codex/
|-- AGENTS.md              # Global rules loaded by Codex for this project
|-- skills/                # Codex skills (each in its own folder)
|   |-- planner/SKILL.md
|   |-- architect/SKILL.md
|   |-- code-reviewer/SKILL.md
|   |-- build-error-resolver/SKILL.md
|   |-- e2e-runner/SKILL.md
|   |-- refactor-cleaner/SKILL.md
|   |-- doc-updater/SKILL.md
|   |-- backend-patterns/SKILL.md
|   |-- frontend-patterns/SKILL.md
|   |-- coding-standards/SKILL.md
|   |-- clickhouse-io/SKILL.md
|   |-- project-guidelines-example/SKILL.md
|   |-- tdd-workflow/SKILL.md
|   |-- security-review/SKILL.md

---

Quick Start

1. Clone the repo

git clone <repo-url>

2. Copy AGENTS.md and skills/ into your project

cp -r <repo-dir>/AGENTS.md /path/to/your/project/
cp -r <repo-dir>/skills /path/to/your/project/

3. Run Codex CLI inside your project

Codex will automatically load AGENTS.md and any matching skills in skills/.

---

Using This In Your Repo (Detailed)

1) Place files at the repo root

Codex loads rules and skills from your project root:

your-repo/
|-- AGENTS.md
|-- skills/
    |-- <skill-name>/
        |-- SKILL.md

2) Keep only the skills you need

To reduce context and improve speed, delete unused skills. Recommended core set:

skills/
  planner/
  tdd-workflow/
  code-reviewer/
  security-review/
  build-error-resolver/

3) Customize global rules (AGENTS.md)

Edit AGENTS.md to fit your project. Common tweaks:

• Change coverage thresholds
• Adjust coding-style constraints
• Add domain-specific rules
• Remove rules that do not apply

4) Customize skill triggers

Codex uses the frontmatter name and description to decide when to activate a skill. If a skill is not triggering, make the description more explicit or mention the skill name directly in your prompt.

Example prompt:

Use the tdd-workflow skill and write tests first for this feature.

5) Split large skills into references

If a SKILL.md gets too long, move deep examples into:

skills/<skill-name>/references/

Then add a short pointer in SKILL.md telling Codex when to open that reference.

---

How Codex Uses This Repo

• AGENTS.md is always loaded as global rules.
• skills/<name>/SKILL.md is loaded only when it matches your request.
• Codex does not use agents/, commands/, rules/, hooks/, or plugins.

---

Example Prompts

• "Plan a migration to Postgres and list steps." (planner)
• "Fix this failing build with minimal diffs." (build-error-resolver)
• "Write unit and integration tests before implementing this feature." (tdd-workflow)
• "Review this change for security and correctness." (security-review or code-reviewer)

---

Maintenance

• Add new skills under skills/<name>/SKILL.md.
• Keep SKILL.md short; move long docs into references/.
• Remove unused skills to keep Codex fast and focused.

---

Key Concepts

AGENTS.md (Global Rules)

AGENTS.md is always loaded. It defines security, testing, and code-quality rules Codex should follow for every task.

Skills

Skills are specialized workflows stored at:

skills/<skill-name>/SKILL.md

Codex activates skills automatically when a request matches the skill description. You can also explicitly mention a skill by name in your prompt.

---

Contributing

Contributions are welcome. See CONTRIBUTING.md for details on adding or updating Codex skills.