Agent skill

Unslop File

by MohamedAbdallah-14 in MohamedAbdallah-14/unslop

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.

MITAuto-check: warningsWriting & Content

Install Unslop File

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add MohamedAbdallah-14/unslop --skill unslop-file -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MohamedAbdallah-14/unslop unslop-file --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MohamedAbdallah-14/unslop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/unslop .claude/skills/unslop-file && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
unslop-file
GitHub stars
155
Used in
1 other repo
Token cost
~2.7k tokens
SKILL.md length
1,017 words
Files
25 (incl. scripts)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 6 steps: Locate the directory containing this… → Run from that directory: python3 -m… → CLI flow: detect file type → write… → …
  • Tasks that involve Humanizing AI text
  • SKILL.md covers Purpose, Trigger, Process and Humanization Rules, plus 2 more sections
  • Runs Python scripts from its folder; calls claude, python3 and npm; needs ANTHROPIC_API_KEY

What it does

Unslop File is an agent skill from MohamedAbdallah-14/unslop. 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 rewrite). Humanized version overwrites the original file. Plain backup saved as FILE.original.md. Trigger: /unslop-file <filepath or "humanize memory file"

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 26 other files, including scripts (for example `CHANGELOG.md`, `README.md` and `SECURITY.md`).

It sits in Writing & Content, covering Humanizing AI text and Agent instruction files. The repository describes itself as: Make AI output sound human. Strips AI-isms (sycophancy, stock vocab, hedging stacks, em-dash pileups), preserves code/URLs/headings. Plugin for Claude Code, Cursor, Windsurf… The licence is MIT.

When your agent uses it

  • Tasks that involve Humanizing AI text
  • Tasks that involve Agent instruction files

Example prompts

  • “humanize memory file”
  • “/unslop-file”

Requirements

  • Python 3
  • Node.js
  • Docker
  • A credential in ANTHROPIC_API_KEY

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Locate the directory containing this SKILL.md and its scripts/ sibling.
  2. Run from that directory: python3 -m scripts (LLM mode), or add --deterministic for the regex pass.
  3. CLI flow: detect file type → write .original.md backup → humanize → validate (preserve check + AI-ism residual check) → on validation…
  4. On final failure: report errors, restore original, exit 2.
  5. On success: report path of humanized file and .original.md backup, exit 0.
  6. Return result to user.

What it can do on your machine

