# talk-human
> Make what AI writes for you read like **you** actually talk — not like "an AI," not like "a generic person."
[English](README.md) · [中文](README.zh.md)
A cross-agent skill. Not a detector-evasion toy — a systematic, auditable, multi-pass method: first scrape off AI's statistical tics, then make sentences readable, then (the hard part) make it sound like **you**.
The most valuable step is delegated to the AI: feed it a sample of how you actually talk (e.g. a voice transcript), and it generates a **"voice layer"** for you — then rewrites drafts against it. You supply the sample; the AI extracts your voice.
## Install as a plugin
- **Claude Code** (2.1.275 or later): `/plugin install talk-human --marketplace runesleo/x-reader`
- **Codex**: `codex plugin marketplace add runesleo/x-reader`, then `codex plugin add talk-human@runesleo`
The `runesleo` marketplace also lists Leo's other tools; see [runesleo/x-reader](https://github.com/runesleo/x-reader).
## Two modes
- **build-my-voice** — generate a personal "voice layer" checklist (negative red-lines + positive hard-rules) from your speaking samples.
- **deslop** — strip the AI-ness from a draft in three passes: remove statistical fingerprints → improve readability → align to your voice.
## Install
### Claude Code / Claude agents (native skill)
Copy the `skills/talk-human/` folder into your skills directory:
```bash
# global
~/.claude/skills/talk-human/
# or project-level
<your-project>/.claude/skills/talk-human/
```
Then just say: `build my voice layer` / `deslop this` / `make this sound like me`.
### Cursor / Codex / Gemini CLI / ChatGPT / any LLM
No native skill support needed — the files under `skills/talk-human/references/` are **self-contained instructions**. Paste them into your AI:
- To build a voice layer → paste `skills/talk-human/references/build-voice.md`
- To deslop a draft → paste `skills/talk-human/references/deslop-pass.md` (include your voice layer if you have one)
## Usage
```
You: deslop this — [paste your AI draft]
AI: Pass 1 (fingerprints): removed "it's worth noting", "in today's world"…
Pass 2 (readability): split 3 long sentences, restored subjects…
Pass 3 (voice): [uses your voice-layer.md if present, else generic rules]
→ [rewritten draft] + 3-line change summary
```
## The one rule
**Never invent facts for you.** Delete, rewrite, reorder only — no new claims, numbers, or conclusions. The heavier the AI-ness, the less survives — because its "smoothness" is often just emptiness. This tool helps you see where it's hollow; the real substance you write yourself.
## Data and network access
talk-human is instructions only: Markdown files your agent reads. It ships no scripts and no MCP server, has no telemetry, and sends nothing to the author.
| What | Where it goes |
|---|---|
| Your speaking samples, drafts, and voice layer | Only to the AI model your agent already uses, as part of your normal conversation with it. The skill makes no network calls of its own |
| Installing the plugin | Your agent client downloads this repository from GitHub at a pinned commit. Nothing else is downloaded or installed |
Stored on your machine: nothing by default. In build-my-voice mode the agent asks you to save the result as `voice-layer.md`, wherever you choose. The skill does not read credentials, environment variables, or other apps' data.
## About the author
*Leo ([@runes_leo](https://x.com/runes_leo)) — AI × Crypto independent builder. Trading on [Polymarket](https://polymarket.com/?via=runes-leo&r=runesleo&utm_source=github&utm_content=talk-human), building data and content pipelines with Claude Code and Codex.*
*[leolabs.me](https://leolabs.me) — writing · community · open-source tools · indie projects · all platforms.*
*[X Subscription](https://x.com/runes_leo/creator-subscriptions/subscribe) — paid content weekly, or just buy me a coffee 😁*
*Learn in public, Build in public.*
## More from this workshop
Full map: **[runesleo](https://github.com/runesleo/runesleo)** — all open-source projects and working systems.
- [x-reader](https://github.com/runesleo/x-reader) — universal content reader MCP, 10+ platforms
- [claude-code-workflow](https://github.com/runesleo/claude-code-workflow) — QuietHarness — shared AI working system for Claude Code / Codex / Cursor
- [ai-health-vault](https://github.com/runesleo/ai-health-vault) — AI + Obsidian health management system
- [polymarket-toolkit](https://github.com/runesleo/polymarket-toolkit) — Polymarket research CLI + AI skills
## License
MIT © Leo ([@runes_leo](https://x.com/runes_leo))