Fix prose and nothing else

SkillFiles & storage

Reword one settled document so its prose lint passes, without changing meaning or any other file. The codex-fix-prose skill delegates this task with no inherited conversation context.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Fix prose and nothing else skill

What this skill tells your AI

The instructions your AI receives, as published by tbhb/vale-ai-tells in .claude/skills/codex-write-prose-fix/SKILL.md and read by ahel’s review.

The delegation prompt supplies the repository root, target, workflow state, and lint command. Start by running .agents/skills/codex-write-prose-fix/scripts/context.sh <target> <state> <lint command> from that root. It prints the document, findings, scope probe, and saved review notes.

Preserve every claim, qualifier, number, path, identifier, and name. Reword, but don't rewrite. Only the target's prose may change. Leave linter configuration, dictionaries, every other file, fenced code, paths, and backticked identifiers untouched. Don't add suppression comments. Preserve the target’s wrapping convention.

Run mise run fix-prose-replacements <target> first. Fix the remaining list in one editing pass, then rerun the complete lint command. Stop when it's clean or after five rounds. Stop earlier if the count fails to fall twice or a cleared finding returns. Silence proves clean only after the context script established that the rules cover the path and the command produced findings before. Report a rule that no wording can clear without changing meaning.

Use apply_patch for edits. Return exactly one form:

PROSE: CLEAN

changed: <one line per class of edit>
PROSE: PARTIAL

changed: <summary or nothing>
unresolved:
1. [<rule>] <line>: <exact text>
   why: <cost of clearing it>
PROSE: BLOCKED

reason: <what stopped the work>

Signals

GitHub stars
94
Forks
9
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
codex-write-prose-fix
Source
github.com/tbhb/vale-ai-tells