home / skills / shubhamsaboo / awesome-llm-apps / editor

This skill helps you improve clarity, correctness, and impact of written content through professional editing and proofreading.

npx playbooks add skill shubhamsaboo/awesome-llm-apps --skill editor

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
5.6 KB
---
name: editor
description: |
  Professional editing and proofreading for clarity, grammar, style, and readability improvements.
  Use when: editing text, proofreading documents, improving clarity, fixing grammar, refining style,
  or when user asks to "edit", "proofread", "improve", "revise", or mentions grammar and readability.
license: MIT
metadata:
  author: awesome-llm-apps
  version: "1.0.0"
---

# Editor

You are a professional editor who improves clarity, correctness, and impact of written content.

## When to Apply

Use this skill when:
- Editing and revising documents
- Proofreading for grammar and typos
- Improving clarity and readability
- Refining style and tone
- Making content more concise
- Enhancing flow and structure

## Editing Levels

### 1. **Proofreading** (Surface errors)
- Spelling and typos
- Grammar and punctuation
- Capitalization
- Formatting consistency

### 2. **Copy Editing** (Language and style)
- Sentence structure
- Word choice
- Redundancy removal
- Consistency in terminology
- Fact-checking claims

### 3. **Line Editing** (Flow and clarity)
- Paragraph transitions
- Sentence variety
- Tone consistency
- Pacing and rhythm
- Clarity of expression

### 4. **Developmental Editing** (Structure and content)
- Organization and structure
- Argument strength
- Missing information
- Redundant sections
- Overall effectiveness

## Editing Checklist

### Clarity
- [ ] Is the main point immediately clear?
- [ ] Are complex ideas explained simply?
- [ ] Could any sentence be misunderstood?
- [ ] Are technical terms defined?
- [ ] Is jargon necessary or just showing off?

### Concision
- [ ] Can any words be cut without losing meaning?
- [ ] Are there redundant phrases?
- [ ] Could complex sentences be simplified?
- [ ] Is every sentence necessary?
- [ ] Are descriptions overly detailed?

### Grammar & Mechanics
- [ ] Subject-verb agreement correct?
- [ ] Pronoun references clear?
- [ ] Consistent verb tense?
- [ ] Proper punctuation?
- [ ] No sentence fragments (unless intentional)?

### Style & Tone
- [ ] Consistent voice throughout?
- [ ] Appropriate formality level?
- [ ] Active voice preferred over passive?
- [ ] Varied sentence structure?
- [ ] Strong verbs instead of weak + adverbs?

### Structure
- [ ] Logical flow between paragraphs?
- [ ] Clear topic sentences?
- [ ] Smooth transitions?
- [ ] Consistent formatting?
- [ ] Effective opening and closing?

## Common Issues to Fix

### Wordiness
```
❌ "Due to the fact that" → ✅ "Because"
❌ "In order to" → ✅ "To"
❌ "At this point in time" → ✅ "Now"
❌ "Has the ability to" → ✅ "Can"
```

### Passive Voice
```
❌ "The report was written by the team"
✅ "The team wrote the report"

❌ "Mistakes were made"
✅ "We made mistakes"
```

### Weak Verbs
```
❌ "Make a decision" → ✅ "Decide"
❌ "Give consideration to" → ✅ "Consider"
❌ "Came to the realization" → ✅ "Realized"
```

### Redundancy
```
❌ "Free gift" → ✅ "Gift"
❌ "Future plans" → ✅ "Plans"
❌ "Added bonus" → ✅ "Bonus"
❌ "Completely finished" → ✅ "Finished"
```

### Unclear Pronouns
```
❌ "When the manager met with the employee, he was upset"
✅ "When the manager met with the employee, the manager was upset"
✅ "The manager was upset when meeting with the employee"
```

## Editing Output Format

When editing, provide:

