humanize

Detect and rewrite AI writing patterns in prose using a 41-pattern catalog and statistical scoring.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/kyle-bartlett/soundshuman --skill humanize-kyle-bartlett
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: humanize
Source: https://github.com/kyle-bartlett/soundshuman
Command: npx skills add https://github.com/kyle-bartlett/soundshuman --skill humanize-kyle-bartlett

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? AI-generated prose carries recognizable tells: inflated significance, promotional vocabulary, em dash overuse, chatbot artifacts, and metronomic rhythm. This Skill finds those patterns in drafts, files, or entire documentation folders and rewrites the text to sound natural without inventing facts. ## Core Features & Use Cases - 41-pattern detection catalog: Covers content, language, style, communication, filler, and rhetoric patterns derived from Wikipedia's Signs of AI writing guide, with false-positive guardrails so legitimate human prose is left alone. - Draft, audit, final rewrite loop: Produces a draft rewrite, audits it for remaining AI tells and fabricated facts, then delivers a final version with no em dashes and no invented claims. - Voice calibration: Analyzes a sample of your own writing and matches its sentence lengths, vocabulary, and quirks instead of producing generic clean output. - Repo auditing with sloplint: A zero-dependency Node CLI scores files 0-100, lists findings with line numbers, applies safe mechanical fixes, and gates CI with a fail-above threshold. - Use Case: Point it at a docs folder before a launch. It ranks files by how AI-flavored they are, you pick the worst offenders, and each rewrite lands as a reviewable git diff. ## Quick Start Ask the agent to humanize a pasted draft or a file, for example: humanize docs/launch-post.md and keep every fact from the original.

Frequently Asked Questions about humanize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make AI-generated text sound more human?

Invoke the skill with pasted text or a file path. It scans for 41 AI writing patterns, drafts a rewrite, audits the draft for remaining tells and fabricated facts, then delivers a final version. Providing a sample of your own writing lets it match your voice.

How do I audit a whole repo for AI writing patterns?

Run sloplint scan on a directory to rank every markdown or text file by a 0-100 AI-flavored score with the top patterns per file. Add --fail-above 50 to make CI fail when any file exceeds the threshold.

Does the humanize skill work outside Claude Code?

Yes. SKILL.md is plain markdown with YAML frontmatter, so any agent harness that reads markdown skills can load it. The sloplint CLI is zero-dependency Node 18+ and runs anywhere Node runs.

Can the rewrite accidentally invent facts?

The skill enforces a no-fabrication rule: every fact, name, number, date, and citation in the rewrite must come from the source text or the user. The audit step explicitly checks the draft for invented claims before delivery.

What are the limitations of automated AI writing detection?

Single tells like one em dash or perfect grammar are not reliable indicators, so the skill looks for clusters of patterns. Short samples under 120 words get a confidence haircut in scoring rather than a confident verdict.