grammar-checker
Analyze text for grammar, spelling, punctuation, and style issues. Execute Python script to perform detailed analysis. Use when checking grammar or proofreading.
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.
| name | grammar-checker |
|---|---|
| description | Analyze 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
- Scan Text: Identify all grammar/spelling/punctuation issues
- Categorize: Group issues by type and severity
- Provide Corrections: Suggest specific fixes
- Explain: Brief explanation for each correction
- 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