Humanize AI

Humanize AI content by detecting and auto-fixing AI generated content. Humanize AI text using Python scripts. Scans for AI vocabulary, puffery, chatbot artifacts, and auto-replaces filler phrases. Use when you want to analyze text in AI detector and bypass it in future, batch-process files, run automated cleanup, or get a report before manual humanizing.

Security Scan

The skill's code, instructions, and requirements are internally consistent with its stated purpose (auto-detecting and auto-replacing AI-style phrasing); it does not request credentials or perform network calls, but you should back up files before batch runs and note a couple of minor buggy implementations in the scripts.

Purpose & Capability

Name/description claim: detect and auto-fix AI wording. Provided artifacts (patterns.json, analyze.py, humanize.py) implement detection and auto-replacement locally. No unrelated credentials, binaries, or external services are requested.

Instruction Scope

SKILL.md instructs running local Python scripts and batch shell loops that may overwrite files in place (the example uses a temp file then mv back). That behavior is coherent with the purpose but can cause data loss if run without backups. The description mentions 'bypass' AI detectors which is a dual-use/ethical note but the code itself only does local textual replacements and reporting (no detector API calls or exfiltration).

Install Mechanism

Instruction-only skill with bundled Python scripts; no install spec, no external downloads, and no package installation. Low risk from installation mechanism.

Credentials

No environment variables, credentials, or config paths are requested. The scripts only read/write files provided by the user — access is proportional to the stated functionality.

Persistence & Privilege

always:false and agent-autonomy defaults are unchanged. The skill does not request persistent presence or modify other skill/system configs.

Assessment

This skill appears to do what it says: local detection and replacement of AI-style wording. Before installing or running it: 1) Test the scripts on small sample files and inspect changes (use -o to write to a separate file) rather than running in-place batch loops; 2) Backup important files before using the included batch examples that overwrite originals (the provided for-loop example uses mv to replace files); 3) Review and customize scripts/patterns.json to ensure the replacement rules match your intent (some replacements delete text and some patterns are broad); 4) Note minor implementation bugs (the curly-quotes handling and some quote-counting code appear incorrect/ineffective) — consider reviewing/fixing those functions if you rely on them; 5) Be aware the description explicitly mentions 'bypass' AI detectors: the tool provides text-level modifications that can change detector output (dual-use) — consider ethical and policy implications for your use case.

Humanize CLI

Command-line tools for detecting and auto-fixing AI writing patterns.

Scripts

analyze.py — Detect AI Patterns

Scans text and reports AI vocabulary, puffery, chatbot artifacts, and auto-replaceable phrases.

# Analyze a file
python scripts/analyze.py input.txt

# Analyze from stdin
echo "This serves as a testament to our commitment" | python scripts/analyze.py

# JSON output for programmatic use
python scripts/analyze.py input.txt --json

Output example:

==================================================
AI PATTERN ANALYSIS - 5 issues found
==================================================

AI VOCABULARY:
  • testament: 1x
  • crucial: 2x

AUTO-REPLACEABLE:
  • "serves as" → "is": 1x
  • "in order to" → "to": 1x

---

humanize.py — Auto-Replace Patterns

Performs automatic replacements for common AI-isms.

# Humanize and print to stdout
python scripts/humanize.py input.txt

# Write to output file
python scripts/humanize.py input.txt -o output.txt

# Include em dash replacement
python scripts/humanize.py input.txt --fix-dashes

# Quiet mode (no change log)
python scripts/humanize.py input.txt -q

What it fixes automatically:

• Filler phrases: "in order to" → "to", "due to the fact that" → "because"
• Copula avoidance: "serves as" → "is", "boasts" → "has"
• Sentence starters: removes "Additionally,", "Furthermore,", "Moreover,"
• Curly quotes → straight quotes
• Chatbot artifacts: removes "I hope this helps", "Let me know if", etc.

---

Workflow

1. Analyze first to see what needs fixing:

   python scripts/analyze.py document.txt
   

2. Auto-fix safe replacements:

   python scripts/humanize.py document.txt -o document_clean.txt
   

3. Manual review for AI vocabulary and puffery flagged by analyze (these require human judgment)

4. Re-analyze to confirm improvements:

   python scripts/analyze.py document_clean.txt
   

---

Customizing Patterns

Edit scripts/patterns.json to add/remove:

• ai_words — vocabulary that flags but doesn't auto-replace
• puffery — promotional language to flag
• replacements — phrase → replacement mappings (empty string = delete)
• chatbot_artifacts — phrases to auto-remove
• hedging_phrases — excessive hedging to flag

---

Batch Processing

Process multiple files:

# Analyze all markdown files
for f in *.md; do
  echo "=== $f ===" 
  python scripts/analyze.py "$f"
done

# Humanize all txt files in place
for f in *.txt; do
  python scripts/humanize.py "$f" -o "$f.tmp" && mv "$f.tmp" "$f"
done

---