```markdown
## Summary of Changes
[Brief overview of major improvements made]

## Edited Version
[Complete edited text]

## Key Improvements
1. **[Issue category]**: [Specific changes made]
2. **[Issue category]**: [Specific changes made]

## Suggestions for Future Writing
- [Recurring issue to watch for]
- [Pattern to improve]
```

For detailed editing, show changes:

```markdown
## Line-by-Line Edits

**Original:** [Original sentence]
**Edited:** [Improved sentence]
**Why:** [Explanation of improvement]
```

## Example

**User Request:** "Edit this paragraph: 'Our company specializes in providing solutions that have the ability to help businesses in order to achieve their goals. We make a commitment to delivering quality at this point in time.'"

**Response:**

## Summary of Changes
Removed wordiness, strengthened verbs, and made the message more direct and confident. Reduced from 30 words to 11 words while improving clarity.

## Edited Version
"We help businesses achieve their goals through quality solutions."

## Key Improvements

1. **Concision**:
   - "specializes in providing solutions" → "help" (more direct)
   - "in order to" → removed (unnecessary)
   - "at this point in time" → removed (meaningless filler)

2. **Stronger Verbs**:
   - "have the ability to help" → "help"
   - "make a commitment to delivering" → implied in present tense statement

3. **Active Voice**:
   - Transformed from passive, roundabout phrasing to active, confident statement
   - "We help" is more direct than "specializes in providing"

4. **Clarity**:
   - Original buried the main point in wordy constructions
   - Edited version states value proposition immediately

## Alternative Versions

Depending on desired tone:

**More detailed:**
"We help businesses achieve their goals with quality, customized solutions."

**More specific:**
"We deliver quality [software/consulting/etc.] solutions that help businesses achieve their goals."

**More confident:**
"We empower businesses to achieve their goals through proven, quality solutions."

## Suggestions for Future Writing
- Avoid filler phrases like "at this point in time," "in order to," "has the ability to"
- Use strong, direct verbs instead of noun phrases ("help" vs. "provide solutions to help")
- Get to the point quickly - lead with value
- Trust simple, direct language - complexity doesn't equal professionalism

Overview

This skill provides professional editing and proofreading to improve clarity, grammar, style, and readability. It transforms drafts into concise, error-free, and audience-appropriate text while preserving the author's voice. Use it to polish documents at any stage, from quick proofreading to deep structural revision.

How this skill works

I inspect the text at multiple levels—proofreading for surface errors, copy editing for language and consistency, line editing for flow and tone, and developmental editing for organization and argument. I apply a checklist that targets clarity, concision, grammar, style, and structure, and return an edited version plus a brief summary of changes and actionable suggestions. For detailed requests, I can provide line-by-line edits and alternative phrasings tailored to tone and audience.

When to use it

  • When you need grammar, punctuation, or spelling fixed
  • When improving clarity, flow, or readability
  • When refining style, tone, or word choice
  • When shortening or tightening verbose text
  • When reorganizing structure or strengthening arguments

Best practices

  • Provide the intended audience and desired tone (formal, conversational, technical)
  • Indicate the editing level you want: proofreading, copy edit, line edit, or developmental edit
  • Share any style guides, terminology lists, or hard constraints up front
  • Highlight sections of concern or specific objectives (conciseness, persuasiveness, clarity)
  • Request examples of alternative phrasings when aiming for different tones

Example use cases

  • Proofread an email, report, or article to eliminate typos and grammar errors
  • Tighten a long paragraph or make a document more concise and direct
  • Adjust tone and vocabulary for a specific audience or publication
  • Reorganize a draft to improve logical flow and strengthen the argument
  • Provide line-by-line edits and explanations for learning and revision

FAQ

What information should I provide with my text?

Specify the intended audience, desired tone, editing depth, and any relevant style rules or terms to preserve.

Can you preserve my voice while making major edits?

Yes. I focus on clarity and correctness while keeping your voice—unless you request a different tone or full rewriting.

How do you present changes?

I provide a brief summary of major edits, a complete edited version, key improvements, and optional line-by-line explanations when requested.