skills/43-wentorai-research-plugins/skills/writing/polish/ai-writing-humanizer/SKILL.md
Remove AI-generated patterns to produce natural, authentic academic writing
npx skillsauth add brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research ai-writing-humanizerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A skill for identifying and removing characteristic patterns of AI-generated text to produce natural, authentic academic writing. Designed for researchers who use AI tools for drafting and want to ensure the final output reads as genuine scholarly prose.
AI-generated text frequently overuses certain words and phrases:
def identify_ai_patterns(text: str) -> dict:
"""
Scan text for common AI-generated writing patterns.
Returns a report of detected patterns with suggested replacements.
"""
overused_phrases = {
# Hedging/filler phrases AI overuses
'it is important to note that': 'Note that',
'it is worth mentioning that': '[delete or rephrase]',
'it should be noted that': '[delete or rephrase]',
'in the realm of': 'in',
'in the context of': 'in / for / regarding',
'a testament to': '[rephrase with specific evidence]',
'the landscape of': '[delete -- be specific]',
'a nuanced understanding': '[delete or specify what nuance]',
'shed light on': 'clarified / revealed / explained',
'delve into': 'examined / analyzed / investigated',
'furthermore': '[vary: also, additionally, moreover, or restructure]',
'moreover': '[vary: in addition, also, or restructure]',
'utilizing': 'using',
'leverage': 'use / apply / employ',
'facilitate': 'enable / support / help',
'a myriad of': 'many / numerous / various',
'plays a crucial role': 'is important for / contributes to',
'in conclusion': '[often unnecessary -- just conclude]',
'overall': '[often unnecessary filler]',
'comprehensive': '[usually vague -- be specific about scope]',
'robust': '[overused -- specify what makes it strong]',
'multifaceted': '[specify the actual facets]',
'notably': '[usually filler -- delete or restructure]'
}
results = {'detected': [], 'total_flags': 0}
text_lower = text.lower()
for phrase, suggestion in overused_phrases.items():
count = text_lower.count(phrase.lower())
if count > 0:
results['detected'].append({
'phrase': phrase,
'count': count,
'suggestion': suggestion
})
results['total_flags'] += count
return results
AI text tends to exhibit predictable structural patterns:
AI Pattern: Formulaic paragraph structure
- Topic sentence (broad claim)
- Supporting point 1
- Supporting point 2
- Concluding/transition sentence
Every paragraph follows this exact template.
Human Fix: Vary paragraph structure
- Sometimes lead with evidence, then interpret
- Sometimes pose a question, then answer it
- Sometimes use a single punchy sentence as a paragraph
- Let paragraph length vary naturally (2-8 sentences)
AI Pattern: Excessive parallel construction
"The study examined X, analyzed Y, and evaluated Z."
"This approach enhances accuracy, improves efficiency, and reduces cost."
Human Fix: Break parallelism occasionally
"The study examined X. For Y, a different analytical lens was required,
so we turned to Z for comparison."
def humanize_sentence_variety(sentences: list[str]) -> dict:
"""
Analyze sentence variety -- AI text often has uniform sentence lengths
and structures.
"""
lengths = [len(s.split()) for s in sentences]
avg_length = sum(lengths) / len(lengths)
std_length = (sum((l - avg_length)**2 for l in lengths) / len(lengths)) ** 0.5
# Check first word variety
first_words = [s.split()[0].lower() if s.split() else '' for s in sentences]
unique_first_words = len(set(first_words)) / len(first_words)
issues = []
if std_length < 3:
issues.append(
f"Sentence lengths are too uniform (avg={avg_length:.0f}, "
f"std={std_length:.1f}). Mix short (5-10 words) and long "
f"(20-30 words) sentences."
)
if unique_first_words < 0.5:
repeated = [w for w in set(first_words) if first_words.count(w) > 2]
issues.append(
f"Too many sentences start with the same word: {repeated}. "
f"Vary sentence openings."
)
# Check for consecutive similar-length sentences
uniform_runs = 0
for i in range(1, len(lengths)):
if abs(lengths[i] - lengths[i-1]) < 3:
uniform_runs += 1
if uniform_runs > len(lengths) * 0.6:
issues.append("Too many consecutive sentences with similar lengths.")
return {
'avg_sentence_length': round(avg_length, 1),
'length_std': round(std_length, 1),
'first_word_variety': round(unique_first_words, 2),
'issues': issues,
'assessment': 'natural' if not issues else 'needs_revision'
}
AI text often defaults to an impersonal, overly balanced voice. Academic writing benefits from:
Step 1: Draft with AI assistance (outline, first draft)
Step 2: Print the draft and read aloud -- mark anything that sounds generic
Step 3: Replace flagged phrases with your natural voice
Step 4: Add personal scholarly judgment (interpretations, critiques)
Step 5: Insert discipline-specific terminology and citations
Step 6: Vary sentence structure and paragraph length
Step 7: Run the pattern detector to catch remaining AI fingerprints
Step 8: Final read-aloud check
Using AI for writing assistance is increasingly accepted in academia, but transparency is essential. Many journals now require disclosure of AI tool usage. The key ethical principle: you must deeply understand and stand behind every claim in the final text. AI is a drafting tool; scholarly judgment and intellectual ownership remain yours.
tools
Recommend AND run open-source AI tools, agents, Claude Code / Codex skills, and MCP servers for any stage of a literature review — searching, reading, extracting, synthesizing, screening, citation-checking, and paper writing. Use when the user asks "what tool should I use to..." OR "install/run/use <tool> to ..." for research/lit-review work: automating a survey or related-work section, PDF→Markdown extraction for LLMs (MinerU/marker/docling), PRISMA / systematic review (ASReview), citation-backed Q&A over PDFs (PaperQA2), wiring papers into Claude/Cursor via MCP (arxiv/paper-search/zotero servers), or chatting with a Zotero library. Ships a launcher (scripts/litrun.py) that installs each tool in an isolated venv and runs it. Curated catalog of 70+ vetted projects. 支持中英文(用于「文献综述工具选型」与「一键安装/运行」)。
development
Route empirical-research requests through the Auto-Empirical Research Skills catalog when this whole repository is installed as one skill in Codex, CodeBuddy, Claude Code, or another IDE. Use to choose and load the right vendored AERS skill for causal inference, econometrics, replication, data acquisition, manuscript writing, peer review and referee responses, citation checking, de-AIGC editing, or full empirical-paper workflows without reading the entire repository at once.
documentation
Use when the project collects primary data or runs a field, lab, or survey experiment, before the intervention begins — write the pre-analysis plan, size the sample from a power calculation, and register with the AEA RCT Registry. Apply after the design is chosen in aer-identification and before any outcome data are seen.
tools
Guide economists to authoritative data sources with explicit, confirmed data specifications before retrieval; interfaces with Playwright MCP to navigate portals and extract real data, not articles about data.