{
  "markdown": "# Humanize Academic Writing\n\n[🇬🇧 English](README.md) | [🇨🇳 中文](README_CN.md)\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)\n\nAn 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.\n\n---\n\n## ⚡ Quick Start\n\n**Install as Cursor Skill:**\n```bash\n# Clone the repository\ngit clone https://github.com/momo2young/humanize-academic-writing.git\n\n# Copy to Cursor skills directory (Windows)\nxcopy humanize-academic-writing %USERPROFILE%\\.cursor\\skills\\ /E /I\n\n# Or for macOS/Linux\ncp -r humanize-academic-writing ~/.cursor/skills/\n```\n\n**Install as Claude Code Skill:**\n```bash\n# Copy to Claude Code skills directory (Windows)\nxcopy humanize-academic-writing %USERPROFILE%\\.claude\\skills\\ /E /I\n\n# Or for macOS/Linux\ncp -r humanize-academic-writing ~/.claude/skills/\n```\n\n**Use the scripts directly:**\n```bash\n# Detect AI patterns\npython scripts/ai_detector.py your_draft.txt --detailed\n\n# Analyze text quality\npython scripts/text_analyzer.py your_draft.txt\n```\n\n**In Cursor IDE or Claude Code:**\n1. Restart after installation\n2. Select your AI-generated text\n3. Ask: *\"Can you help humanize this academic writing?\"*\n4. Or invoke directly: `/humanize-academic-writing`\n\n---\n\n## 🎯 What This Does\n\n### ✅ Transforms AI Writing Patterns\n- **Detects:** Repetitive structures, mechanical transitions, abstract language\n- **Rewrites:** With authentic scholarly voice and natural flow\n- **Explains:** What makes text sound AI-generated vs. human-written\n\n### 🎓 Target Audience\n- Social science researchers (sociology, anthropology, political science, education, psychology, communication study)\n- Non-native English speakers\n- Anyone using AI to draft papers based on their own research\n\n### ⚖️ Academic Integrity\n\n**Purpose:** Improve the naturalness of **your own ideas** expressed through AI writing tools.\n\n✅ **Appropriate:** Revising AI drafts of *your own research and arguments*  \n❌ **Inappropriate:** Generating ideas you don't have or disguising plagiarism\n\n**Principle:** The goal is authentic communication, not deception.\n\n---\n\n## 📖 Example Transformation\n\n**Before (AI-generated):**\n> Social media has become an important aspect of modern communication. Moreover, it has various effects on society. Additionally, researchers have studied this phenomenon extensively...\n\n**After (Humanized):**\n> 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).\n\n**What Changed:**\n- ❌ Removed mechanical transitions (Moreover, Additionally)\n- ❌ Replaced abstractions (\"various effects\") with specific concepts\n- ✅ Added concrete citations and scholarly voice\n- ✅ Varied sentence rhythm\n\n---\n\n## 🌟 Key Features\n\n1. **AI Pattern Detection** - Automatically identifies 6+ AI writing markers\n2. **Zero Dependencies** - Uses only Python standard library\n3. **Completely Local** - No data sent anywhere, full privacy\n4. **Discipline-Specific** - Tailored guidance for 5 social science fields\n5. **Rich Documentation** - 1370+ lines of principles, examples, and strategies\n6. **Open Source** - MIT License, free to use and modify\n\n---\n\n## 📚 Documentation\n\n### English\n- **[QUICKSTART.md](QUICKSTART.md)** - 5-minute getting started guide\n- **[SKILL.md](SKILL.md)** - Core skill file (works with both Cursor and Claude Code)\n- **[FAQ.md](FAQ.md)** - Frequently asked questions\n- **[docs/rewriting-principles.md](docs/rewriting-principles.md)** - 10 detailed rewriting strategies\n- **[docs/examples.md](docs/examples.md)** - 8+ complete before/after examples\n- **[docs/social-science-patterns.md](docs/social-science-patterns.md)** - Discipline-specific conventions\n\n### 中文\n- **[README_CN.md](README_CN.md)** - 中文版项目文档\n- **[QUICKSTART_CN.md](QUICKSTART_CN.md)** - 快速开始指南\n- **[FAQ_CN.md](FAQ_CN.md)** - 常见问题\n- **[docs/rewriting-principles_CN.md](docs/rewriting-principles_CN.md)** - 改写原则详解\n- **[docs/examples_CN.md](docs/examples_CN.md)** - 完整改写示例\n- **[docs/social-science-patterns_CN.md](docs/social-science-patterns_CN.md)** - 学科特定指导\n\n### Additional Resources\n- **[PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md)** - Complete project layout\n- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Contribution guidelines\n\n---\n\n## 🌍 For Non-Native English Speakers\n\nThis skill specifically addresses challenges non-native speakers face with AI-assisted writing:\n\n### Common AI Crutches We Fix\n- Over-reliance on formal transitions (Moreover, Furthermore)\n- Abstract placeholder phrases (\"in terms of,\" \"various aspects\")\n- Mechanical sentence patterns (all Subject-Verb-Object)\n\n### Your Strengths We Preserve\n- Clear logical structure\n- Formal academic register\n- Precise terminology usage\n\nSee [docs/social-science-patterns.md](docs/social-science-patterns.md) for detailed guidance.\n\n---\n\n## 🤝 Contributing\n\nContributions welcome! Areas where help is especially needed:\n- Additional disciplines (economics, geography, communication studies)\n- Enhanced detection algorithms\n- Examples from other language backgrounds\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n---\n\n## 📄 License\n\nMIT License - Free to use, modify, and distribute. See [LICENSE](LICENSE) for details.\n\n---\n\n## 📖 Citation\n\nIf you use this skill in your research or find it helpful, please consider citing:\n\n```bibtex\n@software{humanize_academic_writing,\n  author = {MomoYOUNG},\n  title = {Humanize Academic Writing: An AI Skill for Social Scientists},\n  year = {2025},\n  url = {https://github.com/momo2young/humanize-academic-writing}\n}\n```\n\n---\n\n## 🙏 Acknowledgments\n\n- Inspired by challenges non-native English speakers face in academic publishing\n- Informed by writing center pedagogy and composition studies\n- Built on principles from *They Say / I Say* and *The Craft of Research*\n\n---\n\n## 📧 Contact\n\n- **GitHub Issues:** [github.com/momo2young/humanize-academic-writing/issues](https://github.com/momo2young/humanize-academic-writing/issues)\n- **Email:** pgallerymoon@gmail.com\n\n---\n\n## ⭐ Star This Repository\n\nIf this tool helps your research, please star the repository to help others discover it!\n\n---\n\n**Remember:** Use AI tools responsibly. They should help you communicate your ideas more clearly, not replace your intellectual contribution.\n",
  "bytes": 6691,
  "sha": "c73fd922fc73e61fcf7111a879205ba3bfeb025da8eba0f4a79074f74503c9a0",
  "repo_slug": "momo2young/humanize-academic-writing",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_momo2young_humanize_academic_writing_hum_f71d3296/readme"
}