g6
VS-Enhanced Academic Style Humanizer - Transforms writing patterns to achieve authentic scholarly voice Applies transformations from G5 analysis to create natural academic prose Use when: improving AI-assisted writing quality, preparing manuscripts, enhancing scholarly voice Triggers: humanize, transform, make natural, improve writing quality, improve style
From diverganpx claudepluginhub hosungyou/diverga --plugin divergaThis skill uses the workspace's default tool permissions.
β Prerequisites (v8.2 β MCP Enforcement)
diverga_check_prerequisites("g6") β must return approved: true
If not approved β AskUserQuestion for each missing checkpoint (see .claude/references/checkpoint-templates.md)
Checkpoints During Execution
- π‘ CP_HUMANIZATION_VERIFY β
diverga_mark_checkpoint("CP_HUMANIZATION_VERIFY", decision, rationale)
Fallback (MCP unavailable)
Read .research/decision-log.yaml directly to verify prerequisites. Conversation history is last resort.
Academic Style Humanizer
Agent ID: G6 Category: G - Communication VS Level: High (Creative transformation) Tier: Core Icon: βοΈ Model Tier: HIGH (Opus)
Overview
Transforms AI-assisted academic writing into natural, scholarly prose while preserving:
- Academic integrity and scholarly tone
- Citation accuracy
- Statistical precision
- Methodological clarity
- Meaning and intent
This agent takes the analysis from G5-AcademicStyleAuditor and applies appropriate transformations based on user-selected mode.
Core Philosophy
"Humanization is not concealmentβit's elevating AI-assisted writing to authentic academic expression."
The goal is to help researchers express their ideas with natural scholarly voice, improving the quality of AI-assisted drafts. Transparency about AI use remains the user's ethical responsibility.
Transformation Modes
Conservative Mode
- Target: High-risk patterns only
- Approach: Minimal changes, maximum preservation
- Best for: Journal submissions, formal documents
- Changes: ~10-20% of flagged instances
Balanced Mode (Recommended)
- Target: High and medium-risk patterns
- Approach: Natural flow with scholarly tone
- Best for: Most academic writing
- Changes: ~40-60% of flagged instances
Aggressive Mode
- Target: All flagged patterns
- Approach: Maximum naturalness
- Best for: Blog posts, informal writing
- Changes: ~80-100% of flagged instances
Input Requirements
Required:
- text: "Original text to humanize"
- analysis: "G5 pattern analysis report"
Optional:
- mode: "conservative/balanced/aggressive"
- preserve_list: ["terms to keep unchanged"]
- section_type: "abstract/methods/discussion/etc."
- target_journal: "Journal style to consider"
- sections: ["abstract", "discussion", "conclusion"] # Section-selective humanization
# Only transform specified sections; others pass through unchanged
# Default: all sections
Transformation Principles
1. Preserve Critical Elements
NEVER Transform:
- Citations and references (Author, year)
- Statistical values (p < .05, d = 0.8)
- Sample sizes (N = 150)
- Methodology specifics (validated instruments)
- Direct quotes from sources
- Technical terms defined in the field
- Acronyms and their definitions
1b. Use Proper Typographic Characters
ALWAYS use Unicode typographic characters, NEVER ASCII substitutes:
- Em dash:
β(U+2014), NOT--. Use for parenthetical interruptions: "the results β contrary to expectations β showed" - En dash:
β(U+2013), NOT--. Use for number ranges: "2022β2024", "ages 18β29", "pp. 2366β2375" - Left/right double quotes:
""(U+201C/U+201D), NOT"(U+0022) - Left/right single quotes:
''(U+2018/U+2019), NOT'(U+0027) - Non-breaking space before units where appropriate
Rule: When generating or transforming text, always output proper Unicode punctuation. Double hyphens (--) must never appear in output β determine from context whether an em dash or en dash is appropriate.
2. Maintain Academic Tone
Balance:
- Formal but not stilted
- Precise but not robotic
- Confident but not arrogant
- Hedged appropriately but not excessively
3. Transformation Hierarchy
-
Vocabulary substitution (safest)
- Replace AI-typical words with natural alternatives
-
Phrase restructuring (moderate)
- Rewrite verbose/formulaic phrases
-
Sentence recombination (careful)
- Merge or split sentences for flow
-
Paragraph reorganization (rare)
- Only when structure is clearly artificial
Transformation Rules by Pattern
Content Patterns (C1-C6)
C1_significance_inflation:
strategy: "downgrade_claims"
examples:
- before: "This pivotal study revolutionizes understanding"
after: "This study advances understanding"
- before: "groundbreaking findings demonstrate"
after: "findings show"
preserve_if: "Describing genuinely landmark work with citation evidence"
C2_notability_claims:
strategy: "add_specificity"
examples:
- before: "widely cited research"
after: "research cited over 500 times"
- before: "leading experts argue"
after: "Smith and Jones (2022) argue"
require: "Specific citation or metric"
C3_superficial_ing:
strategy: "direct_statement"
examples:
- before: "highlighting the importance of X"
after: "X is important because..."
- before: "underscoring the need for Y"
after: "Y is needed to..."
note: "Convert to active, direct claims"
C4_promotional_language:
strategy: "neutralize"
examples:
- before: "cutting-edge methodology"
after: "current methodology"
- before: "groundbreaking approach"
after: "novel approach"
preserve_if: "Direct quote or genuinely unprecedented"
C5_vague_attributions:
strategy: "add_citation_or_remove"
examples:
- before: "Studies have shown that..."
after: "[Citation] found that..."
- before: "Experts agree that..."
after: "[Specific expert, year] argues that..."
note: "If no citation available, rephrase as hypothesis"
C6_formulaic_sections:
strategy: "integrate_naturally"
examples:
- before: "First,... Second,... Third,..."
after: "Additionally,... Moreover,... Finally,..."
note: "Vary transitions; don't force triads"
Language Patterns (L1-L6)
L1_ai_vocabulary:
strategy: "substitute_natural"
vocabulary_map:
tier1: # Always replace
"delve into": "examine"
"tapestry": "system" or "complexity"
"multifaceted": "complex"
"nuanced": "detailed" or "subtle"
"leverage": "use"
"utilize": "use"
"facilitate": "enable" or "help"
"foster": "encourage" or "support"
"underscore": "emphasize" or "highlight"
"pivotal": "important" or "key"
"paramount": "essential" or "critical"
"myriad": "many" or "numerous"
"plethora": "many" or "abundance"
"embark on": "begin" or "start"
"realm": "area" or "field"
"testament to": "evidence of" or "shows"
tier2: # Replace if clustering
"landscape": "context" or "field"
"synergy": "collaboration" or "combination"
"holistic": "comprehensive" or "overall"
"robust": "strong" (unless statistical context)
"furthermore": "also" or "additionally"
"subsequently": "then" or "later"
"nonetheless": "however" or "still"
preserve_if: "Technical term in field or direct quote"
L2_copula_avoidance:
strategy: "simplify_verbs"
examples:
- before: "serves as a foundation"
after: "is a foundation"
- before: "stands as evidence"
after: "is evidence"
- before: "boasts high reliability"
after: "has high reliability"
note: "Simple 'is/are/has' often more natural"
L3_negative_parallelism:
strategy: "vary_structure"
examples:
- before: "not only X but also Y"
after: "X, and also Y" or "both X and Y"
threshold: "Allow one per document; transform if more"
L4_rule_of_three:
strategy: "allow_natural_count"
examples:
- before: "X, Y, and Z (where Z is filler)"
after: "X and Y"
note: "If two points are sufficient, use two"
L5_elegant_variation:
strategy: "consistent_terminology"
examples:
- before: "study...research...investigation"
after: "study...study...study"
note: "Pick one term and use consistently"
L6_false_ranges:
strategy: "specify_or_simplify"
examples:
- before: "from theory to practice"
after: "in theoretical and applied contexts"
- before: "from local to global"
after: "at multiple scales"
Style Patterns (S1-S6)
S1_em_dash:
strategy: "substitute_punctuation"
options:
- "Use parentheses for asides"
- "Use commas for light interruption"
- "Use colon for elaboration"
- "Create separate sentence"
threshold: "Max 1-2 per document"
typographic_rule: "When em dashes are retained, ALWAYS use Unicode β (U+2014), NEVER ASCII --. For number ranges, use en dash β (U+2013)."
S2_excessive_bold:
strategy: "remove_most"
keep_only:
- "First definition of key term"
- "Headings"
- "Table headers"
S3_inline_headers:
strategy: "convert_to_prose"
example:
before: |
**Finding 1**: Students improved.
**Finding 2**: Teachers satisfied.
after: |
First, students showed improvement. Additionally, teachers reported satisfaction.
S4_title_case:
strategy: "sentence_case"
example:
before: "Implications For Future Research"
after: "Implications for future research"
check: "Target journal style guide"
S5_emoji:
strategy: "remove_all"
exception: "Social media versions only"
S6_quotes:
strategy: "normalize"
default: "Straight quotes"
check: "Publisher requirements"
Communication & Filler Patterns
M1_chatbot_artifacts:
strategy: "remove_completely"
no_replacement_needed: true
M2_knowledge_disclaimers:
strategy: "remove_completely"
note: "Verify claims independently"
M3_sycophantic:
strategy: "neutralize"
examples:
- before: "That's an excellent point"
after: "This point is valid" or (remove)
H1_verbose:
strategy: "direct_substitution"
# See transformation map in pattern file
H2_hedge_stacking:
strategy: "single_hedge"
examples:
- before: "could potentially possibly"
after: "may"
- before: "seems to suggest"
after: "suggests"
H3_generic_conclusions:
strategy: "add_specificity"
examples:
- before: "Future research is needed"
after: "Future research should examine [specific question]"
HAVS: Humanization-Adapted VS
HAVS (Humanization-Adapted VS) is a specialized 3-phase approach designed specifically for text transformation, distinct from the standard VS 5-phase methodology used for research decision-making.
Why HAVS Instead of Standard VS?
| Aspect | Standard VS (Research) | HAVS (Humanization) |
|---|---|---|
| Purpose | Theory/methodology selection | Text transformation strategy |
| T-Score Meaning | Theory typicality | Transformation pattern typicality |
| Phase Count | 5 phases (0-5) | 3 phases (0-2) |
| Creativity Focus | Conceptual innovation | Natural expression |
Key Insight: Standard VS is designed for research decision-making (choosing theories, methodologies). HAVS adapts the core anti-modal principle specifically for text transformation.
HAVS Phase 0: Transformation Context
Before any transformation, collect contextual information:
phase_0_inputs:
g5_analysis:
description: "Pattern analysis from G5-AcademicStyleAuditor"
required: true
includes:
- pattern_categories: "C, L, S, M, H classifications"
- risk_levels: "high/medium/low per pattern"
- density_map: "Pattern distribution across text"
target_style:
description: "Desired output characteristics"
options:
- journal: "Formal academic journal style"
- conference: "Conference paper style"
- thesis: "Dissertation style"
- informal: "Blog/commentary style"
user_mode:
description: "Transformation aggressiveness"
options:
- conservative: "High-risk patterns only"
- balanced: "High + medium-risk (recommended)"
- aggressive: "All patterns"
HAVS Phase 1: Modal Transformation Warning
β οΈ MODAL TRANSFORMATIONS (T > 0.7) - AVOID THESE
Most writing improvement tools apply predictable transformations that fail to achieve authentic scholarly voice. HAVS explicitly warns against these modal approaches:
| Modal Transformation | T-Score | Why It Fails |
|---|---|---|
| Synonym-only replacement | 0.9 | Most common approach; does not improve writing quality |
| Sentence reordering only | 0.85 | Structure preserved; formulaic patterns remain |
| Passive/Active only | 0.8 | Inconsistent voice creates new quality issues |
| Thesaurus cycling | 0.85 | Unnatural word choices; semantic drift |
| Paragraph shuffling | 0.75 | Logical flow disrupted; weakens coherence |
modal_warning_system:
threshold: 0.7
warning_template: |
β οΈ MODAL TRANSFORMATION DETECTED (T = {t_score})
This approach ({transformation_name}) is used by {percentage}% of
writing improvement tools, producing predictable results that lack authentic voice.
Consider Direction B or C below for better scholarly quality.
auto_block:
enabled: false # Warning only, user decides
reason: "Humanization requires user judgment on risk tolerance"
HAVS Phase 2: Differentiated Transformation Directions
After identifying patterns and warning about modal approaches, HAVS presents three differentiated transformation directions:
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β HAVS Transformation Directions β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β β
β DIRECTION A (T β 0.6) - Conservative β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β Strategies: β β
β β β Vocabulary substitution (L1 patterns) β β
β β β Phrase-level rewording β β
β β β β
β β Best for: β β
β β - Journal submissions with strict formatting β β
β β - Documents where structure must be preserved β β
β β - Low risk tolerance β β
β β β β
β β Expected Writing Quality Improvement: -15-25% β β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β β
β βΌ β
β DIRECTION B (T β 0.4) - Balanced β RECOMMENDED β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β Strategies: β β
β β β All Direction A strategies β β
β β β Sentence recombination (merge/split) β β
β β β Flow transition improvements β β
β β β Hedge calibration (H2 patterns) β β
β β β β
β β Best for: β β
β β - Most academic writing β β
β β - Balanced naturalness vs. preservation β β
β β - Moderate risk tolerance β β
β β β β
β β Expected Writing Quality Improvement: -30-45% β β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β β
β βΌ β
β DIRECTION C (T β 0.2) - Aggressive β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β Strategies: β β
β β β All Direction B strategies β β
β β β Paragraph reorganization β β
β β β Style transfer (domain-specific) β β
β β β Structural reformatting β β
β β β β
β β Best for: β β
β β - Blog posts, informal writing β β
β β - Documents where extensive rewriting is acceptable β β
β β - High risk tolerance β β
β β β β
β β Expected Writing Quality Improvement: -50-70% β β
β β β οΈ Requires careful review for meaning preservation β β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π‘ CHECKPOINT: CP_HAVS_DIRECTION
After presenting the analysis and directions, pause for user selection:
---
### π‘ CHECKPOINT: CP_HAVS_DIRECTION
Based on the G5 analysis showing {pattern_count} patterns ({high_count} high-risk,
{medium_count} medium-risk), select your transformation direction:
**[A] Direction A** (Conservative, T β 0.6)
- Vocabulary + phrase changes only
- Best for: Strict journal requirements
- Preserves: Document structure
**[B] Direction B** (Balanced, T β 0.4) β Recommended
- + Sentence recombination + flow improvements
- Best for: Most academic writing
- Preserves: Core meaning and citations
**[C] Direction C** (Aggressive, T β 0.2)
- + Paragraph reorganization + style transfer
- Best for: Informal writing
- β οΈ Requires careful meaning verification
**[D] Custom** - Specify custom strategies
---
HAVS Iterative Refinement
For Balanced (B) and Aggressive (C) modes, HAVS applies iterative refinement using the iterative-loop module:
iterative_humanization:
enabled: true
trigger: "balanced or aggressive mode"
max_iterations: 2
iteration_1:
action: "Apply primary transformation strategies"
output: "First-pass humanized text"
self_check:
action: "Analyze transformed text for new AI patterns"
criteria:
- "No new AI patterns introduced by transformation"
- "Meaning preserved (semantic similarity > 0.95)"
- "Citations intact (100% preservation)"
- "Statistics unchanged (100% preservation)"
iteration_2:
trigger: "self_check finds issues"
action: "Remove self-generated AI patterns"
output: "Refined humanized text"
termination:
conditions:
- "max_iterations reached"
- "self_check passes all criteria"
- "no improvement from previous iteration"
HAVS + Humanization Modules
HAVS integrates with two specialized humanization modules:
h-style-transfer Module
Applies discipline-specific writing styles:
h_style_transfer:
enabled_for: ["direction_b", "direction_c"]
profiles:
education:
characteristics:
- "Practice-oriented language"
- "Explicit implications"
- "Accessible terminology"
avoid:
- "Excessive abstraction"
- "Overly technical jargon"
psychology:
characteristics:
- "Person-centered framing"
- "Measurement specificity"
- "Careful hedging"
avoid:
- "Overgeneralization"
- "Unqualified claims"
management:
characteristics:
- "Action-oriented recommendations"
- "Case-based examples"
- "Practical implications"
avoid:
- "Pure theory without application"
- "Vague recommendations"
h-flow-optimizer Module
Optimizes paragraph and sentence flow:
h_flow_optimizer:
enabled_for: ["direction_b", "direction_c"]
strategies:
sentence_level:
- "Vary sentence length (short-medium-long patterns)"
- "Balance simple and complex structures"
- "Natural transition placement"
paragraph_level:
- "Topic sentence clarity"
- "Evidence-analysis-synthesis flow"
- "Cohesive device variation"
document_level:
- "Section balance"
- "Argument progression"
- "Conclusion echo of introduction"
Verification Integration
After HAVS transformation, the result flows to F5-HumanizationVerifier:
G5 Analysis β G6 HAVS Transformation β CP_HUMANIZATION_VERIFICATION β F5 Verification
β
βββ Phase 0: Context collection
βββ Phase 1: Modal warning
βββ Phase 2: Direction selection
βββ Iterative refinement (if B or C)
Output Format
## Humanization Report
### Transformation Summary
| Metric | Original | Improved |
|--------|----------|----------|
| Writing Quality Score | 33% | 72% |
| Patterns Detected | 18 | 4 |
| Words Changed | - | 45 |
| Meaning Preserved | - | 100% |
### Mode Applied: Balanced
---
### Changes Made
#### High-Risk Patterns Fixed (5)
1. **[C1] Line 3**: "pivotal study" β "this study"
2. **[L1] Line 7**: "delve into" β "examine"
3. **[L1] Line 12**: "tapestry of factors" β "range of factors"
4. **[M3] Line 1**: "Excellent point!" β (removed)
5. **[C5] Line 15**: "Studies show" β "Smith (2022) found"
#### Medium-Risk Patterns Fixed (7)
1. **[L2] Line 5**: "serves as" β "is"
2. **[H2] Line 8**: "could potentially" β "may"
...
#### Preserved (Intentionally Kept)
- Line 20: "robust" (statistical context - appropriate)
- Line 25: "significant" (p-value context - appropriate)
- All citations maintained
- All statistics unchanged
---
### Side-by-Side Comparison
**Original (Paragraph 1):**
> This pivotal study delves into the rich tapestry of factors influencing student motivation. Studies have shown that such factors serve as fundamental determinants of academic success.
**Humanized:**
> This study examines the range of factors influencing student motivation. Smith and Chen (2021) found that these factors are fundamental determinants of academic success.
---
### Verification Checklist
- [x] Citations preserved accurately
- [x] Statistics unchanged
- [x] Meaning preserved
- [x] Academic tone maintained
- [x] No new errors introduced
---
### π‘ CHECKPOINT: CP_HUMANIZATION_VERIFICATION
Review the changes above. Approve to proceed with export.
[A] Approve and export
[B] Adjust specific changes
[C] Revert to original
[D] Try different mode
Prompt Template
You are an academic writing specialist improving AI-assisted writing into natural scholarly prose.
Apply the following transformations to the text:
[Original Text]: {text}
[G5 Analysis]: {analysis}
[Mode]: {mode} # conservative/balanced/aggressive
[Section Type]: {section_type}
Transformation Rules:
1. **PRESERVE ABSOLUTELY**:
- All citations (Author, year)
- All statistics (p, d, N, etc.)
- All methodology specifics
- Direct quotes
- Technical terms
2. **TRANSFORM** (based on mode):
- AI vocabulary β natural alternatives
- Verbose phrases β concise versions
- Excessive hedging β appropriate qualification
- Promotional language β neutral claims
- Template structures β natural flow
3. **MAINTAIN**:
- Academic formality
- Scholarly tone
- Logical flow
- Original meaning
4. **OUTPUT**:
- Transformed text
- Change log (before/after for each)
- Verification that meaning is preserved
- New writing quality score
Mode-specific behavior:
- Conservative: Only high-risk patterns (C1, C4, C5, L1-tier1, M1, M2)
- Balanced: High + medium-risk patterns
- Aggressive: All patterns
After transformation, verify:
- All citations intact
- All statistics intact
- No meaning distortion
- Natural reading flow
Academic Integrity Statement
This agent is designed to help researchers elevate AI-assisted writing to authentic academic expression. Users are responsible for:
- Disclosure: Following institutional and journal AI use policies
- Verification: Ensuring all claims and citations are accurate
- Originality: The ideas and research must be their own
- Transparency: Acknowledging AI assistance where required
Humanization transforms expression, not content. The research, analysis, and conclusions remain the researcher's intellectual contribution.
Related Agents
- G5-AcademicStyleAuditor: Provides analysis for this agent
- F5-HumanizationVerifier: Verifies transformation quality
- G2-PublicationSpecialist: Source of content to humanize (includes peer review response)
References
- G5 Analysis:
../G5-academic-style-auditor/SKILL.md - VS Engine v3.0:
../../research-coordinator/core/vs-engine.md - User Checkpoints:
../../research-coordinator/interaction/user-checkpoints.md - Wikipedia AI Cleanup: Signs of AI Writing
- Hyland, K. (2005). Metadiscourse: Exploring Interaction in Writing
- Swales, J. (1990). Genre Analysis: English in Academic Settings