Agent skill

Codex Commit

by tbhb in tbhb/vale-ai-tells

Group changes into atomic commits, draft and lint COMMITAGENTMSG, get an independent Codex review, explicitly confirm with the operator, commit through the protected wrapper, and rebase.

MITAuto-check passedDevelopment

Install Codex Commit

skills CLI
$ npx skills add tbhb/vale-ai-tells --skill codex-commit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tbhb/vale-ai-tells codex-commit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tbhb/vale-ai-tells.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/codex-commit .claude/skills/codex-commit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
codex-commit
GitHub stars
115
Token cost
~812 tokens
SKILL.md length
384 words
Files
5 (incl. scripts)
Skills in repo
27
Repo updated
First seen
Licence
MIT

At a glance

Group changes into atomic commits, draft and lint COMMITAGENTMSG, get an independent Codex review, explicitly confirm with the operator, commit through the protected wrapper, and rebase.

  • A tbhb repository task ends in a commit
  • Runs Shell scripts from its folder; calls git
  • The user asks to commit

What it does

Codex Commit is an agent skill from tbhb/vale-ai-tells. Group changes into atomic commits, draft and lint COMMITAGENTMSG, get an independent Codex review, explicitly confirm with the operator, commit through the protected wrapper, and rebase. Use whenever a tbhb repository task ends in a commit or the user asks to commit.

Its SKILL.md is about 810 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `scripts/commit.sh`, `scripts/preflight.sh` and `scripts/stamp-review.sh`).

It sits in Development, covering Linting and formatting. It works with Git. The repository describes itself as: In today's rapidly evolving landscape, vale-ai-tells is a comprehensive, cutting-edge Vale style package that empowers writers to seamlessly delve into the rich tapestry of AI…. The licence is MIT.

When your agent uses it

  • A tbhb repository task ends in a commit
  • The user asks to commit

Example prompts

  • “/codex-commit”

Requirements

  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit 4c7abc9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Codex Commit loads about 812 tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 384 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~812

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from tbhb/vale-ai-tells at commit 4c7abc9, republished under its MIT licence (© tbhb). 384 words, ~812 tokens.

Download SKILL.mdSave it as .claude/skills/codex-commit/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
codex-commit
description
Group changes into atomic commits, draft and lint COMMIT_AGENTMSG, get an independent Codex review, explicitly confirm with the operator, commit through the protected wrapper, and rebase. Use whenever a tbhb repository task ends in a commit or the user asks to commit.

Commit workflow

Run from the repository that holds the changes. Start with .agents/skills/codex-commit/scripts/preflight.sh.

Stop on an interrupted Git operation or missing precondition. Create and maintain an update_plan checklist for base, grouping, staging, draft, prose, review, gates, confirmation, commit, and rebase.

Use the recommended base from preflight. Read the whole diff and divide it into independently revertible logical changes. Stage every path by name with git add --. Never use git add ., git add -A, or git add --all. Confirm the index with the cached stat and short status.

Write the complete message to repo-root COMMIT_AGENTMSG. Use <type>(<scope>)?(!)?: <imperative description>. The body records why the change exists rather than restating the diff. Use only checked claims. Omit counts, sales language, and provenance. Hard-wrap body lines at 72 and trailers at 100. Put Assisted-by before the required Signed-off-by printed by preflight.

Invoke codex-fix-prose on COMMIT_AGENTMSG mise run lint-commit-msg. Then delegate codex-review-commit-message with fork_turns: "none", supplying only the repository root, optional --amend, and instruction to follow that skill. Resolve every finding and repeat prose lint plus independent review until it returns exactly VERDICT: PASS.

Only after receiving that verdict, run:

text
bash .agents/skills/codex-commit/scripts/stamp-review.sh <repo-root> <verdict-file>
mise run lint-commit-msg

Save the delegated agent's exact final response in the verdict file. The stamping script accepts only VERDICT: PASS and records both the draft digest and the staged tree.

After any edit to the draft or index, repeat the prose pass and independent review before stamping again.

Show full SKILL.md (152 more words)Show less

Confirmation and commit

Default mode always requires explicit operator confirmation unless preflight reports commit: GRANTED. Show the staged paths and complete message first. When the workflow needs confirmation, end the turn and ask Commit this message? Present Commit it, Revise the message, Restage and redraft, and Stop here. Don't commit in the turn that asks. The original request to commit doesn't count as this final confirmation.

After confirmation, commit only through:

text
bash .agents/skills/codex-commit/scripts/commit.sh

The wrapper verifies the review digest and staged manifest. It accepts only --amend. Never invoke git commit directly or bypass hooks.

Rebase onto the recorded base with rebase.updateRefs=false, rebase.autoSquash=false, and --autostash. Never use a bare git stash pop. A conflict routes to codex-rebase. Report the resulting commit and any remaining atomic groups.

CODEX_THREAD_ID keys pre-approval. Without it, ask for confirmation. Ask despite a grant if review findings remain, a gate required judgment, grouping changed, or the commit exceeds the task’s scope.

© tbhb, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts) in .claude/skills/codex-commit of tbhb/vale-ai-tells.

  • SKILL.md
  • scripts/commit.sh
  • scripts/preflight.sh
  • scripts/stamp-review.sh
  • tokens.json

Open the folder on GitHubat commit 4c7abc9

Compare with similar skills

