humanize-academic-writing
Transform AI-generated academic text into natural, human-like scholarly writing for social sciences. Detects AI patterns (repetitive structures, abstract language, mechanical flow) and rewrites with authentic academic voice. Use when revising AI-drafted papers, improving writing naturalness, reducing AI detection markers, or when user mentions humanizing text, academic writing quality, or social science writing for non-native English speakers.
What this skill does
# Humanize Academic Writing for Social Sciences
## Academic Integrity Statement
**Purpose**: This skill helps researchers improve the quality and naturalness of their **own original ideas** expressed through AI-assisted writing tools.
**Ethical Use**:
- ✅ Revising AI-drafted text based on your own research and ideas
- ✅ Improving writing quality for non-native English speakers
- ✅ Learning better academic writing patterns
- ❌ Using AI to generate ideas you don't understand
- ❌ Submitting work that doesn't represent your intellectual contribution
**Principle**: The goal is authentic scholarly communication, not deception.
---
## Target Audience
Non-native English speakers in social sciences (sociology, anthropology, political science, education, psychology) who:
- Have original ideas and research
- Used AI tools to draft their text
- Need to humanize the writing style
- Want to reduce obvious AI patterns
---
## When to Use This Skill
- User has AI-generated draft based on their own ideas
- Text feels "too perfect," mechanical, or repetitive
- Need to reduce AI detection markers
- Want authentic academic voice for social science writing
- Paragraph transitions feel robotic
- Language is overly abstract without concrete examples
---
## Core Workflow
### Step 1: Analyze the Text
First, run the AI detection analyzer to identify problematic patterns:
```bash
python scripts/ai_detector.py input.txt
```
The analyzer identifies:
- Repetitive sentence structures and lengths
- Overused AI transition phrases (Moreover, Furthermore, Additionally)
- Abstract/vague language patterns ("various aspects", "in terms of")
- Mechanical paragraph transitions
- Unnatural word choices for social sciences
- Low vocabulary diversity (Type-Token Ratio)
- Excessive passive voice
- Consecutive sentence similarity
**Output**: AI probability score + specific issues marked per paragraph
### Step 2: Apply Targeted Rewriting Strategies
Based on detected issues, apply these fixes:
#### Strategy 1: Vary Sentence Rhythm (Fix Uniformity)
**AI Pattern**: All sentences are similar length (15-20 words)
**Human Fix**: Mix short (5-10), medium (15-20), and long (25-35) sentences
Example:
- AI: "This study examines social media impact. The research focuses on young adults. The analysis considers multiple factors."
- Human: "This study examines social media's impact on young adults, considering factors ranging from identity formation to civic engagement."
#### Strategy 2: Reduce Abstract Scaffolding
**AI Pattern**: Vague placeholder phrases that say little
Common culprits:
- "various aspects"
- "in terms of"
- "it is important to note that"
- "multiple factors"
- "different perspectives"
**Human Fix**: Replace with specific concepts, named theories, concrete examples
Example:
- AI: "In terms of the various aspects of social interaction, multiple factors play important roles."
- Human: "Social interaction depends on trust, reciprocity, and shared norms—factors that vary across cultural contexts."
#### Strategy 3: Eliminate Mechanical Transitions
**AI Pattern**: Overusing formal connectors at sentence starts
Overused words:
- Moreover,
- Furthermore,
- Additionally,
- In addition,
- It is important to note that
**Human Fix**: Use diverse transition strategies:
- Direct logical flow (no connector needed)
- "This pattern echoes..."
- "Building on this insight..."
- "Yet" / "Still" / "However" (sparingly)
- Implicit connections through content
#### Strategy 4: Add Scholarly Voice
**AI Pattern**: Generic academic tone without personality or critical engagement
**Human Fix**:
- Include appropriate hedging ("may suggest", "appears to", "potentially")
- Show critical engagement with sources
- Use disciplinary language naturally
- Demonstrate genuine intellectual grappling
Example:
- AI: "The data shows a correlation between X and Y."
- Human: "The data suggest a correlation between X and Y, though the causal mechanism remains unclear and warrants further investigation."
#### Strategy 5: Ground in Specificity
**AI Pattern**: Generic statements without grounding
**Human Fix**:
- Name specific theories/scholars
- Include concrete examples
- Reference particular contexts
- Cite actual studies with details
Example:
- AI: "Research has shown various effects of social media on society."
- Human: "Recent ethnographic work documents how Instagram reshapes young women's body image practices (Tiidenberg 2018), while experimental studies reveal minimal effects on political polarization (Guess et al. 2023)."
### Step 3: Rewrite with Rationale
For each paragraph, follow this format:
**Original (AI-generated):**
[Paste the original text]
**Revised (Humanized):**
[Your rewritten version]
**Rationale:**
Explain in 1-2 sentences what AI patterns you fixed. Examples:
- "Removed repetitive 'Moreover/Additionally' transitions and varied sentence rhythm (added one short sentence, one long); replaced 'various aspects' with specific concepts (trust, reciprocity, norms)."
- "Eliminated abstract scaffolding ('in terms of', 'multiple factors'); added concrete citation (Smith 2022) and specific research finding; included scholarly hedging ('suggests' rather than 'shows')."
- "Broke uniform 18-word sentences into varied lengths (8, 24, 15 words); removed mechanical 'Furthermore' openers; grounded claims in named theory (social capital) and specific context (urban China)."
---
## Key Principles for Humanizing Text
### 1. Perplexity (Unpredictability)
- **Problem**: AI text is too predictable
- **Fix**: Add unexpected (but academically appropriate) word choices; vary syntactic structures
### 2. Burstiness (Rhythm Variation)
- **Problem**: AI uses uniform sentence lengths
- **Fix**: Mix short punchy sentences with longer complex ones; create natural reading rhythm
### 3. Specificity over Abstraction
- **Problem**: AI defaults to vague abstractions
- **Fix**: Use concrete examples, specific data, named theories; ground claims in particular contexts
### 4. Authentic Academic Voice
- **Problem**: Generic formal tone without personality
- **Fix**: Show genuine engagement with ideas; include appropriate hedging; demonstrate critical thinking
### 5. Natural Flow
- **Problem**: Mechanical transitions and paragraph connections
- **Fix**: Let content drive connections; use implicit logic; minimize formal connectors
---
## Social Science Specifics
### Disciplinary Language
**Sociology**:
- Key concepts: stratification, agency, habitus, capital, institutions, inequality
- Theoretical traditions: functionalist, conflict, symbolic interactionist, practice theory
- Common methods: ethnography, surveys, interviews, archival analysis
**Anthropology**:
- Key concepts: culture, ritual, kinship, liminality, positionality, thick description
- More reflexive voice acceptable
- Ethnographic detail valued
**Political Science**:
- Key concepts: institutions, power, legitimacy, governance, state capacity
- Causal inference language
- Hypothesis testing frameworks
**Education**:
- Key concepts: pedagogy, curriculum, equity, achievement gaps, learning outcomes
- Mixed methods common
- Policy relevance emphasized
**Psychology (Social)**:
- Key concepts: cognition, behavior, attitudes, interventions, mechanisms
- Operational definitions critical
- Experimental designs prominent
### Non-Native Speaker Considerations
**Common AI Crutches**:
1. Over-reliance on intensifiers ("very", "really", "quite")
2. Repetitive sentence starters
3. Overuse of formal connectors to signal logic
**Strengths to Preserve**:
- Clear logical structure (maintain this)
- Formal register (appropriate for academic writing)
- Careful grammar (don't over-casualize)
**Areas to Humanize**:
- Vary clause structures and sentence types
- Use field-specific terminology confidently
- Add appropriate scholarly hedging
- Include critical engagement with sources
- Ground abstractions in concrete examples
---
## Additional ResourcesRelated in Image & Video
watch
IncludedWatch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.
physical-ai-defect-image-generation
IncludedUse when the user wants to orchestrate defect image generation, run associated setup, or handle outputs on OSMO. The Day 0 path handles cold-start with USD-to-ROI, image-edit augmentation, and AnomalyGen to create initial PCBA datasets. The Day 1 path performs inference and labeling on real images. This skill helps with first-time asset setup, creation of finetuning checkpoints, and configuring deployment. Trigger keywords: defect image generation, dig workflow, dig pipeline, defect image detection workflow, aoi pipeline, aoi anomalygen, usd2roi anomalygen, day 0 pcba, day 1 pcba, day 1 real-photo alignment, day 1 manual roi, metal surface anomaly, glass defect, anomalygen finetune, setup_pcb, setup_metal, setup_glass, setup_pretrained, dig setup, dig datasets, dig pretrained checkpoint, dig image-edit endpoint.
accelint-react-best-practices
IncludedReact performance optimization and best practices. ALWAYS use this skill when working with any React code - writing components, hooks, JSX; refactoring; optimizing re-renders, memoization, state management; reviewing for performance; fixing hydration mismatches; debugging infinite re-renders, stale closures, input focus loss, animations restarting; preventing remounting; implementing transitions, lazy initialization, effect dependencies. Even simple React tasks benefit from these patterns. Covers React 19+ (useEffectEvent, Activity, ref props). Triggers - useEffect, useState, useMemo, useCallback, memo, inline components, nested components, components inside components, re-render, performance, hydration, SSR, Next.js, useDeferredValue, combined hooks.
elevenlabs-agents
IncludedBuild conversational AI voice agents with ElevenLabs Platform using React, JavaScript, React Native, or Swift SDKs. Configure agents, tools (client/server/MCP), RAG knowledge bases, multi-voice, and Scribe real-time STT. Use when: building voice chat interfaces, implementing AI phone agents with Twilio, configuring agent workflows or tools, adding RAG knowledge bases, testing with CLI "agents as code", or troubleshooting deprecated @11labs packages, Android audio cutoff, CSP violations, dynamic variables, or WebRTC config. Keywords: ElevenLabs Agents, ElevenLabs voice agents, AI voice agents, conversational AI, @elevenlabs/react, @elevenlabs/client, @elevenlabs/react-native, @elevenlabs/elevenlabs-js, @elevenlabs/agents-cli, elevenlabs SDK, voice AI, TTS, text-to-speech, ASR, speech recognition, turn-taking model, WebRTC voice, WebSocket voice, ElevenLabs conversation, agent system prompt, agent tools, agent knowledge base, RAG voice agents, multi-voice agents, pronunciation dictionary, voice speed control, elevenlabs scribe, @11labs deprecated, Android audio cutoff, CSP violation elevenlabs, dynamic variables elevenlabs, case-sensitive tool names, webhook authentication
humanizer
IncludedHumanize AI-generated text by detecting and removing patterns typical of LLM output. Rewrites text to sound natural, specific, and human. Uses 28 pattern detectors, 560+ AI vocabulary terms across 3 tiers, and statistical analysis (burstiness, type-token ratio, readability) for comprehensive detection. Use when asked to humanize text, de-AI writing, make content sound more natural/human, review writing for AI patterns, score text for AI detection, or improve AI-generated drafts. Covers content, language, style, communication, and filler categories.
generating-mermaid-diagrams
IncludedSalesforce architecture diagrams using Mermaid with ASCII fallback. Use this skill when generating text-based diagrams for Salesforce architecture, OAuth flows, ERDs, integration sequences, or Agentforce structure. TRIGGER when: user says "diagram", "visualize", "ERD", or asks for sequence diagrams, flowcharts, class diagrams, or architecture visualizations in Mermaid. DO NOT TRIGGER when: user wants PNG/SVG image output (use generating-visual-diagrams), or asks about non-Salesforce systems.