grammar-style-enhancer

What this skill does

# Grammar and Style Enhancer

## Purpose

This skill helps authors refine their prose by identifying grammar errors, style inconsistencies, weak constructions, and clarity issues. It provides actionable suggestions that improve readability while respecting and preserving the author's unique voice.

## When to Use

- User wants to polish a completed draft
- User needs help with grammar and punctuation
- User wants to improve sentence variety and rhythm
- User is concerned about passive voice or weak verbs
- User needs consistency checking (tense, POV, spelling)
- User wants to enhance clarity and conciseness
- User requests style analysis or readability assessment

## Instructions

### Step 1: Establish Parameters

Ask the user:

- **Text to Analyze**: Specific passage, chapter, or full manuscript
- **Genre**: Literary fiction, genre fiction, non-fiction, academic, etc.
- **Target Audience**: Adult, YA, middle grade, academic readers
- **Style Preferences**: Formal/casual, verbose/concise, complex/simple
- **Specific Concerns**: Any particular issues they've noticed or want addressed
- **Voice Preservation**: How important is maintaining their exact style vs. optimization?

### Step 2: Multi-Level Analysis Framework

Analyze the text across these dimensions:

#### A. Grammar and Mechanics

- Subject-verb agreement
- Pronoun agreement and clarity
- Verb tense consistency
- Comma splices and run-ons
- Sentence fragments (distinguish stylistic from errors)
- Apostrophe and quotation mark usage
- Capitalization
- Spelling and homophones

#### B. Clarity and Concision

- Redundancy and wordiness
- Vague or ambiguous phrasing
- Unclear antecedents
- Dangling or misplaced modifiers
- Overly complex sentences
- Jargon or unexplained terms

#### C. Style and Voice

- Passive vs. active voice
- Weak verbs (is, was, has, etc.)
- Telling vs. showing
- Sentence variety (length and structure)
- Rhythm and pacing
- Repetitive sentence starts
- Clichés and overused phrases
- Word choice (precision and impact)

#### D. Consistency

- Tense shifts (unless intentional)
- POV consistency
- Spelling variants (theater/theatre, grey/gray)
- Formatting (em dashes, ellipses, etc.)
- Character name/description consistency

#### E. Readability

- Average sentence length
- Paragraph length
- Reading level (Flesch-Kincaid)
- Flow and transitions between ideas

### Step 3: Generate Enhancement Report

Present findings in this structured format:

