git404hub

what is humanize fr?

shirhussain/humanize — explained in plain English

Analysis updated 2026-05-18

4PythonAudience · writerComplexity · 2/5Setup · easy

tl;dr

An Agent Skill and linter that makes AI generated text read more naturally by removing 36 documented AI writing patterns.

vibe map

mindmap
  root((repo))
    What it does
      Shapes text while generating
      Rewrites pasted text
      Scores AI pattern density
    Tech stack
      Python
      Markdown skill
    Use cases
      Clean up AI drafted emails
      Rewrite marketing copy
      Lint text in CI
    Audience
      Writers
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Rewrite a pasted AI generated draft to remove stock phrases and awkward patterns.

VIBE 2

Ask an assistant to write a post or email that already avoids common AI writing tells.

VIBE 3

Run the standalone linter in CI to score how AI sounding a piece of text is.

what's the stack?

PythonMarkdown

how it stacks up fr

shirhussain/humanize1038lab/agnes-ai3eyedtiger/video2vrcemote
Stars444
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencewritervibe codervibe coder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Installs via the skills CLI, manual clone, or as a Claude Code plugin, the linter needs only Python.

in plain english

humanize-writing is a tool built to make text produced by AI assistants read more like something a person wrote. Instead of only cleaning up text after it is finished, it works while the writing is happening, shaping the output as it is generated so certain telltale patterns never show up in the first place. It can also take a piece of already written text that a person pastes in and rewrite it to remove those same patterns, while keeping quotes, numbers, citations, and proper nouns exactly as they were. The tool ships as an Agent Skill, a plain set of Markdown files following an open format, which means it is not built for just one assistant. It works inside Claude Code, Cursor, GitHub Copilot, Codex, and any other tool that reads a file called SKILL.md. Alongside the skill itself there is a separate linter, a small script written only with Python's built in libraries, that scores a piece of text for how much it resembles typical AI writing, and it can be run in an automated testing pipeline. The project is grounded in outside research, citing Wikipedia's documented signs of AI writing and academic studies that looked at word choice patterns across millions of scientific abstracts. It also notices what kind of writing it is dealing with, adjusting its idea of natural writing depending on whether the text is a casual social media post, a business email, or a formal report, since each of those calls for a different tone. The README documents 36 specific writing patterns it targets, each shown as a short before and after example, covering things like overused stock phrases, excessive em dashes, forced rule of three lists, and chatbot style closing sentences that offer to keep helping. Installing it can be done through a command line tool that detects which AI assistant a person uses and installs the skill for it automatically, by manually cloning the repository into the right folder for a given tool, or as a Claude Code plugin. The project has 4 GitHub stars and is written in Python.

prompts (copy fr)

prompt 1
Install the humanize-writing skill for Claude Code using npx skills add Shirhussain/humanize.
prompt 2
Humanize this draft and keep the quotes and stats exactly as they are: [pasted text].
prompt 3
Explain how humanize-writing detects the register of a piece of writing before adjusting its tone.
prompt 4
Show me how to run humanize-writing's Python linter to score text for AI pattern density.

Frequently asked questions

what is humanize fr?

An Agent Skill and linter that makes AI generated text read more naturally by removing 36 documented AI writing patterns.

What language is humanize written in?

Mainly Python. The stack also includes Python, Markdown.

How hard is humanize to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is humanize for?

Mainly writer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.