agentsclimarketplace

G6

Skill brycewang-stanford/Auto-Empirical-Research-Skills/skills/25-HosungYou-Diverga/skills/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 styleFrom its SKILL.md

Install
npx -y skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill g6

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

SKILL.md

26.6 KB, ~6.0k tokens by cl100k_base, as published. Nobody here has run it

⛔ 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

  1. Vocabulary substitution (safest)

    • Replace AI-typical words with natural alternatives
  2. Phrase restructuring (moderate)

    • Rewrite verbose/formulaic phrases
  3. Sentence recombination (careful)

    • Merge or split sentences for flow
  4. 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?

AspectStandard VS (Research)HAVS (Humanization)
PurposeTheory/methodology selectionText transformation strategy
T-Score MeaningTheory typicalityTransformation pattern typicality
Phase Count5 phases (0-5)3 phases (0-2)
Creativity FocusConceptual innovationNatural 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 TransformationT-ScoreWhy It Fails
Synonym-only replacement0.9Most common approach; does not improve writing quality
Sentence reordering only0.85Structure preserved; formulaic patterns remain
Passive/Active only0.8Inconsistent voice creates new quality issues
Thesaurus cycling0.85Unnatural word choices; semantic drift
Paragraph shuffling0.75Logical 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:

  1. Disclosure: Following institutional and journal AI use policies
  2. Verification: Ensuring all claims and citations are accurate
  3. Originality: The ideas and research must be their own
  4. 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

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.