Read from SKILL.md and the folder at commit 29d4360. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 14 files in scripts/ (Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • claude
    • python3
    • npm
    • git
    • docker

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, git and docker, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ANTHROPIC_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Unslop File loads about 2.7k tokens when it runs. Until then it costs about 113 tokens; SKILL.md has 1,017 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • NoteMentions a .env fileSKILL.md:140
    ts`, `.json`, `.yaml`, `.yml`, `.toml`, `.env`, `.lock`, `.css`, `.html`, `.xml`, `.sql`, `.sh`.
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:144
    ng matching `.env*`, `*.pem`, `*.key`, `~/.ssh/`, `~/.aws/`, etc.) are refused before any read or API call.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from MohamedAbdallah-14/unslop at commit 29d4360, republished under its MIT licence (© MohamedAbdallah-14). 1,017 words, ~2,734 tokens.

Download SKILL.mdSave it as .claude/skills/unslop-file/SKILL.md (or your agent's skills folder). This skill also uses 24 other files; get the full folder from GitHub.
name
unslop-file
description
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 rewrite). Humanized version overwrites the original file. Plain backup saved as FILE.original.md. Trigger: /unslop-file <filepath> or "humanize memory file"

Unslop Humanize

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, no ANTHROPIC_API_KEY needed. Best for batch processing and CI.
  • LLM mode (default) — calls Claude (via Anthropic SDK or claude --print CLI 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)
ModeWhat runsUse when…
subtleStock 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.
fullBalanced + 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:

bash
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 + sibling scripts/

Always prefer the scripts/ sibling of the currently loaded SKILL file.

Steps:

  1. Locate the directory containing this SKILL.md and its scripts/ sibling.
  2. Run from that directory: python3 -m scripts <absolute_filepath> (LLM mode), or add --deterministic for the regex pass.
  3. CLI flow: detect file type → write .original.md backup → humanize → validate (preserve check + AI-ism residual check) → on validation error: targeted fix call (LLM mode) → retry up to 2 times.
  4. On final failure: report errors, restore original, exit 2.
  5. On success: report path of humanized file and .original.md backup, exit 0.
  6. 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.
  • Hedging openers: "It's important to note that", "It's worth mentioning", "Generally speaking", "In essence", "At its core", "It should be noted that", "It's also worth pointing out".
  • Authority tropes (sentence start): "At its core,", "In reality,", "Fundamentally,", "What really matters is", "The heart of the matter is", "At the heart of X is/lies".
  • Signposting announcements: "Let's dive in(to ...)", "Let's break this down", "Here's what you need to know", "Without further ado", "In this article, I'll ...", "Buckle up".
  • Transition tics (sentence start): "Furthermore,", "Moreover,", "Additionally,", "In conclusion,", "To summarize,".
  • Performative balance: "however" / "on the other hand" appended to every claim.
  • Em-dash pileups (more than two em-dashes per paragraph).
  • Filler phrases (--mode full only): "in order to" → "to", "due to the fact that" → "because", "prior to" → "before", "with regard to" → "about", "a wide variety of" → "many", "at this point in time" → "now", "the fact that" → "that", etc.
  • Negative-parallelism tricolons (--mode full only): "No guesswork, no bloat, no surprises." — the rhetorical triple-no punch.
Tighten
  • Tricolons: "X, Y, and Z" stacks where two would suffice — keep two, drop the weakest
  • Bullet soup: three bullets that say the same thing → merge into one sentence
  • Five-paragraph essay shapes: vary paragraph length; don't write four paragraphs of identical length
Show full SKILL.md (397 more words)Show less
Preserve EXACTLY (never modify)
  • Fenced code blocks (...) — every byte
  • Indented code blocks (4-space)
  • Inline code (...)
  • URLs and markdown links
  • File paths (./src/, /etc/, C:\Users\...)
  • Commands (npm install, git rebase, docker run)
  • Technical terms, proper nouns, API names
  • Dates, version numbers, numerics
  • Environment variables ($HOME, ${NODE_ENV})
Preserve structure
  • All markdown headings (text exact)
  • Bullet hierarchy and nesting
  • Numbered lists
  • Tables (compress cells; keep structure)
  • YAML frontmatter
CRITICAL RULE

Everything inside ``` ... ``` is read-only. No comment changes, no whitespace changes, no line reordering. Inline backticks: same. Code is the substrate; humanization only operates on prose between code regions.

Pattern (before → after)

#BeforeAfter (deterministic, --mode balanced)
1It's important to note that running tests prior to pushing changes is a comprehensive best practice. Additionally, it's worth mentioning that this can prevent broken builds.Running tests before pushing changes is a broad best practice. This can prevent broken builds.
2The application leverages a microservices architecture that comprises multiple discrete components.The application uses a microservices architecture that comprises multiple discrete components.
3At its core, caching trades memory for latency.Caching trades memory for latency.
4Let's dive in. Here is the first step.Here is the first step.
5The intricate interplay between caching and latency is crucial.The detailed link between caching and latency is important.
6In today's digital world, we ship fast.Today, we ship fast.
At --mode full, additionally:
#BeforeAfter
7We ran the tests in order to verify the fix.We ran the tests to verify the fix.
8The build failed due to the fact that the disk was full.The build failed because the disk was full.
9No guesswork, no bloat, no surprises.(stripped)
Reference
  • blader/unslop — Claude-Code skill listing 30+ AI tells; we incorporated the strongest signals.
  • Wikipedia: Signs of AI writing — public taxonomy cross-referenced for vocab.
  • Full comparison + gap analysis: docs/research/IMPLEMENTATION_TRACE.md.

Boundaries

  • Only operate on .md, .txt, .markdown, .rst, or extensionless natural language.
  • Never modify .py, .js, .ts, .json, .yaml, .yml, .toml, .env, .lock, .css, .html, .xml, .sql, .sh.
  • Mixed prose-and-code files: humanize only the prose; leave fenced code untouched.
  • If unsure whether a file is prose or code: leave unchanged.
  • Backup FILE.original.md is written before overwrite. Never humanize a file already named *.original.md.
  • Sensitive paths (anything matching .env*, *.pem, *.key, ~/.ssh/, ~/.aws/, etc.) are refused before any read or API call.
  • Files larger than 500 KB are refused.

© MohamedAbdallah-14, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 24 other files (scripts) in unslop of MohamedAbdallah-14/unslop.

  • SKILL.md
  • CHANGELOG.md
  • README.md
  • SECURITY.md
  • pyproject.toml
  • scripts/__init__.py
  • scripts/__main__.py
  • scripts/benchmark.py
  • scripts/cli.py
  • scripts/data/__init__.py
  • scripts/data/stylometric_baseline.json
  • scripts/detect.py
  • scripts/detector.py
  • scripts/fetch_detectors.py
  • scripts/humanize.py
  • scripts/lexical_targets.py
  • scripts/py.typed
  • scripts/reasoning.py
  • scripts/shield_metrics.py
  • … and 6 more

Open the folder on GitHubat commit 29d4360

Used in 1 other repository

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in MohamedAbdallah-14/unslop, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Unslop File next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Unslop File compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Unslop File this skillMohamedAbdallah-14/unslop1551 repos~2.7kAutomated safety check: WarnMIT
Unslop Filesickn33/agentic-awesome-skills47k1 repos~2.9kAutomated safety check: WarnMIT
Talk Normalhexiecs/talk-normal1.9k—~931Automated safety check: PassMIT
Johnny Suede WriteJasonColapietro/suede-creator-skills127—~7.9kAutomated safety check: PassMIT
evlog Content Writingevloghq/evlog1.9k—~2.9kAutomated safety check: PassMIT
Shipmillionco/react-doctor15k—~716Automated safety check: PassCustom licence

Similar skills

  • Unslop File

    sickn33/agentic-awesome-skills

    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.

    47k GitHub starsUsed in 1 repo~2.9k tokens
    Agent WorkflowsAuto-check: warnings
  • Talk Normal

    hexiecs/talk-normal

    Installs a set of rules into AGENTS.md that strips filler, hedging and padded closings from your agent's replies, in English and Chinese.

    1.9k GitHub stars~931 tokensUpdated 5 mo ago
    Agent WorkflowsAuto-check passed
  • Johnny Suede Write

    JasonColapietro/suede-creator-skills

    Suede Labs full writing stack: sharper copy for docs, pages, email, social, headlines, CTAs, product listings, and public explainers, with an SEO/AEO/AI EO pass, persona and framework selection…

    127 GitHub stars~7.9k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Rules for writing and reviewing evlog docs, blog posts, READMEs, skills and AGENTS.md files, with separate review and rewrite roles, a house voice and a catalog of AI-sounding tells.

    1.9k GitHub stars~2.9k tokensUpdated today
    Writing & ContentAuto-check passed
  • Ship

    millionco/react-doctor

    Take the current branch from done-coding to merge-ready in one pass — review the diff against AGENTS.md, deslop, commit and push, open a PR using rule-validate's PR copy, then babysit until mergeable.

    15k GitHub stars~716 tokensUpdated today
    DevelopmentAuto-check passed
  • Translate Docs

    MoonshotAI/kimi-code

    Translate and sync bilingual user documentation between docs/zh/ and docs/en/ following the source-of-truth rules in docs/AGENTS.md.

    7.8k GitHub stars~976 tokensUpdated yesterday
    Writing & ContentAuto-check passed

More from MohamedAbdallah-14/unslop

  • Unslop Review

    MohamedAbdallah-14/unslop

    Rewrites code review comments so they read like a human teammate wrote them.

    155 GitHub starsUsed in 3 repos~980 tokens
    Auto-check passed
  • Unslop Commit

    MohamedAbdallah-14/unslop

    Rewrites commit messages so they sound like a careful human engineer wrote them.

    155 GitHub starsUsed in 1 repo~927 tokens
    Auto-check passed
  • Unslop Help

    MohamedAbdallah-14/unslop

    Quick-reference card for unslop modes, sub-skills, and slash commands.

    155 GitHub starsUsed in 1 repo~623 tokens
    Auto-check passed
  • Unslop Reasoning

    MohamedAbdallah-14/unslop

    Strip AI-slop patterns from reasoning traces (chain-of-thought, extended thinking, agent decomposition) — not final prose.

    155 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Unslop

    MohamedAbdallah-14/unslop

    Humanize LLM output so it reads like a careful human wrote it.

    155 GitHub starsUsed in 1 repo~4.1k tokens
    Auto-check: warnings

Questions about Unslop File

What does Unslop File do?

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. Unslop File is an agent skill from MohamedAbdallah-14/unslop.md, todos, preferences, docs) by removing AI-isms and adding burstiness while preserving every code block, URL, path, command, and heading exactly.

When should I use Unslop File?

Unslop File fits situations like: tasks that involve Humanizing AI text; tasks that involve Agent instruction files.

How do I install Unslop File in Claude Code?

Run `npx skills add MohamedAbdallah-14/unslop --skill unslop-file -a claude-code`. Or copy the skill folder (unslop in MohamedAbdallah-14/unslop) into .claude/skills/unslop-file in your project. Claude Code loads it when a task matches its description.

How do I install Unslop File in Codex?

Run `npx skills add MohamedAbdallah-14/unslop --skill unslop-file -a codex`. Or copy the skill folder (unslop in MohamedAbdallah-14/unslop) into .agents/skills/unslop-file in your project. Codex loads it when a task matches its description.

Can I use Unslop File in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MohamedAbdallah-14/unslop --skill unslop-file -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/unslop-file, .gemini/skills/unslop-file, .github/skills/unslop-file and .opencode/skills/unslop-file in your project.

What does Unslop File need to run?

Going by SKILL.md and its folder, Unslop File needs Python for the scripts in its folder, the command-line tools its instructions call (claude, python3, npm, git and docker) and credentials named ANTHROPIC_API_KEY. Our summary lists: Python 3; Node.js; Docker; A credential in ANTHROPIC_API_KEY.

Does Unslop File access the network?

SKILL.md contains no URLs. Its commands use npm, git and docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Unslop File safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): mentions a credentials file (ssh keys, cloud or package-manager tokens). Read the flagged lines before installing; the check is not a guarantee either way. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Unslop File use?

Unslop File is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Unslop File use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Unslop File?

Skills that share tags, products or a category with Unslop File: Unslop File (sickn33/agentic-awesome-skills, 47k stars), Talk Normal (hexiecs/talk-normal, 1.9k stars), Johnny Suede Write (JasonColapietro/suede-creator-skills, 127 stars) and evlog Content Writing (evloghq/evlog, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unslop File?

MohamedAbdallah-14 (a GitHub user) maintains it in MohamedAbdallah-14/unslop, which has 155 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 5, 2026.

Source: MohamedAbdallah-14/unslop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.