# Humanize

Should be used when writing or revising text, including responses, documentation...

- Repository: https://github.com/fcakyon/claude-codex-settings (1195 stars)
- Category: Writing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add fcakyon/claude-codex-settings --skill humanize -g -a claude-code -y`
Codex: `npx skills add fcakyon/claude-codex-settings --skill humanize -g -a codex -y`
Cursor: `npx skills add fcakyon/claude-codex-settings --skill humanize -g -a cursor -y`
Gemini CLI: `npx skills add fcakyon/claude-codex-settings --skill humanize -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add fcakyon/claude-codex-settings`

## Description

This skill should be used when writing or revising text, including responses, documentation, comments, emails, posts, reports, and messages, especially when the user asks to "humanize", "write naturally", "remove AI tone", or "avoid AI writing".

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

# Humanize

Write like a person with a reason to write. Choose words for meaning, not to sound polished. Match the user's vocabulary, tone, and level of formality. Keep useful detail and remove generic filler.

These patterns are warning signs, not proof of AI authorship. Fix the underlying weakness rather than hiding a tell with a synonym.

## Rewrite method

1. Identify the main claim, useful facts, and requested action.
2. Delete throat-clearing, repeated conclusions, and claims that add no information.
3. Replace vague importance and opinion claims with names, dates, actions, measurements, or sources.
4. Use the simplest sentence structure that preserves the meaning.
5. Match the format to the task. Do not turn a short answer into an article.

## Content problems

### Inflated importance and broad trends

Do not claim that ordinary facts mark a major shift, reflect a wider movement, or leave a lasting legacy unless the evidence makes that connection.

```text
Bad: The office opened in 1989, marking a pivotal moment in the evolution of regional administration.
Better: The office opened in 1989 to manage regional statistics.

Bad: The bridge stands as a testament to the town's enduring spirit and its place in the broader history of trade.
Better: The bridge opened in 1924 and carried the main road across the river until 1981.
```

### Shallow analysis attached to facts

Avoid adding an `-ing` phrase that only tells the reader that a fact matters. Explain the real consequence or stop after the fact.

```text
Bad: The station has six platforms, underscoring its crucial role in regional transport.
Better: The station has six platforms and handles 42 scheduled trains each day.

Bad: The archive added 3,000 photographs, highlighting its commitment to preserving local history.
Better: The archive added 3,000 photographs from the city newspaper's collection.
```

### Promotional or travel-guide language

The rest: https://github.com/fcakyon/claude-codex-settings/blob/HEAD/plugins/humanize/skills/humanize/SKILL.md