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…

MITAuto-check passedWriting & Content

Install Humanize

skills CLI
$ npx skills add pedrohcgs/claude-code-my-workflow --skill humanize -a claude-code

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

GitHub CLI
$ gh skill install pedrohcgs/claude-code-my-workflow humanize --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/pedrohcgs/claude-code-my-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/humanize .claude/skills/humanize && 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
humanize
GitHub stars
1.6k
Token cost
~2.9k tokens
SKILL.md length
1,419 words
Files
1
Skills in repo
59
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 10 steps: BOILERPLATE TRANSITIONS → AI-CLICHÉ LEXICON → EM-DASH AND PUNCTUATION OVERUSE → …
  • User says humanize
  • SKILL.md covers Why this skill exists, What this skill is NOT, When to use and When NOT to use, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Humanize is an agent skill from pedrohcgs/claude-code-my-workflow. 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…

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Humanizing AI text, Project scaffolding and LaTeX. The repository describes itself as: A ready-to-fork Claude Code template for academics using LaTeX/Beamer + R. Multi-agent review, quality gates, adversarial QA, and replication protocols. The licence is MIT.

When your agent uses it

  • User says humanize
  • Does this sound like AI?
  • Check for AI tells
  • De-AI this draft

Example prompts

  • “Moreover”
  • “Furthermore”
  • “It is important to note that”
  • “/humanize”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Glob, Write, Agent, Task

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. BOILERPLATE TRANSITIONS
  2. AI-CLICHÉ LEXICON
  3. EM-DASH AND PUNCTUATION OVERUSE
  4. SYMMETRIC PARAGRAPH SHAPES
  5. TRICOLON ABUSE
  6. HEDGING STACKING
  7. "NOT ONLY X, BUT ALSO Y" FRAMES
  8. FORMULAIC OPENERS
  9. HYPHENATION EXCESS
  10. SYCOPHANCY / SELF-IMPORTANT FRAMING

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • Write
    • Agent
    • Task

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

Humanize loads about 2.9k tokens when it runs. Until then it costs about 158 tokens; SKILL.md has 1,419 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from pedrohcgs/claude-code-my-workflow at commit ae72617, republished under its MIT licence (© pedrohcgs). 1,419 words, ~2,907 tokens.

