Humanize Academic Writing

🇬🇧 English | 🇨🇳 中文

An AI skill for Cursor and Claude Code that transforms AI-generated academic text into natural, human-like scholarly writing—specifically designed for social science researchers and non-native English speakers.

⚡ Quick Start

Install as Cursor Skill:

# Clone the repository
git clone https://github.com/momo2young/humanize-academic-writing.git

# Copy to Cursor skills directory (Windows)
xcopy humanize-academic-writing %USERPROFILE%\.cursor\skills\ /E /I

# Or for macOS/Linux
cp -r humanize-academic-writing ~/.cursor/skills/

Install as Claude Code Skill:

# Copy to Claude Code skills directory (Windows)
xcopy humanize-academic-writing %USERPROFILE%\.claude\skills\ /E /I

# Or for macOS/Linux
cp -r humanize-academic-writing ~/.claude/skills/

Use the scripts directly:

# Detect AI patterns
python scripts/ai_detector.py your_draft.txt --detailed

# Analyze text quality
python scripts/text_analyzer.py your_draft.txt

In Cursor IDE or Claude Code:

Restart after installation
Select your AI-generated text
Ask: "Can you help humanize this academic writing?"
Or invoke directly: /humanize-academic-writing

🎯 What This Does

✅ Transforms AI Writing Patterns

Detects: Repetitive structures, mechanical transitions, abstract language
Rewrites: With authentic scholarly voice and natural flow
Explains: What makes text sound AI-generated vs. human-written

🎓 Target Audience

Social science researchers (sociology, anthropology, political science, education, psychology, communication study)
Non-native English speakers
Anyone using AI to draft papers based on their own research

⚖️ Academic Integrity

Purpose: Improve the naturalness of your own ideas expressed through AI writing tools.

✅ Appropriate: Revising AI drafts of your own research and arguments
❌ Inappropriate: Generating ideas you don't have or disguising plagiarism

Principle: The goal is authentic communication, not deception.

📖 Example Transformation

Before (AI-generated):

Social media has become an important aspect of modern communication. Moreover, it has various effects on society. Additionally, researchers have studied this phenomenon extensively...

After (Humanized):

Social media platforms have fundamentally reshaped how individuals communicate, mobilize, and access information. While scholars extensively document these transformations (boyd 2014; van Dijck 2013), debates persist about their democratic implications—particularly regarding echo chambers and polarization (Sunstein 2017).

What Changed:

❌ Removed mechanical transitions (Moreover, Additionally)
❌ Replaced abstractions ("various effects") with specific concepts
✅ Added concrete citations and scholarly voice
✅ Varied sentence rhythm

🌟 Key Features

AI Pattern Detection - Automatically identifies 6+ AI writing markers
Zero Dependencies - Uses only Python standard library
Completely Local - No data sent anywhere, full privacy
Discipline-Specific - Tailored guidance for 5 social science fields
Rich Documentation - 1370+ lines of principles, examples, and strategies
Open Source - MIT License, free to use and modify

📚 Documentation

English

QUICKSTART.md - 5-minute getting started guide
SKILL.md - Core skill file (works with both Cursor and Claude Code)
FAQ.md - Frequently asked questions
docs/rewriting-principles.md - 10 detailed rewriting strategies
docs/examples.md - 8+ complete before/after examples
docs/social-science-patterns.md - Discipline-specific conventions

中文

README_CN.md - 中文版项目文档
QUICKSTART_CN.md - 快速开始指南
FAQ_CN.md - 常见问题
docs/rewriting-principles_CN.md - 改写原则详解
docs/examples_CN.md - 完整改写示例
docs/social-science-patterns_CN.md - 学科特定指导

Additional Resources

PROJECT_STRUCTURE.md - Complete project layout
CONTRIBUTING.md - Contribution guidelines

🌍 For Non-Native English Speakers

This skill specifically addresses challenges non-native speakers face with AI-assisted writing:

Common AI Crutches We Fix

Over-reliance on formal transitions (Moreover, Furthermore)
Abstract placeholder phrases ("in terms of," "various aspects")
Mechanical sentence patterns (all Subject-Verb-Object)

Your Strengths We Preserve

Clear logical structure
Formal academic register
Precise terminology usage

See docs/social-science-patterns.md for detailed guidance.

🤝 Contributing

Contributions welcome! Areas where help is especially needed:

Additional disciplines (economics, geography, communication studies)
Enhanced detection algorithms
Examples from other language backgrounds

See CONTRIBUTING.md for details.

📄 License

MIT License - Free to use, modify, and distribute. See LICENSE for details.

📖 Citation

If you use this skill in your research or find it helpful, please consider citing:

@software{humanize_academic_writing,
  author = {MomoYOUNG},
  title = {Humanize Academic Writing: An AI Skill for Social Scientists},
  year = {2025},
  url = {https://github.com/momo2young/humanize-academic-writing}
}

🙏 Acknowledgments

Inspired by challenges non-native English speakers face in academic publishing
Informed by writing center pedagogy and composition studies
Built on principles from They Say / I Say and The Craft of Research

📧 Contact

GitHub Issues: github.com/momo2young/humanize-academic-writing/issues
Email: [email protected]

⭐ Star This Repository

If this tool helps your research, please star the repository to help others discover it!

Remember: Use AI tools responsibly. They should help you communicate your ideas more clearly, not replace your intellectual contribution.

humanize-academic-writing