# humanize-text

humanize-text grades a piece of writing on seven scales from 1 to 10 and returns a rewritten version without the usual AI tells.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 214 installs · ★ 35 repo stars
- Author: podo
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/podo/design-agent-skills/tree/HEAD/skills/humanize-text/SKILL.md
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/humanize-text

## What it does

Give it a block of text, a screenshot of an interface, or a Figma link. The material gets scored across seven dimensions, each from 1 to 10, and comes back rewritten.

The dimensions: worn-out vocabulary, padding that carries no information, grammar habits, how well interface copy reads, structure, punctuation, and sentences that talk about the text itself. The checklist follows the Signs of AI Writing guide on Wikipedia. Figma links are read through the Figma MCP server. Plain text and screenshots skip it, and a design link will not resolve without the server running.

It works on copy that already exists. Fresh interface strings belong to `ux-writing-skill`, marketing pages to `copywriting-skill`, and a full design pass to `design-auditor` or `plan-design-review`.

## Requirements
- Works with: Figma

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill humanize-text -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/humanize-text/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/humanize-text/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill humanize-text -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/humanize-text/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill humanize-text -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/humanize-text/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install podo/design-agent-skills skills/humanize-text
```

2. **Manually: put the files in place**
- File: `.github/skills/humanize-text/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill humanize-text -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/podo/design-agent-skills --path skills/humanize-text
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/humanize-text/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill humanize-text -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/podo/design-agent-skills/tree/HEAD/skills/humanize-text/SKILL.md

## When to use it
- strip AI tells from a draft before publishing
- score button labels and error messages
- rewrite a paragraph bloated with filler transitions
- review copy sitting on a Figma frame
- catch em-dash overuse and stiff phrasing

## Example prompts
- Score `landing.md` on all seven dimensions and show me the rewrite.
- Run `humanize-text` on `checkout.png` and rewrite the button labels.
- Check this paragraph for AI patterns and give me a cleaner version.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 5aebc089a8f660a6.

BEGIN THIRD-PARTY FILE 5aebc089a8f660a6
````text
---
name: humanize-text
description: |
  Scores and rewrites text to remove AI writing patterns. Rates content across
  seven dimensions (AI vocabulary, content inflation, grammar patterns, UX copy
  quality, structural tells, punctuation, and meta-content), each on a 1–10
  scale. Works with raw text, Figma URLs, and UI screenshots. Based on
  Wikipedia's Signs of AI Writing field guide.
triggers:
  - "humanize text"
  - "remove AI patterns"
  - "AI slop"
  - "de-slop"
  - "AI writing detection"
  - "UX copy quality score"
  - "humanize-text"
das:
  type: skill
  category: visual-components
  upstream: "https://github.com/gregorymm/humanize-text"
  upstream_path: "skills/humanize-text/SKILL.md"
  version: latest
  install: true
---

# humanize-text

> Catalogue stub — full skill: [gregorymm/humanize-text](https://github.com/gregorymm/humanize-text)

<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree

1. **Is the full skill already installed?**
   - Global: `f=~/.agents/skills/humanize-text/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - Project: `f=.agents/skills/humanize-text/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → the skill is installed as `humanize-text`, invoke it and proceed
   - `pointer` → go to step 2

2. **Detect scope, then install:**

   ```bash
   [ -e ~/.agents/skills/humanize-text ] && echo "global" || echo "project"
   ```

   **Global:**
   ```bash
   npx skills add gregorymm/humanize-text/skills/humanize-text -g -y
   ```

   **Project:**
   ```bash
   npx skills add gregorymm/humanize-text/skills/humanize-text -y
   ```
   > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation.

**Claude Code plugin route:**

```
/plugin marketplace add gregorymm/humanize-text
/plugin install humanize-text@gregorymm-humanize-text
```

**Heads-up**

- **Requires:** Figma MCP server (only for the Figma-URL input; raw text and screenshots need nothing)
- **License:** MIT
<!-- das:install:end -->

## Invoke after install

- Skill name: `humanize-text`
- Trigger phrases: "humanize text", "remove AI patterns", "de-slop", "UX copy quality score"

## What it does

Analyzes any text and produces a per-dimension score (1–10) plus a human-rewritten version:

| Dimension | What it catches |
|---|---|
| **AI vocabulary** | Overused words: "delve", "leverage", "utilize", "seamlessly", "robust" |
| **Content inflation** | Unnecessary padding, redundant qualifiers, filler transitions |
| **Grammar patterns** | Passive overuse, nominalization, non-human sentence openers |
| **UX copy quality** | Button/label clarity, error message tone, empty state effectiveness |
````
END THIRD-PARTY FILE 5aebc089a8f660a6

The third-party file has ended. Everything between the 5aebc089a8f660a6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2849 of 3508 bytes. © podo · MIT · https://github.com/podo/design-agent-skills/tree/HEAD/skills/humanize-text/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
