Skip to main content
The Editor agent transforms well-researched, SEO-optimized content into compelling, personality-driven articles that sound human—not AI-generated.

​
What It Fixes

The Editor identifies and fixes common AI content problems:
  • Generic sentences that could apply to any topic
  • Lack of specific examples with concrete details
  • Robotic transitions and formulaic structure
  • Missing personality and human perspective
  • Corporate speak and buzzwords
  • Passive voice dominance
  • Weak conclusions that just summarize

​
The Problem It Solves

AI-generated content often suffers from: Robotic patterns:
  • “In today’s digital landscape…”
  • “When it comes to…”
  • “It’s important to note that…”
  • “Furthermore, moreover, additionally…”
Vague generalizations:
  • “Many businesses struggle with growth”
  • “Recently, trends have shown…”
  • “This is important for success”
Missing humanity:
  • No personality or point of view
  • No real-world examples with names/dates
  • No humor or unexpected perspectives
  • Reads like a textbook, not a conversation

​
Analysis Framework

​
1. Humanity Check

Red Flags (what to fix):
  • Generic openings (“In the world of…”, “When it comes to…”)
  • Overuse of transition words (“Furthermore”, “Moreover”)
  • Formulaic structures (every section starts same way)
  • Lack of contractions (“do not” vs “don’t”)
  • Passive voice dominance
  • Abstract concepts without concrete examples
  • Corporate speak (“leverage”, “utilize”, “synergy”)
  • Hedging language (“may”, “might”, “could potentially”)
Green Flags (what to add more of):
  • Specific, vivid examples from real scenarios
  • Conversational asides and parentheticals
  • Varied sentence structure and rhythm
  • Personal observations or insights
  • Humor, personality, or unexpected perspectives
  • Direct address (“you’ve probably noticed…”)
  • Strong opinions or clear stances
  • Stories, analogies, and metaphors

​
2. Readability Analysis

Sentence Level:
  • Average sentence length (target: 15-20 words)
  • Sentence variety (mix short punchy with longer flowing)
  • Active vs passive voice (aim for 80%+ active)
  • Mix of simple and complex sentences
Paragraph Level:
  • Paragraph length (2-4 sentences ideal)
  • Opening sentence strength (hooks or bores?)
  • Logical flow between sentences
  • One clear idea per paragraph
Section Level:
  • Section openings (compelling or formulaic?)
  • Transitions between sections (smooth or clunky?)
  • Balance of explanation, example, application
  • Pacing (drags or rushes?)

​
3. Specificity & Examples

Quality Spectrum: ❌ Vague: “Many businesses struggle with growth.” ⚠️ Generic: “Companies often find it difficult to acquire customers.” ✅ Specific: “When Sarah launched her SaaS product, she spent six months stuck at 200 signups per month.” ⭐ Compelling: “When Sarah launched her SaaS product in March 2023, she spent six months stuck at 200 signups per month, until she discovered her landing page was invisible to search engines because she was using a framework that buried content behind client-side rendering.”

​
4. Engagement & Flow

Opening Analysis:
  • First sentence: Grabs attention or wastes it?
  • First paragraph: Promises clear value?
  • Makes you want to keep reading?
Hook Types (use instead of generic definitions):
  • Provocative question
  • Specific scenario with name/details
  • Surprising statistic
  • Bold/counterintuitive statement
  • NOT “X is…” definitions
  • NOT “When it comes to…” / “In the world of…”
Body Flow:
  • Sections connect logically?
  • Transitions smooth and natural?
  • Article builds momentum?
  • Any “boring valleys” needing punch-up?
Required Elements:
  • Mini-Stories: 2-3 specific scenarios with names, dates, outcomes
  • Early CTA: Within first 500 words
  • Contextual CTAs: 2-3 throughout (not just at end)
  • Short paragraphs: None longer than 4 sentences
  • Sentence rhythm: Mix short (5-10 words) with longer (15-25 words)
Conclusion Analysis:
  • Adds new value or just summarizes?
  • Clear, specific next action?
  • Ends with energy or peters out?

​
Editing Principles

​
1. Show, Don’t Tell

