Codex Simplify Skill

🇬🇧 English

codex-simplify-skill installs a global Codex skill named simplify.

It is built for code that already works, but still looks like AI-generated clutter: duplicated helpers, overgrown parameters, extra abstractions, repeated checks, noisy control flow, and hot-path waste. The skill runs three focused read-only review subagents, waits for all of them, filters weak findings, and lets the main Codex agent apply compact fixes in the current branch.

✨ What It Does

| Area | What Simplify Looks For | Result | | --- | --- | --- | | ♻️ Reuse | Existing helpers, local APIs, duplicated logic, repeated patterns | Less new code, more native repo style | | 🧹 Quality | Redundant state, nesting, copy-paste, stringly-typed code, leaky abstractions | Smaller, flatter, clearer code | | ⚡ Efficiency | Wasted work, hot-path bloat, missed concurrency, TOCTOU, memory leaks | Fewer slow paths and fewer subtle bugs |

🧭 Review Pipeline

flowchart LR
    A["Changed code<br/>commit, range, staged or unstaged diff"] --> B["Simplify orchestrator"]
    B --> C["♻️ simplify-reuse<br/>existing helpers<br/>missed reuse"]
    B --> D["🧹 simplify-quality<br/>state noise<br/>copy-paste<br/>leaky abstractions"]
    B --> E["⚡ simplify-efficiency<br/>wasted work<br/>hot paths<br/>race risks"]
    C --> F["Aggregate findings"]
    D --> F
    E --> F
    F --> G["Filter weak findings"]
    G --> H["Apply compact fixes<br/>in the current branch"]

    style B fill:#111827,color:#fff,stroke:#8B5CF6,stroke-width:2px
    style C fill:#ECFDF5,stroke:#10B981,color:#064E3B
    style D fill:#F5F3FF,stroke:#8B5CF6,color:#4C1D95
    style E fill:#FFF7ED,stroke:#F97316,color:#7C2D12
    style H fill:#EFF6FF,stroke:#3B82F6,color:#1E3A8A

🤖 Subagent Roles

| Subagent | Mission | Typical Findings | | --- | --- | --- | | simplify-reuse | Search surrounding code for better existing tools | “This new parser duplicates parse_dt”, “use the existing gateway helper” | | simplify-quality | Remove AI-shaped code noise | extra wrappers, nested branches, duplicate validation, abstraction leakage | | simplify-efficiency | Catch avoidable work and risky timing | repeated IO, hot-path scans, TOCTOU, missed batching, memory leaks |

The subagents are read-only. They do not modify files. The parent Codex agent waits for every report, accepts only useful findings, and makes the final edits.

🚀 Install

npx -y codex-simplify-skill

Directly from GitHub:

npx -y github:kirillshsh/codex-simplify-skill

macOS / Linux bootstrap:

curl -fsSL https://raw.githubusercontent.com/kirillshsh/codex-simplify-skill/main/install.sh | bash

Windows PowerShell bootstrap:

irm https://raw.githubusercontent.com/kirillshsh/codex-simplify-skill/main/install.ps1 | iex

Restart Codex after installation.

📦 Installed Files

| File | Purpose | | --- | --- | | ~/.codex/skills/simplify | The global simplify skill | | ~/.codex/agents/explorer.toml | explorer subagent configured as gpt-5.5 + xhigh | | ~/.codex/config.toml | Adds [agents.explorer] |

Existing files are overwritten without backup copies.

💬 How To Call It

simplify
clean up code
KISS pass
review changes
code review

CODEX_HOME="$HOME/.codex" npx -y codex-simplify-skill
CODEX_SKILLS_DIR="$HOME/.codex/skills" npx -y codex-simplify-skill
npx -y codex-simplify-skill --legacy-agents-dir

| Flag | Meaning | | --- | --- | | --codex-home <path> | Override Codex config directory | | --skills-dir <path> | Override skill install directory | | --legacy-agents-dir | Install the skill to ~/.agents/skills instead |

🇺🇦 Українська

codex-simplify-skill встановлює глобальний Codex skill simplify.

Він потрібен для коду, який уже працює, але ще виглядає як типовий результат ШІ: дубльовані helper-и, роздуті параметри, зайві абстракції, повторні перевірки, шумний control flow і зайва робота в гарячих шляхах. Skill запускає три read-only subagent-и, чекає всі результати, відсіює слабкі знахідки й дає головному Codex-agent-у застосувати компактні правки в поточній гілці.

✨ Що Він Робить

| Напрям | Що Шукає Simplify | Результат | | --- | --- | --- | | ♻️ Повторне використання | Наявні helper-и, локальні API, дубльована логіка, повторювані патерни | Менше нового коду, більше стилю самого repo | | 🧹 Якість | Зайвий state, вкладеність, copy-paste, stringly-typed код, протікання абстракцій | Менший, пласкіший і зрозуміліший код | | ⚡ Ефективність | Зайва робота, hot-path bloat, пропущена конкурентність, TOCTOU, витоки пам'яті | Менше повільних шляхів і прихованих багів |