Download SKILL.mdSave it as .claude/skills/humanize/SKILL.md (or your agent's skills folder).
name
humanize
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.
allowed-tools
Read, Grep, Glob, Write, Agent, Task
argument-hint
[filename or 'all'] [--severity low|med|high]
disable-model-invocation
true
disallowed-tools
Edit, MultiEdit
metadata.author
Claude Code Academic Workflow
metadata.version
1.0.0

/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

  • Before journal submission.
  • Before posting a working paper / preprint / SSRN draft.
  • After any AI-assisted prose generation (R&R response drafts, lit-review synthesis, abstract revisions).
  • As a self-discipline pass after long writing sessions — your own writing drifts toward LLM patterns when you stare at LLM output all day.

When NOT to use

  • On .bib, .R, or other non-prose files — the detectors are tuned for academic prose.
  • On code comments — the tells are different.
  • On UI/UX copy — voice norms diverge.

Detection categories

The humanize-auditor agent checks these category groups:

1. BOILERPLATE TRANSITIONS

High-confidence AI tells when they appear sentence-initial or mid-paragraph as connective tissue:

  • Moreover, / Furthermore, / Additionally, / In addition,
  • It is important to note that / It is worth noting that / Notably,
  • In conclusion, / In summary, / To summarise,
  • On the other hand, (when not contrasting two named things)
  • Building on this, / Building upon this,
  • As we can see, / As is evident, / Indeed, (stacked)

Severity: HIGH if more than 1 per 1000 words. MED if 1 per 2000 words. LOW if rare but present.

2. AI-CLICHÉ LEXICON

Words and phrases statistically over-represented in LLM output relative to academic prose:

  • "navigate the complexities", "navigate the landscape"
  • "delve into", "delve deeper into"
  • "tapestry of", "rich tapestry"
  • "robust framework", "comprehensive framework", "holistic framework"
  • "comprehensive approach" / "multifaceted approach" / "nuanced approach" (especially when stacked)
  • "leverage" (as a verb in non-finance / non-engineering contexts)
  • "in today's [X] landscape" / "in today's rapidly evolving"
  • "play a crucial role" / "play a pivotal role" / "play a significant role"
  • "shed light on"
  • "underscore the importance" / "highlight the importance"
  • "It is essential to" / "It is crucial to"

Severity: HIGH on a paper's first three pages (abstract, intro). MED elsewhere.

3. EM-DASH AND PUNCTUATION OVERUSE
  • Em-dash overuse — more than 3 em-dashes per paragraph is a tell.
  • Semicolon stacks — three or more semicolons in a single paragraph.
  • Triple-Oxford-comma constructions — lists of three with deliberate parallelism repeated paragraph-to-paragraph.

Severity: MED. Em-dashes are a legitimate authorial choice; flag overuse, not all use.

4. SYMMETRIC PARAGRAPH SHAPES

Paragraphs with the same micro-architecture: topic sentence → three examples → summarising clause. Repeated across consecutive paragraphs is the AI tell — not the shape itself.

Detection: flag any three-paragraph window where each paragraph fits the topic→examples→summary cadence.

Severity: MED if 3-paragraph window; HIGH if 5+ paragraph stretch.

5. TRICOLON ABUSE

"X, Y, and Z" three-element lists are a legitimate rhetorical device. Tells are:

  • More than 4 tricolons per page.
  • Tricolons used for items that could naturally be 2 or 4.
  • Adjective tricolons stacked ("clear, concise, and compelling"; "rigorous, robust, and reliable").

Severity: LOW if rare; MED if patterned.

6. HEDGING STACKING

Stacked epistemic hedges in single sentences:

  • "might potentially be argued"
  • "could possibly suggest"
  • "may arguably"
  • "perhaps potentially"

Severity: HIGH — these are almost never authorial choices; they're LLM uncertainty-management.

7. "NOT ONLY X, BUT ALSO Y" FRAMES

Used sparingly, this is a legitimate construction. AI tells:

  • More than 2 per paper.
  • Used when X and Y are not actually parallel.
  • Used as paragraph openers.

Severity: MED.

8. FORMULAIC OPENERS
  • Section openers of the form "This [paper / chapter / section / analysis] [does X]."
  • Paragraph openers that re-state the section title.
  • Abstract opening with "In this paper, we..." (legitimate in some sub-fields; flag for review where it's atypical, e.g., AER abstracts rarely use it).

Severity: LOW unless every section starts this way.

9. HYPHENATION EXCESS

Long chains of compound modifiers as a paragraph signature:

  • "data-driven", "evidence-based", "well-suited", "well-established", "long-standing" — fine individually; flag if three or more appear in a single paragraph.

Severity: LOW.

10. SYCOPHANCY / SELF-IMPORTANT FRAMING
  • "This important contribution"
  • "This significant finding"
  • "Our novel approach"
  • Self-citation as "groundbreaking" / "pioneering"

Severity: HIGH — these read as AI-generated promotional copy; referees will react badly.

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

Steps

  1. Identify files to audit:

    • If $ARGUMENTS starts with a filename: audit that file only.
    • If $ARGUMENTS is all: audit all .qmd, .tex, .md files in Slides/, Quarto/, root, and master_supporting_docs/.
    • Skip .bib, .R, .py, code files, and any file under scripts/.
  2. Parse --severity flag (default: report all).

    • --severity low → report all findings.
    • --severity med → suppress LOW findings.
    • --severity high → report only HIGH findings.
  3. For each file, launch the humanize-auditor agent with the 10 detection categories.

  4. Receive structured report from the agent. Format per finding:

    line N | category | severity | current text | suggested rewrite or "remove"
  5. Write report to quality_reports/audits/humanize_<filename>_report.md. Include:

    • Per-category counts (HIGH / MED / LOW)
    • Per-finding table
    • Summary recommendation (rough thresholds):
      • > 8 HIGH findings per 1000 words: prose reads as AI-drafted. Author should rewrite the affected sections, not patch.
      • 5–8 HIGH per 1000 words: substantial AI voice. Strip the tells before submission.
      • < 5 HIGH per 1000 words: light cleanup; mostly cosmetic.
  6. Present summary to user:

    • Total findings per category
    • Most concentrated paragraphs (top 3)
    • Action recommendation (rewrite vs. strip vs. cosmetic)

Pairings

SituationDo
When you've drafted prose with AI assistanceRun /humanize before submission. Pair with /proofread (grammar) and /verify-claims (citations).
When you wrote in your own voiceRun /humanize anyway — your own prose drifts toward LLM patterns after long sessions of AI-assisted work.
Submission-ready review/review-paper --peer [journal] --variance 3 for substance, /humanize for voice, /verify-claims for facts.

Anti-pattern: no --rewrite mode

We deliberately do not ship /humanize --rewrite. Auto-rewriting prose to strip AI tells tends to degrade it — the rewriter introduces its own AI tells — and, as writing-with-ai.md records, a model's rewrite of its own output still reads as model output to a detector. The detect-and-flag pattern preserves authorial voice; the cost is your editing time, which is exactly the cost we want to pay.

If you find yourself reaching for an auto-rewriter, that's the signal to rewrite the paragraph from scratch — not to patch the tells one by one.

Output

  • Report at quality_reports/audits/humanize_<filename>_report.md (that subdirectory is gitignored).
  • Summary to the conversation: counts per category, top concentrated paragraphs, action recommendation.
  • No file edits. The user reads the report and applies changes manually.

Respect a documented voice profile

If voice-profile.md exists at the repo root, read it first. A habit the author has declared deliberate — frequent em-dashes, first person, a particular connective — is not a finding. Flagging a documented preference as an AI tell is a false positive, and false positives erode the report's authority faster than misses do.

Build one with /voice-profile. This skill says what to remove; that one says what to write toward.

What this skill cannot do (v2.5)

/humanize finds surface tells — boilerplate transitions, the AI-cliché lexicon, hedging stacks, symmetric paragraph shapes. Fixing them improves readability, which is worth doing whoever wrote the text.

It does not make prose stop reading as machine-generated to a detector. An article polished through several rounds of surface de-AI-ing was submitted to Pangram, a neural AI-text detector, and came back 100% AI-written. Those detectors classify on the token-level statistics of LLM generation, which survive any transformation the model applies — because every transformation is still LLM-generated text.

So: a clean report here means the prose reads well. It does not mean it reads human. If provenance matters, the author writes the load-bearing sentences and measures with a real detector. See writing-with-ai.md.

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

Files

Just SKILL.md in .claude/skills/humanize of pedrohcgs/claude-code-my-workflow.

Open the folder on GitHubat commit ae72617

Compare with similar skills

Humanize 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.

Humanize compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Humanize this skillpedrohcgs/claude-code-my-workflow1.6k—~2.9kAutomated safety check: PassMIT
Venue TemplatesK-Dense-AI/claude-scientific-writer2.4k2 repos~2.9kAutomated safety check: PassMIT
LaTeX Conference Template OrganizerGalaxy-Dawn/claude-scholar5.7k1 repos~3.5kAutomated safety check: PassMIT
Nature-Style Academic PolishingYuan1z0825/nature-skills46k—~1.5kAutomated safety check: PassApache-2.0
Academic Paper PolishHKUSTDial/Supervisor-Skills8.5k—~3.1kAutomated safety check: PassCC-BY-NC-SA-4.0
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence

Similar skills

  • Venue Templates

    K-Dense-AI/claude-scientific-writer

    Prepare journal manuscripts, conference papers, research posters, and grant documents using venue-specific formatting guidance and bundled LaTeX scaffolds.

    2.4k GitHub starsUsed in 2 repos~2.9k tokens
    Documents & OfficeAuto-check passed
  • LaTeX Conference Template Organizer

    Galaxy-Dawn/claude-scholar

    Cleans up a messy conference LaTeX template .zip into a tidy, Overleaf-ready project, after showing you the problems and a cleanup plan to approve.

    5.7k GitHub starsUsed in 1 repo~3.5k tokens
    Documents & OfficeAuto-check passed
  • Nature-Style Academic Polishing

    Yuan1z0825/nature-skills

    Polishes, translates or tightens existing academic prose and fixes manuscript LaTeX layout while keeping facts, terminology and evidence boundaries intact.

    46k GitHub stars~1.5k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Academic Paper Polish

    HKUSTDial/Supervisor-Skills

    Polishes academic prose without changing its meaning: grammar and flow fixes, tone matched to the evidence, AI-tone removal and Chinese-to-English rewriting for submission.

    8.5k GitHub stars~3.1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated 5 days ago
    Research & ScienceAuto-check passed
  • Research Writing

    alfonso0512/research-writing-skill

    科研论文写作助手,提供 30 个 Prompt 模板覆盖论文写作全流程. An agent skill from alfonso0512/research-writing-skill.

    487 GitHub starsUsed in 1 repo~818 tokens
    Documents & OfficeAuto-check passed

More from pedrohcgs/claude-code-my-workflow

All 59 skills in this repo
  • Devils Advocate

    pedrohcgs/claude-code-my-workflow

    Adversarial 5-7 question challenge to a deck's pedagogical choices — ordering, prerequisites, cognitive load, motivation.

    1.6k GitHub starsUsed in 2 repos~641 tokens
    Auto-check passed
  • Vaccinate

    pedrohcgs/claude-code-my-workflow

    Qualify a check before it is allowed to clear anything — prove it can detect the failure it is meant to catch.

    1.6k GitHub stars~2.1k tokensUpdated 11 days ago
    Auto-check: notes
  • Compile Latex

    pedrohcgs/claude-code-my-workflow

    Compile a Beamer LaTeX slide deck with XeLaTeX (3 passes + bibtex).

    1.6k GitHub starsUsed in 1 repo~492 tokens
    Auto-check: notes
  • Context Status

    pedrohcgs/claude-code-my-workflow

    Show current context status and session health. An agent skill from pedrohcgs/claude-code-my-workflow.

    1.6k GitHub starsUsed in 1 repo~613 tokens
    Auto-check: notes
  • Disclosure Check

    pedrohcgs/claude-code-my-workflow

    Pre-screen analysis outputs (tables, figures, logs) built on restricted or confidential data for statistical-disclosure-limitation problems before any release.

    1.6k GitHub starsUsed in 1 repo~2.6k tokens
    Auto-check: notes
  • Stata Replication

    pedrohcgs/claude-code-my-workflow

    End-to-end Stata replication pipeline — scaffolds numbered .do files in scripts/stata/, executes them via the stata-mcp MCP server, captures logs and outputs to output/, and produces…

    1.6k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check: notes

Questions about Humanize

What does Humanize do?

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…. Humanize is an agent skill from pedrohcgs/claude-code-my-workflow.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.

When should I use Humanize?

Humanize fits situations like: user says humanize; does this sound like AI?; check for AI tells; de-AI this draft.

How do I install Humanize in Claude Code?

Run `npx skills add pedrohcgs/claude-code-my-workflow --skill humanize -a claude-code`. Or copy the skill folder (.claude/skills/humanize in pedrohcgs/claude-code-my-workflow) into .claude/skills/humanize in your project. Claude Code loads it when a task matches its description.

How do I install Humanize in Codex?

Run `npx skills add pedrohcgs/claude-code-my-workflow --skill humanize -a codex`. Or copy the skill folder (.claude/skills/humanize in pedrohcgs/claude-code-my-workflow) into .agents/skills/humanize in your project. Codex loads it when a task matches its description.

Can I use Humanize 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 pedrohcgs/claude-code-my-workflow --skill humanize -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/humanize, .gemini/skills/humanize, .github/skills/humanize and .opencode/skills/humanize in your project.

What does Humanize need to run?

SKILL.md names no scripts, command-line tools or credentials: Humanize is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob, Write, Agent, Task.

Does Humanize 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 Humanize 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. Review the folder before installing.

What licence does Humanize use?

Humanize 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 Humanize use?

About 2.9k tokens (SKILL.md is roughly 12k 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 Humanize?

Skills that share tags, products or a category with Humanize: Venue Templates (K-Dense-AI/claude-scientific-writer, 2.4k stars), LaTeX Conference Template Organizer (Galaxy-Dawn/claude-scholar, 5.7k stars), Nature-Style Academic Polishing (Yuan1z0825/nature-skills, 46k stars) and Academic Paper Polish (HKUSTDial/Supervisor-Skills, 8.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Humanize?

pedrohcgs (a GitHub user) maintains it in pedrohcgs/claude-code-my-workflow, which has 1,645 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on September 27, 2026.

Source: pedrohcgs/claude-code-my-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.