grammar-checker

Analyze text for grammar, spelling, punctuation, and style issues. Execute Python script to perform detailed analysis. Use when checking grammar or proofreading.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️4downloads

When & Why to Use This Skill

This Claude skill provides a comprehensive automated editing and proofreading solution designed to enhance writing quality. It leverages a specialized Python-based analysis engine to detect complex grammar issues, spelling errors, punctuation mistakes, and stylistic inconsistencies. By providing structured feedback categorized by severity, it helps users transform raw drafts into polished, professional, and error-free content.

Use Cases

  • Professional Correspondence: Use it to proofread important business emails, proposals, and reports to ensure a flawless professional image.
  • Academic Paper Refinement: Analyze research papers and essays for subject-verb agreement, verb tense consistency, and academic tone.
  • Content Marketing Polish: Identify and fix passive voice, wordiness, and awkward phrasing in blog posts and marketing copy to improve readability and engagement.
  • Technical Documentation Review: Ensure technical manuals and guides are clear, concise, and free of grammatical ambiguities that could lead to user confusion.
  • Language Learning Support: Provide educational feedback to non-native speakers by explaining the reasoning behind specific linguistic corrections.
namegrammar-checker
descriptionAnalyze text for grammar, spelling, punctuation, and style issues. Execute Python script to perform detailed analysis. Use when checking grammar or proofreading.

Grammar Checker

I analyze text for language correctness and provide detailed corrections.

How to Use This Skill

When analyzing text, execute the grammar checker script:

python /home/ywatanabe/dev/agent-patterns/.claude/skills/grammar-checker/run.py "text to analyze"

The script returns JSON results with detailed issue analysis.

What I Check

Grammar Issues

  • Subject-verb agreement
  • Verb tense consistency
  • Pronoun agreement and clarity
  • Sentence fragments and run-ons
  • Misplaced modifiers

Spelling & Punctuation

  • Spelling errors (including commonly confused words)
  • Punctuation mistakes (commas, semicolons, apostrophes)
  • Capitalization errors
  • Hyphenation issues

Style & Clarity

  • Passive voice overuse
  • Wordiness and redundancy
  • Unclear antecedents
  • Awkward phrasing
  • Inconsistent tone

When This Skill Activates

Activate when user requests:

  • "Check grammar"
  • "Fix spelling and punctuation"
  • "Proofread this text"
  • "Find language errors"
  • Any request about correctness of writing

Analysis Process

  1. Scan Text: Identify all grammar/spelling/punctuation issues
  2. Categorize: Group issues by type and severity
  3. Provide Corrections: Suggest specific fixes
  4. Explain: Brief explanation for each correction
  5. Prioritize: Mark critical vs. minor issues

Output Format

Provide structured grammar report:

Critical Issues (must fix):

  • Issue description
  • Location in text
  • Correction
  • Explanation

Minor Issues (should fix):

  • Issue description
  • Suggested improvement
  • Reasoning

Style Suggestions (consider):

  • Observation
  • Alternative phrasing
  • Impact on clarity

Example Analysis

Input: "The team are working on there project and its going good."

Output:

Critical Issues:
1. Subject-verb agreement: "team are" → "team is"
   - Collective nouns take singular verbs

2. Wrong homophone: "there project" → "their project"
   - "There" (location) vs. "their" (possession)

3. Missing apostrophe: "its going" → "it's going"
   - Contraction of "it is"

Style Suggestions:
1. Informal tone: "going good" → "progressing well"
   - More professional phrasing

Tone

  • Clear and educational
  • Non-judgmental
  • Helpful explanations
  • Prioritize actionable feedback