🧭 Схема Перевірки

flowchart LR
    A["Змінений код<br/>commit, range, staged або unstaged diff"] --> B["Оркестратор Simplify"]
    B --> C["♻️ simplify-reuse<br/>наявні helper-и<br/>пропущене reuse"]
    B --> D["🧹 simplify-quality<br/>зайвий state<br/>copy-paste<br/>діряві абстракції"]
    B --> E["⚡ simplify-efficiency<br/>зайва робота<br/>гарячі шляхи<br/>ризики гонок"]
    C --> F["Зібрати findings"]
    D --> F
    E --> F
    F --> G["Відсіяти слабкі знахідки"]
    G --> H["Застосувати компактні правки<br/>в поточній гілці"]

    style B fill:#111827,color:#fff,stroke:#8B5CF6,stroke-width:2px
    style C fill:#ECFDF5,stroke:#10B981,color:#064E3B
    style D fill:#F5F3FF,stroke:#8B5CF6,color:#4C1D95
    style E fill:#FFF7ED,stroke:#F97316,color:#7C2D12
    style H fill:#EFF6FF,stroke:#3B82F6,color:#1E3A8A

🤖 Ролі Subagent-ів

| Subagent | Завдання | Типові Знахідки | | --- | --- | --- | | simplify-reuse | Шукає в сусідньому коді кращі вже наявні інструменти | “цей parser дублює parse_dt”, “тут є готовий gateway helper” | | simplify-quality | Прибирає шум, схожий на ШІ-код | зайві wrappers, вкладені branches, duplicate validation, abstraction leakage | | simplify-efficiency | Ловить зайву роботу й ризиковий timing | повторний IO, scans у hot path, TOCTOU, пропущене batching |

🚀 Встановлення

npx -y codex-simplify-skill

Напряму з GitHub:

npx -y github:kirillshsh/codex-simplify-skill

Після встановлення перезапусти Codex.

📦 Що Встановлюється

| Файл | Для Чого | | --- | --- | | ~/.codex/skills/simplify | Глобальний skill simplify | | ~/.codex/agents/explorer.toml | Subagent explorer з gpt-5.5 + xhigh | | ~/.codex/config.toml | Додає [agents.explorer] |

Наявні файли перезаписуються без backup-копій.

💬 Як Викликати

simplify
clean up code
KISS pass
review changes
code review

🇧🇾 Беларуская

codex-simplify-skill усталёўвае глабальны Codex skill simplify.

Ён патрэбны для кода, які ўжо працуе, але ўсё яшчэ выглядае як тыповы вынік ШІ: дубляваныя helper-ы, раздзьмутыя параметры, лішнія абстракцыі, паўторныя праверкі, шумны control flow і лішняя праца ў гарачых шляхах. Skill запускае тры read-only subagent-ы, чакае ўсе вынікі, адкідвае слабыя знаходкі і дае галоўнаму Codex-agent-у ўжыць кампактныя праўкі ў бягучай галіне.

✨ Што Ён Робіць

| Напрамак | Што Шукае Simplify | Вынік | | --- | --- | --- | | ♻️ Паўторнае выкарыстанне | Існыя helper-ы, лакальныя API, дубляваная логіка, паўторныя патэрны | Менш новага кода, больш стылю самога repo | | 🧹 Якасць | Лішні state, укладзенасць, copy-paste, stringly-typed код, дзіравыя абстракцыі | Меншы, больш плоскі і ясны код | | ⚡ Эфектыўнасць | Лішняя праца, hot-path bloat, прапушчаная канкурэнтнасць, TOCTOU, уцечкі памяці | Менш павольных шляхоў і схаваных багаў |

🧭 Схема Праверкі

flowchart LR
    A["Зменены код<br/>commit, range, staged або unstaged diff"] --> B["Аркестратар Simplify"]
    B --> C["♻️ simplify-reuse<br/>існыя helper-ы<br/>прапушчанае reuse"]
    B --> D["🧹 simplify-quality<br/>лішні state<br/>copy-paste<br/>дзіравыя абстракцыі"]
    B --> E["⚡ simplify-efficiency<br/>лішняя праца<br/>гарачыя шляхі<br/>рызыкі гонак"]
    C --> F["Сабраць findings"]
    D --> F
    E --> F
    F --> G["Адсеяць слабыя знаходкі"]
    G --> H["Ужыць кампактныя праўкі<br/>у бягучай галіне"]

    style B fill:#111827,color:#fff,stroke:#8B5CF6,stroke-width:2px
    style C fill:#ECFDF5,stroke:#10B981,color:#064E3B
    style D fill:#F5F3FF,stroke:#8B5CF6,color:#4C1D95
    style E fill:#FFF7ED,stroke:#F97316,color:#7C2D12
    style H fill:#EFF6FF,stroke:#3B82F6,color:#1E3A8A

🤖 Ролі Subagent-аў