```markdown
# Grammar and Style Enhancement Report

## Text Analyzed

**Word Count**: [X,XXX]
**Paragraph Count**: [XX]
**Average Sentence Length**: [XX words]
**Estimated Reading Level**: [Grade level]
**Genre**: [Genre]

---

## Executive Summary

- **Grammar Errors**: [X] (Critical: [Y])
- **Style Opportunities**: [X] (High-impact: [Y])
- **Consistency Issues**: [X]
- **Overall Prose Quality**: [X/10]
- **Primary Strength**: [What's working well]
- **Primary Opportunity**: [Biggest area for improvement]

---

## Critical Grammar Errors

### 1. [Error Type]

**Original**: "[Quote from text with error]"
**Issue**: [Explanation of what's wrong]
**Corrected**: "[Suggested fix]"
**Rule**: [Brief grammar rule explanation]

---

## Style Enhancement Opportunities

### High-Impact Changes

#### 1. Passive Voice → Active Voice

**Original**: "The door was opened by Sarah."
**Suggested**: "Sarah opened the door."
**Why**: Active voice is more direct and engaging; strengthens Sarah's agency
**Impact**: Medium - Improves clarity and pacing

#### 2. Weak Verb Strengthening

**Original**: "He was walking very quickly down the street."
**Suggested**: "He hurried down the street." OR "He strode down the street."
**Why**: Stronger verb incorporates the adverb, more concise and vivid
**Impact**: High - More precise and engaging

#### 3. Show, Don't Tell

**Original**: "She was very angry."
**Suggested**: "Her hands clenched into fists, nails biting into her palms."
**Why**: Showing emotion through physical detail is more immersive
**Impact**: High - Engages reader more deeply

---

### Sentence Variety Opportunities

**Issue**: Multiple consecutive sentences start with "The" or subject-verb pattern

**Original**:

> "The sun set over the horizon. I watched it disappear. I felt a sense of peace wash over me. I decided to head home."

**Enhanced**:

> "The sun set over the horizon. As I watched it disappear, peace washed over me. Time to head home."

**Why**: Varying sentence structure improves rhythm and readability

---

## Clarity Issues

### 1. Unclear Antecedent

**Original**: "Mark told Jason he needed to leave."
**Issue**: Who needs to leave? Mark or Jason? "He" is ambiguous.
**Suggested Options**:

- "Mark told Jason, 'You need to leave.'" (Jason leaves)
- "Mark told Jason, 'I need to leave.'" (Mark leaves)
- "Mark needed to leave, so he told Jason." (Mark leaves)
  **Impact**: Critical - Changes meaning of the scene

### 2. Dangling Modifier

**Original**: "Walking down the street, the trees looked beautiful."
**Issue**: Trees aren't walking; the subject is missing/misplaced.
**Corrected**: "Walking down the street, I noticed the beautiful trees."
**Impact**: Moderate - Sounds awkward but meaning usually clear from context

---

## Consistency Issues

### 1. Tense Shift

**Location**: Paragraph 3, sentences 2-4
**Issue**: Shifts from past tense to present tense mid-paragraph
**Original**:

> "She walked to the door. She opens it and sees a stranger standing there."
> **Corrected**:
> "She walked to the door. She opened it and saw a stranger standing there."
> **Note**: Unless using historical present tense intentionally, maintain past tense

### 2. Spelling Variants

**Issue**: Inconsistent spelling throughout text
**Found**: "gray" (4 times) and "grey" (2 times)
**Recommendation**: Choose one and apply consistently (American English = gray, British = grey)

---

## Word Choice Enhancements

### Imprecise → Precise

| Original       | Enhanced                                    | Why                               |
| -------------- | ------------------------------------------- | --------------------------------- |
| "very big"     | "enormous" / "massive" / "towering"         | More specific and vivid           |
| "said loudly"  | "shouted" / "yelled" / "bellowed"           | Stronger verb incorporates adverb |
| "kind of sad"  | "melancholy" / "wistful" / "dejected"       | More precise emotion              |
| "walked sadly" | "trudged" / "shuffled" / "dragged her feet" | Conveys emotion through action    |

---

## Repetition Analysis

### Overused Words

| Word       | Frequency | Recommendation                                                   |
| ---------- | --------- | ---------------------------------------------------------------- |
| "very"     | 23 times  | Reduce by 80%; replace with stronger words                       |
| "just"     | 18 times  | Often unnecessary filler; remove in most cases                   |
| "really"   | 15 times  | Adds little meaning; remove or use stronger word                 |
| "suddenly" | 12 times  | Overused in this passage; vary or show suddenness through action |

### Repetitive Sentence Starts

- "She [verb]" - 15 sentences
- "The [noun]" - 12 sentences
- "I [verb]" - 10 sentences

**Recommendation**: Vary sentence structure by starting with:

- Dependent clauses: "As the door opened, she..."
- Prepositional phrases: "With trembling hands, she..."
- Adverbs: "Slowly, she..."
- Participial phrases: "Gripping the railing, she..."

---

## Readability Metrics

**Current Statistics**:

- Average sentence length: 18 words
- Average paragraph length: 4 sentences
- Flesch Reading Ease: 72 (target: 60-70 for adult fiction)
- Flesch-Kincaid Grade Level: 8.2

**Assessment**:
Readability is good for general adult fiction. If targeting literary fiction, could increase complexity. If targeting middle grade, should simplify further.

---

## Paragraph-Level Analysis

### Sample Paragraph Review

**Original**