# Humanize

Read-only audit of `.tex`, `.qmd`, or `.md` text for AI-voice tells, boilerplate...

- Repository: https://github.com/pedrohcgs/claude-code-my-workflow (1676 stars)
- Category: Media
- License: MIT
- Last updated: 2026-09-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add pedrohcgs/claude-code-my-workflow --skill humanize -g -a claude-code -y`
Codex: `npx skills add pedrohcgs/claude-code-my-workflow --skill humanize -g -a codex -y`
Cursor: `npx skills add pedrohcgs/claude-code-my-workflow --skill humanize -g -a cursor -y`
Gemini CLI: `npx skills add pedrohcgs/claude-code-my-workflow --skill humanize -g -a gemini-cli -y`

## Description

Read-only audit of `.tex`, `.qmd`, or `.md` text for AI-voice tells, boilerplate transitions ("Moreover", "Furthermore", "It is important to note that"), AI-cliché lexicon ("delve", "navigate the complexities", "tapestry", "robust framework"), em-dash overuse, symmetric paragraph shapes, tricolon abuse, hedging stacking, "not only X but also Y" frames, and formulaic openers. Produces a report; does NOT rewrite. Use when user says "humanize", "does this sound like AI?", "check for AI tells", "de-AI this draft", "remove AI voice", "audit my prose for sycophancy", or before journal submission / posting a working paper.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# `/humanize`, AI-voice audit (detect-and-flag)

Read the target file (or all paper-like files), audit for the canonical AI-voice tells in academic prose, and write a structured report. **The skill does not rewrite.** The author edits.

## Why this skill exists

Referees and editors increasingly recognise AI-generated prose. The tells are not stylistic preferences, they're statistically conspicuous patterns the LLM training distribution produces at higher rates than human academic writers. Five reasons to audit before submission:

1. **Reviewer suspicion is a tax.** Even good substance pays a credibility tax if the prose reads as AI-drafted.
2. **Journal policy is tightening.** A growing number of venues require disclosure or prohibit AI-drafted text.
3. **AI tells signal weak content.** Boilerplate transitions ("Moreover", "It is important to note") almost always cover up logical gaps the author didn't think through.
4. **You are not the tells.** Even authors who use AI tools heavily can preserve their own voice by stripping the model's lexical fingerprint.
5. **The fix is cheap once you can see it.** The cost is detection, not rewriting, once the report flags the tells, removal is mechanical.

## What this skill is NOT

- **Not a rewriter.** No `--rewrite` mode. An automatic rewriter introduces its own tells and cannot change what a neural detector sees (see `writing-with-ai.md`); the author preserves voice by editing manually.
- **Not a substance reviewer.** Use `/review-paper` for argument structure, identification, citations.
- **Not a grammar checker.** Use `/proofread` for grammar, typos, overflow, citation format.
- **Not a fact-checker.** Use `/verify-claims` for Chain-of-Verification fact-checking of citations and numeric claims.

`/humanize` is the *voice* lens. Run it alongside the others, none of them substitute.

## When to use

The rest: https://github.com/pedrohcgs/claude-code-my-workflow/blob/HEAD/.claude/skills/humanize/SKILL.md