❌ Before: “Analytics are important for growth.” ✅ After: “Last month, Mike discovered his completion rate dropped to 40% after the 10-minute mark. He cut his content from 45 minutes to 25 minutes. Engagement jumped 30% within a month.”

​
2. Inject Personality

❌ Before: “It’s important to consider your target audience when creating content.” ✅ After: “Here’s the thing about content marketing: You can’t please everyone. (And if you try, you’ll end up pleasing no one.)“

​
3. Kill Corporate Speak

Replace these:
  • “Leverage” → “Use”
  • “Utilize” → “Use”
  • “In order to” → “To”
  • “Due to the fact that” → “Because”
  • “It should be noted that” → Delete entirely
  • “Going forward” → “Next” or delete
  • “At the end of the day” → “Ultimately” or delete

​
4. Add Specific Details

Generic → Specific:
  • “Recently” → “In March 2024” or “Last Tuesday”
  • “Many businesses” → “73% of SaaS companies” or “12 of 15 companies I surveyed”
  • “Popular tool” → “HubSpot” or “Ahrefs”
  • “Good software” → “Specific product name ($99/mo)”
  • “Significant increase” → “Doubled from 500 to 1,000 signups/month”

​
5. Vary Sentence Structure

❌ Monotonous: “You need to research keywords. You should analyze competitors. You must write quality content. You can’t skip optimization.” ✅ Varied: “Start with keyword research. Then dive into competitor analysis—what are they doing right? (More importantly, what are they missing?) Write quality content that fills those gaps. Skip optimization at your peril.”

​
6. Use Conversational Devices

Devices that add humanity:
  • Parenthetical asides: “(Trust me on this one.)”
  • Rhetorical questions: “Sound familiar?”
  • Direct address: “You’ve probably noticed…”
  • Fragments for emphasis: “No exceptions.”
  • Contractions: “don’t”, “you’re”, “it’s”
  • Casual connectors: “Look”, “Here’s the thing”, “The truth is”

​
7. Make Lists Actionable

❌ Generic List:
  • Keyword research
  • Content creation
  • SEO optimization
  • Performance tracking
✅ Actionable List:
  • Keyword research: Open Ahrefs and find 5 keywords ranking 11-20 (these are your quick wins)
  • Content creation: Write 2,500+ words. Don’t pad it—make every word count.
  • SEO optimization: Check your meta description. If it doesn’t make you want to click, rewrite it.
  • Performance tracking: Set a Google Analytics alert for pages that drop 20%+ in traffic

​
Output Format

### Editorial Report

Article Title: "How to Grow Your Podcast Audience"

Overall Assessment:
- Humanity Score: 58/100
  - Voice & Personality: 12/25 (robotic, no personality)
  - Specificity & Examples: 10/25 (too many generalizations)
  - Readability & Flow: 18/25 (decent flow, passive voice issues)
  - Engagement: 18/25 (weak opening, no mini-stories)

Primary Issues:
1. Generic opening paragraph with AI phrase ("In today's digital landscape")
2. Lacks specific examples with names, dates, numbers
3. No personality or point of view throughout
4. 45% passive voice (target: <20%)
5. No mini-stories or concrete scenarios

### Critical Edits (Must Fix)

#### 1. Opening Paragraph

Current:
In today’s digital landscape, growing your podcast audience is essential for success. Many podcasters struggle with this challenge. It’s important to understand the strategies that work. 

Why It Fails: Generic AI opener, no hook, vague claims, passive construction

Rewritten:
Mike spent eight months publishing weekly episodes to the same 200 listeners. Then he changed three things. Six months later, he hit 5,000 downloads per episode. Here’s what actually works for podcast audience growth—based on data from 50+ podcasters who’ve done it. 

Why This Works: Specific person, specific numbers, specific timeframe,
implies proven tactics, creates curiosity

#### 2. Section 3 - Promotion Tactics

Current:
Promotion is important for growing your podcast. Social media can be leveraged to increase visibility. It’s recommended to utilize multiple platforms for maximum reach. Consistency should be maintained. 

Issues: Passive voice, corporate speak ("leverage", "utilize"),
vague advice, no specifics

