unslop-file
Helps your agent make text files more human-like. It removes artificial phrases while keeping important code, links, and headings intact.
What it does
This program helps make texts that sound like they were written by an AI sound more natural and human-like. It removes generic phrases and improves writing flow, while keeping all code, links, file paths, and headings exactly as they are.
When to use it
- ✓When a notes file or document sounds too robotic.
- ✓To make a preferences or to-do file more personal.
- ✓When revising an AI-generated document that needs to sound more human.
Example of what to ask your AI
“Make this notes file sound more natural: my_file.md”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The program analyzes the text and removes common AI phrases and words. It can do this quickly using pre-set rules or more thoroughly by asking another AI (Claude) to rewrite the text, always keeping technical elements unchanged.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill unslop-fileOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/unslop-file/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Unslop Humanize
When to Use
Use this skill when you need humanize natural-language memory files (CLAUDE.md, todos, preferences, docs) by removing AI-isms and adding burstiness while preserving every code block, URL, path, command, and heading exactly. Two modes: --deterministic (fast, regex-based, no API) and LLM (default, calls Claude for...
Purpose
Rewrite natural-language memory files (CLAUDE.md, AGENTS.md, todos, preferences, docs) so they sound human-written: no sycophancy, no stock vocab, no five-paragraph essay shape, no tricolon padding. Everything technical stays exact: code blocks, inline code, URLs, file paths, commands, headings, tables.
Two modes:
--deterministic— fast regex pass that strips canonical AI-isms and tightens tricolons. No API call, noANTHROPIC_API_KEYneeded. Best for batch processing and CI.- LLM mode (default) — calls Claude (via Anthropic SDK or
claude --printCLI fallback) to do a full rewrite that engineers burstiness, restructures performative paragraphs, and matches voice. Slower but better quality.
Humanized version overwrites the original. A FILE.original.md backup is written first. Re-run after editing the .original.md to regenerate.
Intensity levels (--mode)
| Mode | What runs | Use when… |
|---|---|---|
subtle |
Stock vocab only. | Structure is fine; you just want AI vocabulary gone. |
balanced |
(Default.) Sycophancy, hedging, transitions, stock vocab, authority tropes, signposting, performative balance, em-dash cap. | Everyday docs / READMEs / CLAUDE.md. |
full |
Balanced + filler phrases + negative-parallelism tricolons + stronger LLM prompt. | Marketing copy, release notes, slop-heavy LLM output. |
Two-pass audit
Use the deterministic pass to get a report, then fix anything that slipped:
humanize --deterministic --report audit.json doc.md # writes audit + humanized
humanize doc.md # optional LLM polish on top
audit.json lists every rule that fired, every before → after pair, and counts_by_rule. Great for reviewing what the regex changed before trusting the diff to merge.
Trigger
/unslop-file <filepath>, /unslop:humanize <filepath>, or "humanize memory file", "de-slop this doc", "strip AI tone from this file".
Process
The scripts live in a scripts/ directory adjacent to this SKILL.md.
Common layouts:
- Full repo:
unslop/SKILL.md+unslop/scripts/ - Synced mirror:
skills/unslop-file/SKILL.md+skills/unslop-file/scripts/ - Codex bundle:
plugins/unslop/skills/unslop-file/SKILL.md+ siblingscripts/
Always prefer the scripts/ sibling of the currently loaded SKILL file.
Steps:
- Locate the directory containing this SKILL.md and its
scripts/sibling. - Run from that directory:
python3 -m scripts <absolute_filepath>(LLM mode), or add--deterministicfor the regex pass. - CLI flow: detect file type → write
.original.mdbackup → humanize → validate (preserve check + AI-ism residual check) → on validation error: targeted fix call (LLM mode) → retry up to 2 times. - On final failure: report errors, restore original, exit 2.
- On success: report path of humanized file and
.original.mdbackup, exit 0. - Return result to user.
Humanization Rules
Remove (canonical AI-isms)
- Sycophancy openers: "Great question!", "Certainly!", "Absolutely!", "Sure!", "I'd be happy to help", "What a fascinating..."
- Stock vocab:
delve,tapestry,testament(praise form),navigate/embark/journey(figurative),realm,landscape(figurative),pivotal,paramount,seamless,holistic,leverage(filler verb),robust(filler),comprehensive(when "complete" works),cutting-edge,state-of-the-art(filler),interplay,intricate,vibrant,underscore(s)/d/ing(figurative),crucial,vital(role/importance/part),ever-evolving,ever-changing,in today's (digital) world/age,dynamic landscape.
…
FAQ
What are 'AI-isms'?
These are phrases and words that artificial intelligences often use, making the text sound artificial, like 'it's important to note that' or 'delve into'.
What is 'burstiness'?
It's the variation in sentence length and structure, common in human writing, which AI texts sometimes lack.
Does the program change code or links?
No, it's designed to preserve all code, links, file paths, and headings exactly, only modifying the surrounding text.
Details
Original description by the author
Humanize natural-language memory files (CLAUDE.md, todos, preferences, docs) by removing AI-isms and adding burstiness while preserving every code block, URL, path, command, and heading exactly.
Popularity
- GitHub stars
- 48k
- Ranking position
- #4449
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
intent-driven-development
Helps your agent turn ideas into clear, testable plans. Defines criteria to ensure changes are made correctly and safely.
affaan-m/ECC
product-capability
Guides your agent in turning product ideas into clear plans. It defines what needs to be done, the limits, and decisions before development.
affaan-m/ECC
article-writing
Writes long-form content like articles, guides, and blog posts with a unique style. It's useful when you need well-written texts with a consistent voice and credibility.
affaan-m/ECC