Agent skill

Codex Fix Prose

by tbhb in tbhb/vale-ai-tells

Clear vale and cspell findings on a settled document through an isolated Codex writer and an independent reviewer.

MITAuto-check passedDevelopment

Install Codex Fix Prose

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

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

GitHub CLI
$ gh skill install tbhb/vale-ai-tells codex-fix-prose --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-fix-prose .claude/skills/codex-fix-prose && 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-fix-prose
GitHub stars
115
Token cost
~661 tokens
SKILL.md length
315 words
Files
4 (incl. scripts)
Skills in repo
27
Repo updated
First seen
Licence
MIT

At a glance

Clear vale and cspell findings on a settled document through an isolated Codex writer and an independent reviewer.

  • A drafts prose gates are red
  • Runs Shell scripts from its folder
  • Repeated lint findings would pollute the parent context

What it does

Codex Fix Prose is an agent skill from tbhb/vale-ai-tells. Clear vale and cspell findings on a settled document through an isolated Codex writer and an independent reviewer. Use when a draft's prose gates are red or repeated lint findings would pollute the parent context. Takes a target and its complete lint command.

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/check-suppressions.sh`, `scripts/preflight.sh` and `tokens.json`).

It sits in Development, covering Linting and formatting. 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 drafts prose gates are red
  • Repeated lint findings would pollute the parent context

Example prompts

  • “/codex-fix-prose”

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 2 files in scripts/ (Shell), which the agent can run.

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

  • Network

    No URLs in SKILL.md.

    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 Fix Prose loads about 661 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 315 words of instructions outside code blocks.

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

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). 315 words, ~661 tokens.

Download SKILL.mdSave it as .claude/skills/codex-fix-prose/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
codex-fix-prose
description
Clear vale and cspell findings on a settled document through an isolated Codex writer and an independent reviewer. Use when a draft's prose gates are red or repeated lint findings would pollute the parent context. Takes a target and its complete lint command.

Orchestrate a prose fix

Keep findings and retries out of the parent context. Parse the request into a target and complete lint command, then run:

text
bash .agents/skills/codex-fix-prose/scripts/preflight.sh <target> <lint command>

Stop on BLOCKED. On PROCEED, create a plan with update_plan: baseline, writer, mechanical verification, independent review, final lint.

Record the baseline before delegation:

text
bash .agents/skills/codex-fix-prose/scripts/check-suppressions.sh --baseline <target>

Save the absolute state: path that command prints. It identifies this workflow and records its target. Until cleanup, the script refuses a second workflow on the same target. Pass the state to every delegated writer and reviewer in this run.

Delegate codex-write-prose-fix with fork_turns: "none". Give it only the repository root, target, workflow state, lint command, and instruction to follow that skill. Wait for its terminal report. Never edit the target in the parent.

Run check-suppressions.sh --verify <state> <target>. Any finding means the run isn't clean. Delegate codex-review-prose-fix with fork_turns: "none", giving it the repository root, target, and workflow state. If it returns changes required, save those findings in <state>/notes, delegate the writer again with the same minimal prompt, and repeat verification and review. Bound this writer/reviewer loop at three review rounds.

Finally run the complete lint command once in the parent. Always run check-suppressions.sh --cleanup <state> before returning once no delegated agent needs the state, even when the outcome is unresolved or blocked. Report PROSE: CLEAN only when the writer reported clean, the suppression check is silent, the independent reviewer returned REVIEW: CLEAN, and the final lint command passes. Otherwise return the short unresolved or blocked report. Mark each plan item as it completes.

Safety rules:

  • Only the delegated writer may edit the target, and the target is the only file it may edit.
  • Never change lint configuration, dictionaries, hooks, or suppression comments.
  • Don't infer clean from silent output unless preflight proved the target has prose rules.
  • Don't expose full lint findings in the parent response unless the workflow blocks and the operator needs a decision.

© 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 3 other files (scripts) in .claude/skills/codex-fix-prose of tbhb/vale-ai-tells.

  • SKILL.md
  • scripts/check-suppressions.sh
  • scripts/preflight.sh
  • tokens.json

Open the folder on GitHubat commit 4c7abc9

Compare with similar skills

Codex Fix Prose 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 Fix Prose compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codex Fix Prose this skilltbhb/vale-ai-tells115—~661Automated safety check: PassMIT
Summarise Ecosystem Resultsastral-sh/ruff50k1 repos~2.2kAutomated safety check: PassMIT
Template LibraryZJU-REAL/Easel3.2k—~1kAutomated safety check: PassApache-2.0
Post FormatterZJU-REAL/Easel3.2k—~537Automated safety check: PassApache-2.0
Code Layout Evaluation Principleskitchen-engineer42/pdf2skills134—~383Automated safety check: PassNone
Install Anti-Slop Oxlint Rulesdmmulroy/anti-slop5.3k1 repos~2.2kAutomated safety check: PassMIT

Similar skills

  • Official

    A skill your agent uses when a user says "summarise ecosystem results", "summarize this ty ecosystem report", "what changed in this ecosystem run?", or asks to summarise or summarize ty ecosystem…

    50k GitHub starsUsed in 1 repo~2.2k tokens
    DevelopmentAuto-check passed
  • Template Library

    ZJU-REAL/Easel

    内容模板的保存、复用、管理。把成功的内容结构保存为模板,下次直接套用,支持模板分类和版本管理. An agent skill from ZJU-REAL/Easel.

    3.2k GitHub stars~1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Post Formatter

    ZJU-REAL/Easel

    用 PAS、AIDA、BAB、STAR、SLAY 等经典框架将主题结构化为社媒帖子. An agent skill from ZJU-REAL/Easel.

    3.2k GitHub stars~537 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Code Layout Evaluation Principles

    kitchen-engineer42/pdf2skills

    Evaluate code layout quality based on accuracy, consistency, readability, and maintainability rather than aesthetics.

    134 GitHub stars~383 tokensUpdated 7 mo ago
    DevelopmentAuto-check passed
  • Installs, updates or migrates the vendored anti-slop Oxlint plugin in a repository, keeping local rule changes and the plugin's license and provenance files.

    5.3k GitHub starsUsed in 1 repo~2.2k tokens
    DevelopmentAuto-check passed
  • Official

    A skill your agent uses when a user says "minimize this ty ecosystem change", "reproduce this ecosystem result", "investigate a primer difference", "investigate a mypyprimer difference"…

    50k GitHub stars~4.6k tokensUpdated today
    DevelopmentAuto-check passed

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 today
    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 today
    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 today
    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 today
    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 today
    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 today
    Auto-check passed

Questions about Codex Fix Prose

What does Codex Fix Prose do?

Clear vale and cspell findings on a settled document through an isolated Codex writer and an independent reviewer. Codex Fix Prose is an agent skill from tbhb/vale-ai-tells. Clear vale and cspell findings on a settled document through an isolated Codex writer and an independent reviewer.

When should I use Codex Fix Prose?

Codex Fix Prose fits situations like: A drafts prose gates are red; repeated lint findings would pollute the parent context.

How do I install Codex Fix Prose in Claude Code?

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

How do I install Codex Fix Prose in Codex?

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

Can I use Codex Fix Prose 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-fix-prose -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-fix-prose, .gemini/skills/codex-fix-prose, .github/skills/codex-fix-prose and .opencode/skills/codex-fix-prose in your project.

What does Codex Fix Prose need to run?

Going by SKILL.md and its folder, Codex Fix Prose needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Codex Fix Prose access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Codex Fix Prose 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 Fix Prose use?

Codex Fix Prose 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 Fix Prose use?

About 661 tokens (SKILL.md is roughly 2.6k 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 Fix Prose?

Skills that share tags, products or a category with Codex Fix Prose: Summarise Ecosystem Results (astral-sh/ruff, 50k stars), Template Library (ZJU-REAL/Easel, 3.2k stars), Post Formatter (ZJU-REAL/Easel, 3.2k stars) and Code Layout Evaluation Principles (kitchen-engineer42/pdf2skills, 134 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codex Fix Prose?

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.