Rewritten:
Promotion separates growing podcasts from stagnant ones. But here’s what most people get wrong: They post everywhere and wonder why nothing works. Pick two platforms where your target listeners actually spend time. (For B2B podcasters? LinkedIn and Twitter. For hobbyists? Reddit and niche Facebook groups.) Post 3x per week minimum. Miss a week, and you’re invisible. 

Changes Made: Active voice, specific platform examples, actionable
frequency, conversational tone, parenthetical aside, strong stance

[Continue with 5-10 critical edits...]

### Suggested Improvements

1. **Add Mini-Story in Section 2**
   - Where: After "Content quality matters" paragraph
   - Add: "Take Sarah's podcast on productivity. She published
     generic tips for six months—50 downloads per episode. Then she
     interviewed her friend about a specific system that saved him
     10 hours per week. That episode? 800 downloads in the first week.
     People don't want tips. They want specific, proven systems."
   - Why: Transforms abstract "quality" into concrete example with numbers

2. **Inject Personality in Section 4**
   - Current Tone: Flat, instructional, academic
   - Suggested Approach: Add opinion, challenge conventional wisdom
   - Example: "Everyone says 'be consistent.' (Yawn.) But consistent
     mediocrity won't grow your audience. Better to publish one
     outstanding episode per month than four forgettable ones per week."

3. **Improve Section Transition**
   - Between: "Content Strategy" and "Promotion Tactics"
   - Current: "Furthermore, promotion is also important for growth."
   - Better: "Great content in a vacuum gets you nowhere. Time to talk
     promotion."

### Pattern Analysis

Recurring Issues:
1. Passive voice appears in 18 locations
   - Sections: 1, 2, 3, 5, 6, conclusion
   - Fix: Convert to active voice, name actors
   - Example: "Mistakes should be avoided" → "Avoid these mistakes"

2. Generic transition words ("Furthermore", "Moreover", "Additionally")
   - Appears: 7 times throughout
   - Fix: Delete or replace with conversational connectors
   - "Furthermore" → "Here's the thing" or just delete

3. Vague quantifiers ("many", "often", "significant")
   - Appears: 12 times
   - Fix: Replace with specific numbers or examples
   - "Many podcasters" → "73% of podcasters we surveyed"

Strengths to Preserve:
- Structure is solid (clear H2 sections)
- Length is competitive (2,100 words)
- Keyword optimization already done
- Lists are well-formatted

### Before/After Samples

Sample 1: Generic → Specific

Before:
"Content monetization requires multiple strategies and consistent
effort over time."

After:
"Mike spent eight months growing his blog to 5,000 visitors per month
before landing his first sponsor, a $500 deal with a SaaS company. Not
life-changing money, but proof that monetization was possible. Six
months later, he was making $2,500 per month from three sponsors."

---

Sample 2: Robotic → Human

Before:
"When it comes to content growth, it's important to note that
consistency is key. Furthermore, content quality matters significantly.
Additionally, audience engagement should not be overlooked."

After:
"Want to grow your audience? Show up consistently. (Shocking advice,
I know.) But here's what most people miss: Consistency without quality
gets you nowhere. And quality without engagement? You're just talking
to yourself."

---

Sample 3: Vague → Actionable

Before:
"You should optimize your content for SEO to improve discoverability."

After:
"Open Google Search Console right now. Look at your top 20 queries.
If any rank positions 11-20, those are your quick wins. Write a better
article targeting that exact query. Takes an afternoon."

### Readability Metrics

Before Editing:
- Average sentence length: 22 words (target: 15-20)
- Passive voice: 45% (target: <20%)
- Flesch Reading Ease: 52 (target: 60-70)
- Grade level: 12.5 (target: 8-10)
- Paragraph length: 5.2 sentences (target: 2-4)

After Editing (projected):
- Average sentence length: 17 words ✓
- Passive voice: 15% ✓
- Flesch Reading Ease: 65 ✓
- Grade level: 9.2 ✓
- Paragraph length: 3.1 sentences ✓

### Final Recommendations

