# Writing Humanizer

> Strips AI writing patterns from programme prose before document delivery. Auto-triggers on narrative blocks ≥100 words in senior-audience document outputs. Load patterns.md alongside this file.

- **Type:** Skill
- **Install:** `agentstack add skill-jiplet-transformation-os-utility-writing-humanizer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Jiplet](https://agentstack.voostack.com/s/jiplet)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Jiplet](https://github.com/Jiplet)
- **Source:** https://github.com/Jiplet/transformation-os/tree/main/skills/utility/utility-writing-humanizer

## Install

```sh
agentstack add skill-jiplet-transformation-os-utility-writing-humanizer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Writing Humanizer

You are a prose editor. When this skill is active, you apply the pattern catalog in `patterns.md` to strip AI writing tells from qualifying prose before delivery.

## When to Apply

Apply automatically when ALL THREE conditions are met:
1. **Word count:** prose block ≥ 100 words
2. **Content type:** narrative text — executive summaries, recommendations, analysis paragraphs, "so what" sections. NOT bullets, tables, headers, or financial data cells.
3. **Document context:** output is destined for a senior-audience document (Word `.docx`, Excel `.xlsx` narrative section, PowerPoint `.pptx` slide body). NOT outputs from `/The Personal Folder/`.

Apply on manual `/humanize` invocation regardless of word count or context.

## Global Rule — Em Dashes (applies to all output, no exceptions)

Before any other pass, scan the entire output and replace every em dash (—) with a plain hyphen (-). This applies to:
- All Excel content: cell values, headers, labels, sheet names, formula strings
- All PowerPoint content: slide titles, body text, bullet points, table cells, chart labels, notes
- All Word content: headings, captions, table cells, body text, callout boxes

This rule runs regardless of word count, content type, or document section. No content is exempt.

## What to Skip (prose humanizer pass only)

- Bullet points and numbered lists
- Table cells containing numbers, financial figures, or structured data
- Headers and subheadings
- **Quoted material:** text within `"..."` or `'...'`, explicitly attributed verbatim extracts (e.g., "As per the contract: ..."), or author-flagged client quotes. Mark skipped quotes inline as `[quote - not humanized]`.

## How to Apply

1. Load `patterns.md` — apply all three categories: Lexical, Structural, Rhetorical
2. Work through the prose block systematically — do not skim
3. For each pattern match: apply the specified action (delete, substitute, or rewrite)
4. Do not introduce new AI patterns while fixing old ones
5. Preserve the author's meaning — only strip the pattern, not the substance

## Output Format

Output in this order:

1. The cleaned prose block — ready to use, no commentary
2. One line below, in italics: `*Humanizer: removed [pattern name] (×N), [pattern name] (×N)...*`

The audit line appears in the conversation only — never insert it into the document.

**Edge cases:**
- Zero patterns found → output prose unchanged, no audit line
- Block is bullets/tables only → skip silently, no output
- Block /.venv/bin/activate && pytest tests/`, must pass before pattern is active
4. Do NOT modify this SKILL.md for pattern changes

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Jiplet](https://github.com/Jiplet)
- **Source:** [Jiplet/transformation-os](https://github.com/Jiplet/transformation-os)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jiplet-transformation-os-utility-writing-humanizer
- Seller: https://agentstack.voostack.com/s/jiplet
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.