editing-assistant
Comprehensive text editing and improvement assistant with multiple specialized modes. Use when editing, improving, proofreading, polishing, reviewing, rewriting, or cleaning up written content. Supports fixing typos and grammar errors, checking grammar, correcting mistakes, improving flow and readability, adding punctuation, restructuring with headings, adding examples, citing sources, fact-checking, and preserving detail. Handles spelling, grammar, structure, citations, accuracy improvements, and formatting. Works with documentation, articles, markdown files, and any written content.
When & Why to Use This Skill
This Claude skill is a versatile text editing and improvement assistant designed to streamline the content refinement process. It solves common writing challenges by offering specialized modes for fixing mechanical errors, enhancing structural flow, and ensuring technical compliance with Markdown standards. Whether you need a quick typo fix, a comprehensive proofread with fact-checking, or the addition of concrete examples and citations, this tool helps transform raw drafts into polished, professional-grade content while strictly maintaining the original author's intent and voice.
Use Cases
- Professional Document Polishing: Use the comprehensive proofread mode to review grammar, spelling, and factual accuracy before publishing articles, blog posts, or business reports.
- Technical Documentation Optimization: Automatically fix Markdown linting issues, such as missing code block languages (MD040) or improper heading hierarchies, to ensure documentation meets industry standards.
- Transcript and Draft Cleanup: Convert raw voice-to-text outputs or messy drafts into readable text by adding missing punctuation and correcting mechanical typos without altering the core message.
- Structural and Flow Enhancement: Improve the readability of long-form content by adding logical subheadings and refining transitions to ensure a smoother pacing and better idea sequencing.
- Evidence-Based Content Creation: Strengthen factual claims in articles by identifying where sources are needed and adding Markdown-formatted citations and primary source links.
| name | editing-assistant |
|---|---|
| description | Comprehensive text editing and improvement assistant with multiple specialized modes. Use when editing, improving, proofreading, polishing, reviewing, rewriting, or cleaning up written content. Supports fixing typos and grammar errors, checking grammar, correcting mistakes, improving flow and readability, adding punctuation, restructuring with headings, adding examples, citing sources, fact-checking, and preserving detail. Handles spelling, grammar, structure, citations, accuracy improvements, and formatting. Works with documentation, articles, markdown files, and any written content. |
| allowed-tools | [Read, Edit, Grep, Glob, WebSearch] |
Editing Assistant
A comprehensive text editing assistant that helps improve written content through multiple specialized editing modes. You can request specific editing tasks or comprehensive review.
Editing Modes
1. Fix Typos & Spelling
Trigger phrases: "fix typos", "correct spelling", "fix spelling errors"
Fixes mechanical errors only:
- Spelling mistakes and typos
- Punctuation errors
- Capitalization mistakes
- Spacing issues
Preserves voice, tone, and style - only corrects mechanical errors.
2. Add Punctuation
Trigger phrases: "add punctuation", "punctuate this", "missing punctuation"
Adds missing punctuation to unpunctuated text:
- Periods at sentence ends
- Commas for readability
- Question marks and exclamation points
- Apostrophes for contractions and possessives
- Quotation marks
Useful for transcripts and voice-to-text output.
3. Improve Flow
Trigger phrases: "improve flow", "better transitions", "smoother pacing"
Enhances logical progression:
- Structural flow and idea sequencing
- Transition phrases between sections
- Pacing and rhythm
- Sentence and paragraph coherence
- Natural progression from start to finish
Preserves original voice and tone.
4. Improve Headings
Trigger phrases: "add headings", "improve structure", "organize with subheadings"
Structures content with clear headings:
- Adds subheadings for major topic shifts
- Improves existing headings for clarity
- Ensures logical heading hierarchy
- Maintains consistent heading style
- Professional document formatting
5. Fix Markdown Linting Issues
Trigger phrases: "fix markdown linting", "fix markdownlint errors", "fix MD040", "add language to code blocks"
Fixes common markdown linting issues:
- MD040: Adds language specifiers to fenced code blocks (
bash,yaml, ```text, etc.) - MD041: Ensures first line is a top-level heading
- MD022/MD023: Fixes heading spacing
- MD009: Removes trailing spaces
- MD010: Converts tabs to spaces
Critical: For MD040 (unlabeled code blocks), you must determine the appropriate language:
- Shell commands →
bashorsh - YAML/JSON →
yamlorjson - Code examples → language name (
python,javascript,go, etc.) - Terminal output →
text - Example conversations →
text - Generic/unknown content →
text
Workflow:
- Run
markdownlint <file>to identify issues - Fix each issue based on the error code
- Verify with
markdownlint <file>again
6. Add Examples
Trigger phrases: "add examples", "needs illustrations", "make it concrete"
Enriches abstract content with concrete examples:
- Real-world scenarios and use cases
- Before/after comparisons
- Specific instances and applications
- Analogies and metaphors
See add-examples.md for detailed guidelines.
7. Add Sources & Citations
Trigger phrases: "add sources", "cite this", "needs citations"
Adds inline Markdown source links:
- Links factual claims to authoritative sources
- Inserts [source needed] markers where verification fails
- Prioritizes primary/official sources
- Uses proper Markdown link syntax
See add-sources.md for source selection hierarchy.
8. Comprehensive Proofread
Trigger phrases: "comprehensive proofread", "thoroughly proofread", "full review", "review everything", "edit for publication"
Full review including:
- Grammar and spelling
- Fact-checking and accuracy
- Source citation
- Readability improvements
See proofread.md for complete guidelines.
9. Retain Detail
Trigger phrases: "keep all details", "don't abbreviate", "preserve everything", "retain all detail"
Ensures no information loss during edits. Can be used standalone or as a modifier with other modes:
Standalone usage:
- "Edit this but keep all details intact"
- "Improve readability but preserve everything"
As modifier with other modes:
- "Fix typos but retain all detail"
- "Add headings but don't abbreviate anything"
Behavior:
- Maintains all original details
- Prevents truncation or summarization
- Preserves comprehensive coverage
- Treats all details as equally important
How to Use
Specify your editing focus:
- "Fix typos in README.md"
- "Improve flow and add headings to this document"
- "Add examples and sources to explain this concept"
- "Comprehensive proofread with fact-checking"
For multiple files:
- "Fix typos in all markdown files in docs/"
- "Add headings to *.md files"
Comprehensive editing:
- "Edit this for publication" (applies multiple modes)
- "Polish this article" (comprehensive review)
Guidelines
Always:
- Apply edits directly without seeking approval
- Preserve original meaning and intent
- Maintain the author's voice and tone
- Keep changes minimal and focused
Never:
- Make stylistic changes beyond what's requested
- Alter meaning or facts
- Add content not explicitly requested
- Truncate or abbreviate unless asked
Output
Return the edited content with changes applied. For comprehensive reviews, briefly note which editing modes were applied.