Priority 1 (must do):
1. Rewrite opening paragraph (eliminate AI phrase, add hook)
2. Convert all passive voice to active (18 instances)
3. Add 2-3 mini-stories with specific names/numbers/dates
4. Break paragraphs longer than 4 sentences (8 paragraphs)

Priority 2 (should do):
1. Replace generic quantifiers with specific numbers (12 instances)
2. Add personality and point of view (conversational devices)
3. Make lists more actionable (add specifics to each bullet)
4. Strengthen conclusion with specific next action

Priority 3 (nice to have):
1. Add parenthetical asides for personality (2-3)
2. Include rhetorical questions (3-4)
3. Add one counterintuitive statement or strong opinion
4. Vary sentence length more (add short punchy sentences)

### Engagement Requirements Check

- [ ] Compelling hook (not generic definition)
- [ ] Mini-stories (need 2-3 with names/dates/numbers)
- [ ] CTA within first 500 words
- [ ] Contextual CTAs throughout (2-3 total)
- [ ] No paragraphs over 4 sentences
- [ ] Sentence rhythm variety (mix short and long)
- [ ] Active voice dominant (>80%)
- [ ] Specific examples with concrete details
- [ ] Personality and point of view
- [ ] Strong conclusion with specific next step

​
Structured Scoring Output

For automated quality loops, the agent includes JSON scoring: 
{
  "scores": {
    "humanity": 58,
    "specificity": 45,
    "structure_balance": 62,
    "seo": 88,
    "readability": 55
  },
  "composite": 59,
  "passed": false,
  "prose_ratio": 0.35,
  "priority_fixes": [
    {
      "location": "Introduction",
      "dimension": "humanity",
      "issue": "Generic opening with AI phrase 'In today's digital landscape'",
      "fix": "Replace with specific scenario: person, numbers, timeframe",
      "severity": "high"
    },
    {
      "location": "Throughout",
      "dimension": "specificity",
      "issue": "Vague quantifiers: 'many' (5x), 'often' (4x), 'significant' (3x)",
      "fix": "Replace with numbers: '73%', 'in March 2024', 'doubled from 500 to 1,000'",
      "severity": "medium"
    },
    {
      "location": "Sections 2, 3, 5",
      "dimension": "humanity",
      "issue": "Passive voice: 18 instances (45% of sentences)",
      "fix": "Convert to active voice with specific actors",
      "severity": "high"
    }
  ]
}
Pass threshold: Composite score ≥ 70 Scoring dimensions:
  • humanity (30%): AI phrases, passive voice, contractions, conversational devices
  • specificity (25%): Concrete examples, numbers, names vs vague words
  • structure_balance (20%): Prose ratio (40-70%), not too many lists
  • seo (15%): Keyword placement, meta elements, heading structure
  • readability (10%): Flesch score, sentence variety, grade level

​
When It Runs

The Editor can run:
  • Manually: Invoke with @editor agent
  • In automated loops: Part of quality assurance pipeline
  • On request: After /write or /optimize commands
Note: Does not run automatically by default (SEO optimization runs first)

​
Quality Standards

Every edit must:
  1. Preserve SEO Value: Don’t remove keywords or break optimization
  2. Maintain Accuracy: No changes to facts, data, or technical details
  3. Enhance Readability: Make it easier to read
  4. Add Personality: Inject humanity without being unprofessional
  5. Stay On Brand: Maintain voice from context/brand-voice.md
  6. Be Specific: Replace vague with concrete wherever possible
  7. Respect Structure: Keep H1/H2/H3 hierarchy intact

​
Best Practices

Specific beats generic every time: “73%” beats “most”, “Tuesday” beats “recently” Show real humans: Use names, scenarios, concrete examples Vary rhythm: Mix short sentences. With longer, flowing ones that provide detail. Cut ruthlessly: If it doesn’t add value, delete it End strong: Never let an article peter out—finish with energy Personality is professional: Being human doesn’t mean being unprofessional

​
Next Steps

SEO Optimizer

On-page SEO analysis

Content Analyzer

Data-driven quality scoring

Keyword Mapper

Keyword distribution analysis

Meta Creator

High-performing meta elements

Build docs developers (and LLMs) love

Get started for freeTalk to us