whatisgithub

What is codex-skill?

mauriciog87/codex-skill — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · developerSetup · moderate

In one sentence

A Codex CLI setup that splits AI coding work between a planning AI and three restricted worker roles, and verifies the actual model used instead of trusting its self reports.

Mindmap

mindmap
  root((codex-skill))
    What it does
      Multi role AI coding
      Verified model routing
      Repository locking
    Tech stack
      JavaScript
      Node.js
      Codex CLI
    Use cases
      Explore read only
      Scoped implementation
      Change review
    Audience
      Codex CLI users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Coordinate a planning AI session with separate explore, implement, and review AI roles on the same repository

USE CASE 2

Verify that an AI coding session actually used the model and reasoning setting it was configured with

USE CASE 3

Restrict an AI coding assistant to read-only exploration or a narrowly scoped set of files to edit

USE CASE 4

Escalate to a stronger reasoning mode only for specific, human confirmed architecture decisions

What is it built with?

JavaScriptNode.jsCodex CLI

How does it compare?

mauriciog87/codex-skill00kaku/gallery-slider-block0xkinno/vellum
Stars00
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-19
MaintenanceDormant
Setup difficultymoderateeasyhard
Complexity2/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Codex CLI access to the specific model, Node.js 18 or newer, and manually trusting installed hooks.

So what is it?

codex-skill is a configuration package for OpenAI's Codex command line tool that sets up a strict way of coordinating multiple AI coding sessions, all using a model the README calls GPT 5.6 Sol. One session acts as the root planner, deciding what work needs doing, while three separate limited roles do the actual work: one that only explores and reads code, one that is allowed to write code but only within a scope it was explicitly given, and one that only reviews changes without touching files. A rare fourth mode, called an Ultra takeover, temporarily replaces the root planner with a stronger reasoning setting for unusually hard architecture or security decisions, and requires a human to type an explicit confirmation flag before it runs. What makes this project distinct is that it does not simply trust whichever AI model claims to be running. After starting a Codex session, the launcher scripts read the actual session log to confirm which model and reasoning setting were really used, and it refuses to accept the result if they do not match what was requested. Installation clones the repository and runs a setup script that links the skill into the user's global Codex configuration folder, adjusts some default settings, and installs safety hooks, without disturbing any of the user's existing unrelated Codex settings. After installing, the user must manually approve the two new hooks inside Codex before they take effect. Each coding task is started by piping written instructions into a launcher script along with a chosen role and a sandbox mode such as read-only or workspace-write. Every run prints back a single structured result showing whether it completed, what was changed, and whether the model routing was verified. A locking system prevents more than three of these tasks from running against the same files at once. The README does not mention a license.

Copy-paste prompts

Prompt 1
Explain how the explore, implement, and review roles differ in what they are allowed to do
Prompt 2
Walk me through installing this skill globally and approving its Codex hooks for the first time
Prompt 3
Show me how to run the explore profile to trace a piece of code without modifying anything
Prompt 4
Explain how the routing verification step confirms which AI model and reasoning setting actually ran
Prompt 5
Help me understand when I should use the Ultra takeover mode instead of a normal executor role

Frequently asked questions

What is codex-skill?

A Codex CLI setup that splits AI coding work between a planning AI and three restricted worker roles, and verifies the actual model used instead of trusting its self reports.

What language is codex-skill written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Codex CLI.

How hard is codex-skill to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-skill for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.