humanly

Humanly — AI Writing Pattern Removal

Remove signs of AI-generated writing. Based on Wikipedia's "Signs of AI writing" and the avoid-ai-writing skill.

Core principle: If you wouldn't say it, don't write it. Write like a smart friend talking.

---

Mode Detection

Mode	When	What to load
pre-write	Before writing — user says "use humanly before writing" or a skill references this file	Detect language → read references/cheatsheet-{lang}.md only
review	Post-writing — user says "review", "rewrite", "clean up", "去 AI 味"	Full pipeline below
detect	User says "detect", "flag only", "audit only", "scan"	Same as review but flag-only, no rewriting

---

Pre-write Mode

When invoked before writing:

1. Detect target language from context
2. Read the corresponding cheatsheet (path relative to this SKILL.md):
   • 中文 → references/cheatsheet-zh.md
   • English → references/cheatsheet-en.md
3. Internalize the rules, then proceed with the writing task

Do NOT load the full patterns or word table — the cheatsheet is enough for pre-writing awareness.

---

Review / Detect Mode Pipeline

Step 1: Detect Language

Determine the primary language of the input text.

Step 2: Load References

Read these files (paths relative to this SKILL.md):

File	Purpose
references/patterns-{lang}.md	36 pattern categories with before/after examples
references/word-table-{lang}.md	3-tier word replacement table
references/context-profiles.md	Tolerance matrix by content type

Step 3: Detect Context Profile

Auto-detect from content cues (see context-profiles.md), or accept user hint:

• social / social-zh / blog / technical-blog / investor-email / docs / support-email / casual

Apply the tolerance matrix — some rules are relaxed or skipped per profile.

Step 4: First Pass — Scan by Severity

P0 — Credibility killers (fix immediately):

• Cutoff disclaimers ("As of my last update")
• Chatbot artifacts ("I hope this helps!", "Great question!")
• Vague attributions without sources ("Experts believe")
• Significance inflation on routine events

P1 — Obvious AI smell (fix before output):

• Tier 1 word violations
• Template phrases and slot-fill constructions
• "Let's" transition openers
• Synonym cycling within a paragraph
• Formulaic openings
• Bold overuse, em dash frequency

P2 — Stylistic polish (fix when possible):

• Generic conclusions
• Rule of three
• Uniform paragraph length
• Copula avoidance
• Transition phrases

Step 5: Cross-Language Checklist

Run through these checks regardless of language:

• Three consecutive sentences same length? Break one up
• Paragraph ends with a tidy one-liner? Vary the ending
• Em dash before a reveal? Remove it
• Explaining a metaphor? Trust the reader
• Conjunctive adverbs (Additionally, However)? Consider removing
• Rule of three? Use two items or four
• Symmetrical slogans ("Not X, but Y")? Just say Y
• Ends with a life lesson or quotable line? Delete or replace with a concrete fact
• More than 1 quoted term? Keep only the most essential one
• Announcement filler ("You won't believe...")? Just say the content

Step 6: Quality Scoring

Score on 5 dimensions (1-10 each, total 50):

Dimension	Criteria
Directness	States facts or announces them with buildup?
Rhythm	Sentence length varies?
Trust	Respects reader intelligence?
Authenticity	Sounds like a real person?
Conciseness	Anything left to cut?

Thresholds: 45-50 excellent, 35-44 good, below 35 needs another pass.

Step 7: Second Pass Audit

Re-read the rewritten version:

1. Identify any remaining AI tells that survived the first pass
2. Check for recycled transitions, lingering inflation, copula swaps
3. Fix and note what changed
4. If score was below 35, repeat from Step 4

Step 8: Output

Review mode — return 4 sections:

1. Issues found: every AI-ism identified, quoted, with severity (P0/P1/P2)
2. Rewritten version: clean version
3. What changed: brief summary of major edits
4. Second-pass audit: surviving tells fixed, or "clean"

Detect mode — return 2 sections:

1. Issues found: grouped by severity (P0/P1/P2)
2. Assessment: which flags are clear problems vs. judgment calls

---

Self-Reference Escape Hatch

When writing about AI patterns (blog posts, tutorials, documentation): quoted examples, code blocks, and text explicitly marked as illustrative are exempt from flagging. Only flag patterns in the author's own prose.

---

Reference

Based on Wikipedia:Signs of AI writing and avoid-ai-writing v3.3.0 (MIT License).

Sources: blader/humanizer, brandonwise/humanizer, hardikpandya/stop-slop, op7418/Humanizer-zh