Codex Commit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Codex Commit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codex Commit this skilltbhb/vale-ai-tells115—~812Automated safety check: PassMIT
Saleor Commit Workflowsaleor/saleor23k—~575Automated safety check: PassBSD-3-Clause
Qt Cpp ReviewSerial-Studio/Serial-Studio7.2k—~4.3kAutomated safety check: PassCustom licence
Qt Qml ReviewSerial-Studio/Serial-Studio7.2k—~3.7kAutomated safety check: PassCustom licence
Lint Commit PRTresjs/tres3.8k—~1.1kAutomated safety check: PassMIT
Qt6 QML Code Reviewerx-tools-author/x-tools1.1k1 repos~3.6kAutomated safety check: PassBSD-3-Clause

Similar skills

  • Commits changes in the Saleor codebase and works through pre-commit hook failures from ruff, mypy, the GraphQL schema check and the migrations check.

    23k GitHub stars~575 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Qt Cpp Review

    Serial-Studio/Serial-Studio

    Qt6/C++ deep code review for Serial Studio. An agent skill from Serial-Studio/Serial-Studio.

    7.2k GitHub stars~4.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Qt Qml Review

    Serial-Studio/Serial-Studio

    Qt6/QML deep code review for Serial Studio. An agent skill from Serial-Studio/Serial-Studio.

    7.2k GitHub stars~3.7k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Lint Commit PR

    Tresjs/tres

    Lint local changes, auto-fix, conventional commit, and optionally create PR

    3.8k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Qt6 QML Code Reviewer

    x-tools-author/x-tools

    Runs a 47-rule deterministic QML linter, then six parallel deep-analysis passes over bindings, layout, loaders, delegates, states, and performance.

    1.1k GitHub starsUsed in 1 repo~3.6k tokens
    DevelopmentAuto-check passed
  • PR Push

    icebear0828/codex-proxy

    Package the current working changes into a standards-compliant codex-proxy pull request: branch hygiene, commit message linting, CHANGELOG prompt, conventional commit, push, and gh pr create against…

    1.8k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check: notes

More from tbhb/vale-ai-tells

All 27 skills in this repo
  • Analyze Session

    tbhb/vale-ai-tells

    Query a Claude Code transcript without reading it into context, then write the retrospective to disk so it remains available after the session ends.

    115 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Codex Analyze Session

    tbhb/vale-ai-tells

    Query a Codex transcript without reading it into context, then write the retrospective to disk so it remains available after the session ends.

    115 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Codex Fix PR

    tbhb/vale-ai-tells

    Diagnose failing pull request checks, reproduce them locally, make focused fixes, commit them through codex-commit, and refresh the published description when needed.

    115 GitHub stars~575 tokensUpdated yesterday
    Auto-check passed
  • Codex Merge PR

    tbhb/vale-ai-tells

    Squash merge a pull request. An agent skill from tbhb/vale-ai-tells.

    115 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Codex PR

    tbhb/vale-ai-tells

    Open or update a pull request for the current branch with an independently drafted and reviewed PRAGENTDESC.md.

    115 GitHub stars~846 tokensUpdated yesterday
    Auto-check passed
  • Codex Rebase

    tbhb/vale-ai-tells

    Replay the current branch onto its base and establish that the result is sound.

    115 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Codex Commit

What does Codex Commit do?

Group changes into atomic commits, draft and lint COMMITAGENTMSG, get an independent Codex review, explicitly confirm with the operator, commit through the protected wrapper, and rebase. Codex Commit is an agent skill from tbhb/vale-ai-tells. Group changes into atomic commits, draft and lint COMMITAGENTMSG, get an independent Codex review, explicitly confirm with the operator, commit through the protected wrapper, and rebase.

When should I use Codex Commit?

Codex Commit fits situations like: A tbhb repository task ends in a commit; the user asks to commit.

How do I install Codex Commit in Claude Code?

Run `npx skills add tbhb/vale-ai-tells --skill codex-commit -a claude-code`. Or copy the skill folder (.claude/skills/codex-commit in tbhb/vale-ai-tells) into .claude/skills/codex-commit in your project. Claude Code loads it when a task matches its description.

How do I install Codex Commit in Codex?

Run `npx skills add tbhb/vale-ai-tells --skill codex-commit -a codex`. Or copy the skill folder (.claude/skills/codex-commit in tbhb/vale-ai-tells) into .agents/skills/codex-commit in your project. Codex loads it when a task matches its description.

Can I use Codex Commit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tbhb/vale-ai-tells --skill codex-commit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codex-commit, .gemini/skills/codex-commit, .github/skills/codex-commit and .opencode/skills/codex-commit in your project.

What does Codex Commit need to run?

Going by SKILL.md and its folder, Codex Commit needs a shell for the scripts in its folder and the command-line tools its instructions call (git). Our summary lists: A Bash shell.

Does Codex Commit access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Codex Commit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Codex Commit use?

Codex Commit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Codex Commit use?

About 812 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Codex Commit?

Skills that share tags, products or a category with Codex Commit: Saleor Commit Workflow (saleor/saleor, 23k stars), Qt Cpp Review (Serial-Studio/Serial-Studio, 7.2k stars), Qt Qml Review (Serial-Studio/Serial-Studio, 7.2k stars) and Lint Commit PR (Tresjs/tres, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codex Commit?

tbhb (a GitHub user) maintains it in tbhb/vale-ai-tells, which has 115 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on October 7, 2026.

Source: tbhb/vale-ai-tells on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.