| Subagent | Задача | Тыповыя Знаходкі | | --- | --- | --- | | simplify-reuse | Шукае ў суседнім кодзе лепшыя ўжо існыя інструменты | “гэты parser дублюе parse_dt”, “тут ёсць гатовы gateway helper” | | simplify-quality | Прыбірае шум, падобны на ШІ-код | лішнія wrappers, укладзеныя branches, duplicate validation, abstraction leakage | | simplify-efficiency | Ловіць лішнюю працу і рызыкоўны timing | паўторны IO, scans у hot path, TOCTOU, прапушчанае batching |

🚀 Усталяванне

npx -y codex-simplify-skill

Напрамую з GitHub:

npx -y github:kirillshsh/codex-simplify-skill

Пасля ўсталявання перазапусці Codex.

📦 Што Ўсталёўваецца

| Файл | Для Чаго | | --- | --- | | ~/.codex/skills/simplify | Глабальны skill simplify | | ~/.codex/agents/explorer.toml | Subagent explorer з gpt-5.5 + xhigh | | ~/.codex/config.toml | Дадае [agents.explorer] |

Існыя файлы перазапісваюцца без backup-копій.

💬 Як Выклікаць

simplify
clean up code
KISS pass
review changes
code review

🇷🇺 Русский

codex-simplify-skill ставит глобальный Codex skill simplify.

Он нужен для кода, который уже работает, но всё ещё выглядит как типичный мусорный код после ИИ: дублирующие helper-ы, распухшие параметры, лишние абстракции, повторные проверки, шумный control flow и лишняя работа в hot path. Skill запускает три read-only subagent-а, ждёт все результаты, отбрасывает слабые findings и даёт верхнему Codex-agent-у применить компактные правки прямо в текущей ветке.

✨ Что Он Делает

| Направление | Что Ищет Simplify | Итог | | --- | --- | --- | | ♻️ Переиспользование | Существующие helper-ы, локальные API, дублирующая логика, повторяющиеся паттерны | Меньше нового кода, больше стиля самого repo | | 🧹 Качество | Лишний state, вложенность, copy-paste, stringly-typed код, протекающие абстракции | Код становится меньше, проще и прямее | | ⚡ Эффективность | Лишняя работа, hot-path bloat, missed concurrency, TOCTOU, утечки памяти | Меньше медленных путей и скрытых багов |

🧭 Схема Проверки

flowchart LR
    A["Изменённый код<br/>commit, range, staged или unstaged diff"] --> B["Оркестратор Simplify"]
    B --> C["♻️ simplify-reuse<br/>готовые helper-ы<br/>пропущенное reuse"]
    B --> D["🧹 simplify-quality<br/>лишний state<br/>copy-paste<br/>дырявые абстракции"]
    B --> E["⚡ simplify-efficiency<br/>лишняя работа<br/>горячие пути<br/>риски гонок"]
    C --> F["Собрать findings"]
    D --> F
    E --> F
    F --> G["Отфильтровать слабое"]
    G --> H["Применить компактные фиксы<br/>в текущей ветке"]

    style B fill:#111827,color:#fff,stroke:#8B5CF6,stroke-width:2px
    style C fill:#ECFDF5,stroke:#10B981,color:#064E3B
    style D fill:#F5F3FF,stroke:#8B5CF6,color:#4C1D95
    style E fill:#FFF7ED,stroke:#F97316,color:#7C2D12
    style H fill:#EFF6FF,stroke:#3B82F6,color:#1E3A8A

🤖 Роли Subagent-ов

| Subagent | Задача | Типичные Находки | | --- | --- | --- | | simplify-reuse | Ищет в соседнем коде лучшие уже существующие инструменты | “этот parser дублирует parse_dt”, “тут уже есть gateway helper” | | simplify-quality | Убирает шум, похожий на ИИ-код | лишние wrappers, вложенные branches, duplicate validation, abstraction leakage | | simplify-efficiency | Ловит лишнюю работу и рискованный timing | повторный IO, scans в hot path, TOCTOU, пропущенное batching |

🚀 Установка

npx -y codex-simplify-skill

Напрямую с GitHub:

npx -y github:kirillshsh/codex-simplify-skill

После установки перезапусти Codex.

📦 Что Ставится

| Файл | Для Чего | | --- | --- | | ~/.codex/skills/simplify | Глобальный skill simplify | | ~/.codex/agents/explorer.toml | Subagent explorer с gpt-5.5 + xhigh | | ~/.codex/config.toml | Добавляет [agents.explorer] |

Существующие файлы перезаписываются без backup-копий.

💬 Как Вызвать

simplify
clean up code
KISS pass
review changes
code review

CODEX_HOME="$HOME/.codex" npx -y codex-simplify-skill
CODEX_SKILLS_DIR="$HOME/.codex/skills" npx -y codex-simplify-skill
npx -y codex-simplify-skill --legacy-agents-dir

| Флаг | Значение | | --- | --- | | --codex-home <path> | Переопределить папку Codex config | | --skills-dir <path> | Переопределить папку установки skill-а | | --legacy-agents-dir | Поставить skill в ~/.agents/skills |