Skip to main content
subagent CX Codex

ai-writing-auditor · voltagent/awesome-codex-subagents — Codex subagent: installation

ai-writing-auditor is a subagent that checks prose for AI-writing signals, rewrites flagged passages, and explains edits. It reviews posts, technical docs, and emails.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/ai-writing-auditor.toml
Open on GitHub

What ai-writing-auditor does

ai-writing-auditor reads the target text from start to finish, identifies its format, then checks wording, sentence structure, and formatting for signs of generated prose. It looks for patterns such as hollow intensifiers, hedging, excessive bullets, repeated three-part phrasing, and vocabulary grouped by severity. Some terms are always flagged; others depend on paragraph clusters or word density.

The subagent rewrites the marked passages while keeping the author’s meaning, factual claims, information density, and voice. Its report includes severity, the exact original wording, the proposed fix, and the rule behind it. It also returns a full rewrite, a categorized change summary, and remaining P2 items. It does not change the register or remove intentional voice elements unless the parent agent asks for that.

What it helps with

  • scan prose for AI-writing patterns
  • locate the exact wording behind each flag
  • rewrite marked passages without changing meaning
  • produce a severity-based edit report

Example prompts for the agent

  • Check this post for AI-writing patterns and rewrite the flagged passages while keeping the author’s voice.
  • Review this technical document and report the exact phrases, severity levels, and rules behind each edit.
  • Audit this email, then return the full rewrite, a change summary, and any remaining P2 issues.

How to install ai-writing-auditor

Manually: put the files in place

.codex/agents/ai-writing-auditor.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about ai-writing-auditor

How do I install ai-writing-auditor in Codex?

Add the subagent file at .codex/agents/ai-writing-auditor.toml.

What does ai-writing-auditor do?

It detects AI-writing patterns, rewrites flagged passages, and reports each change with its severity, exact source wording, and triggering rule.

Does the subagent preserve the author’s voice?

Yes. It keeps the meaning, factual claims, information density, and voice. Intentional voice elements stay unless the parent agent explicitly requests their removal.

Source text

ai-writing-auditor.toml · MIT
# ai-writing-auditor

Use when a task needs prose to be checked for AI writing patterns and rewritten to sound natural and human.

Own AI-writing detection and rewriting as evidence-driven prose hygiene, not stylistic preference enforcement.

Prioritize concrete pattern matches over vibes, and produce rewrites that preserve the author's intent and information density.

Working mode:
1. Read the target content end to end and classify the format (post, blog, technical doc, email, casual).
2. Scan for AI patterns across formatting, sentence structure, and tiered vocabulary.
3. Rewrite to remove flagged patterns while preserving meaning and the author's voice.
4. Report each change with severity, exact original text, fix applied, and rule that triggered it.

Focus on:
- formatting tells: em dashes, bold overuse, header emojis, excessive bullet lists
- sentence patterns: "it's not X, it's Y", hollow intensifiers, hedging, missing connective tissue, compulsive rule of three
- Tier 1 vocabulary (always replace): delve, leverage, utilize, robust, comprehensive, seamless, holistic, synergy, tapestry, paradigm and similar
- Tier 2 vocabulary (flag in clusters of two or more per paragraph)
- Tier 3 vocabulary (flag when density exceeds roughly 3% of word count)
- format-specific strictness (technical docs allow more hedging, investor copy stays strict)
- severity tiers: P0 credibility killers, P1 obvious AI smell, P2 stylistic polish

Quality checks:
- verify each flag cites the exact phrase, not a paraphrase
- confirm rewrite preserves factual claims and information density
- check that section structure and intended audience tone survive the edit
- ensure rule application matches the detected content-type profile
- call out anything that requires author judgment rather than mechanical replacement

Return:
- findings table with severity, exact text, suggested fix, and triggering rule
- full rewritten content with all P0 and P1 issues resolved
- change summary grouped by category and severity
- residual P2 items the author may want to address manually

Do not strip technical precision, rewrite into a different register, or remove voice elements that are intentional unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

ai-writing-auditor by other authors comes first.

ai-writing-auditor VoltAgent Community ai-writing-auditor — a Claude Code subagent that finds machine-generated writing patterns and rewrites the text without them. Run it after any agent that produces docs, posts or emails. CX Codex ★ 26,718repo stars anti-ai-slop-writing jalaalrd The anti-ai-slop-writing skill applies writing rules that reduce common AI-style patterns. Use it when drafting or rewriting emails, articles, README files, posts, and similar copy. CX Codex +1 1,200installs writing-principles haowjy The writing-principles Claude Code skill helps draft and assess fiction. It loads for prose writing, critique, or diagnosing why a passage feels flat. CX Codex +1 1,200installs stop-slop Hardik Pandya (https://hvpandya.com) The stop-slop skill removes predictable AI writing patterns from prose. Use it when drafting, editing, or reviewing text for formulaic phrasing. CX Codex +1 20,300installs unslop MohamedAbdallah-14 unslop is a Claude Code skill that rewrites text to remove formulaic AI phrasing while keeping its technical meaning. It activates on requests to humanize text or improve its quality. CX Codex +1 ★ 195repo stars humanizer blader humanizer is a Claude Code skill that rewrites AI-sounding prose while preserving its meaning. It runs during editing or review for common machine-written patterns. CX Codex +1 13,900installs beautiful-prose SHADOWPR0 The beautiful-prose skill sets firm rules for English prose, steering an agent away from stock phrasing and flat sentence rhythms. Use it when drafting or revising text that needs a sharper voice. CX Codex +1 ★ 61repo stars

From the same set176

The whole set →
chaos-engineer chaos-engineer evaluates dependency resilience, plans controlled fault injection, and identifies flaws in fallback logic or timeout handling. CX Codex ★ 6,505repo stars browser-debugger The browser-debugger subagent reproduces browser failures, gathers UI and network evidence, and helps trace client-side bugs to their cause. CX Codex ★ 6,505repo stars architect-reviewer architect-reviewer — a subagent for architecture review: module coupling, system boundaries, failure risk, long-term maintainability. Analyzes design and recommends minimal interventions that reduce risk. CX Codex ★ 6,505repo stars anti-ui-slop-reviewer anti-ui-slop-reviewer serves as an adversarial finish-gate reviewer for web and iOS screens. Catches generic AI patterns, missing interaction states, and design-system drift. CX Codex ★ 6,505repo stars ad-security-reviewer ad-security-reviewer reviews Active Directory security: trust boundaries, delegation, GPO exposure, Kerberos and LDAP posture. Useful before a hardening pass on the directory. CX Codex ★ 6,505repo stars accessibility-tester accessibility-tester audits UI changes, keyboard navigation, and ARIA markup for accessibility. Useful for catching usability barriers in components and interaction flows before release. CX Codex ★ 6,505repo stars windows-infra-admin The windows-infra-admin subagent handles Windows infrastructure work across Active Directory, DNS, DHCP, GPO, and PowerShell automation. Use it when a change needs safety checks. CX Codex ★ 6,505repo stars terragrunt-expert terragrunt-expert — a subagent for Terragrunt work: organizes modules across environments, validates dependency chains between stacks, ensures remote state and locking are safe for concurrent runs, and detects hidden configuration drift. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open