Skip to main content
The /write command creates complete, well-structured long-form articles optimized for SEO and reader engagement.

​
Usage

/write [topic or research brief]
​
topic
string
required
The topic to write about. Can reference a research brief or be a standalone topic.

​
Examples

/write content marketing strategies for B2B SaaS

/write podcast analytics

​
What It Does

​
Content Creation

  1. Reviews research brief from /research command if available
  2. Applies brand voice from context/brand-voice.md
  3. Studies writing examples from context/writing-examples.md
  4. Follows style guide from context/style-guide.md
  5. Integrates keywords from context/target-keywords.md
  6. Creates 2000-3000+ word article with full SEO optimization

​
Article Structure

1

Compelling Headline (H1)

  • Includes primary keyword naturally
  • Under 60 characters for SERP display
  • Promises clear value to reader
Never use generic openings like “X is…” or “When it comes to…”
2

Hook-Driven Introduction (150-200 words)

Uses the APP Formula:
  • Agree: Acknowledge what reader believes/feels
  • Promise: Tell them what they’ll learn
  • Preview: Brief overview of what’s coming
Includes primary keyword in first 100 words.
3

Comprehensive Body (1800-2500+ words)

  • 4-7 main H2 sections
  • H3 subsections for complex topics
  • 1-2% keyword density
  • 2-3 mini-stories with specific details
  • 2-3 contextual CTAs throughout
  • Data and statistics to support claims
4

Strong Conclusion (150-200 words)

  • Recaps 3-5 key takeaways
  • Provides clear next steps
  • Includes relevant CTA

​
Hook Types

The opening hook determines reader retention. Choose ONE:
Hook TypeExampleBest For
Provocative Question”What if the ‘free’ plan is costing you $500/month?”Challenging assumptions
Specific Scenario”Last Tuesday, Sarah discovered her site had been invisible to Google for three weeks.”Emotional connection
Surprising Statistic”73% of SaaS users who switch platforms do so within 18 months.”Data-driven topics
Bold Statement”Your current tool is lying to you about your numbers.”Controversial takes
Counterintuitive Claim”The cheapest option might be the most expensive decision.”Comparison content
Never open with generic definitions like “Content marketing is…” or “When it comes to SEO…”Strong hooks boost reader retention by 30%.

​
Mini-Stories Requirement

Every article MUST include 2-3 mini-stories with:
  • A specific person (use names: “Sarah,” “Mike,” “Team at Acme Corp”)
  • Concrete situation with details (dates, numbers, specifics)
  • Clear outcome that illustrates the point

​
Example Mini-Story

“When Marcus launched his SaaS product in March 2024, he chose the cheapest hosting plan he could find. 5/monthseemedlikeano−brainer.Sixmonthslater,hisapphit10,000activeusers.That′swhenhediscoveredthehiddenbandwidthfeesburiedinhisprovider′sterms.His5/month seemed like a no-brainer. Six months later, his app hit 10,000 active users. That's when he discovered the hidden bandwidth fees buried in his provider's terms. His 5/month plan suddenly became 89/month.Worse,migratingmid−growthmeanta3−weekgapinanalyticsthatcosthima89/month. Worse, migrating mid-growth meant a 3-week gap in analytics that cost him a 2,000 partnership deal. The ‘savings’ from cheap hosting cost him over $3,000.”
Placement:
  • One in introduction or early section (hook readers)
  • One in the middle (re-engage skimmers)
  • One near conclusion (reinforce main point)

​
Contextual CTAs

Embedded CTAs get 121% more conversions than end-only CTAs.
After first major value section:
Want to see how this works in practice? [Explore our features →]

​
SEO Optimization

​
Keyword Placement

Primary keyword must appear in:
  • H1 headline ✓
  • First 100 words ✓
  • At least 2-3 H2 headings ✓
  • Meta title ✓
  • Meta description ✓
  • URL slug ✓
References context/internal-links-map.md:
  • Link to pillar content
  • Link to related blog articles
  • Link to product/service pages naturally
  • Use descriptive anchor text with keywords
  • Link to authoritative sources for statistics
  • Reference industry research or studies
  • Link to tools or resources mentioned

​
Readability

  • Sentences under 25 words average
  • Transition words between sections
  • Varied sentence length for rhythm
  • 8th-10th grade reading level
  • Active voice predominantly
  • Subheadings every 300-400 words

​
Output

Creates a complete article saved to: 
drafts/[topic-slug]-[YYYY-MM-DD].md

​
File Contents

---
Meta Title: [50-60 character optimized title]
Meta Description: [150-160 character compelling description]
Primary Keyword: [main target keyword]
Secondary Keywords: [keyword1, keyword2, keyword3]
URL Slug: /blog/[optimized-slug]
Internal Links: [list of pages linked]
External Links: [list of external sources]
Word Count: [actual word count]
---

​
SEO Checklist

Automatically generated: 
## SEO Checklist

- [ ] Primary keyword in H1
- [ ] Primary keyword in first 100 words
- [ ] Primary keyword in 2+ H2 headings
- [ ] Keyword density 1-2%
- [ ] 3-5+ internal links included
- [ ] 2-3 external authority links
- [ ] Meta title 50-60 characters
- [ ] Meta description 150-160 characters
- [ ] Article 2000+ words
- [ ] Proper H2/H3 hierarchy
- [ ] Readability optimized

​
Engagement Checklist

## Engagement Checklist

- [ ] Hook: Opens with question, scenario, stat, or bold statement
- [ ] APP Formula: Introduction includes Agree, Promise, Preview
- [ ] Mini-stories: 2-3 specific scenarios with names and details
- [ ] Contextual CTAs: 2-3 CTAs throughout (not just at end)
- [ ] First CTA: Appears within first 500 words
- [ ] Paragraph length: No paragraphs exceed 4 sentences
- [ ] Sentence rhythm: Mix of short and longer sentences

​
Automatic Post-Processing

After saving the article, these processes run automatically:

​
1. Content Scrubbing

1

Removes AI Watermarks

  • Invisible Unicode characters
  • Zero-width spaces
  • Format-control characters
2

Cleans AI Patterns

  • Em-dash overuse
  • Robotic phrasing
  • Whitespace normalization

​
2. Quality Scoring

Automatic scoring across 5 dimensions:
DimensionWeightTarget
Humanity/Voice30%No AI phrases, use contractions
Specificity25%Concrete examples, numbers, names
Structure Balance20%40-70% prose (not all lists)
SEO Compliance15%Keywords, meta, structure
Readability10%Flesch 60-70, grade 8-10
Composite score must be ≥70Articles scoring less than 70 go to review-required/ with detailed notes.

​
3. Agent Auto-Execution

These agents run automatically:

Content Analyzer

Search intent, keyword density, length comparison, readability, SEO quality (0-100)

SEO Optimizer

On-page SEO analysis and recommendations

Meta Creator

5 meta title/description variations

Internal Linker

3-5 specific internal link suggestions

Keyword Mapper

Keyword placement and density analysis
Agent reports are saved to drafts/ with corresponding filenames.

​
Quality Standards

Every article must meet:
  • Minimum 2000 words (2500-3000+ preferred)
  • Proper H1/H2/H3 hierarchy
  • Primary keyword naturally integrated
  • 3-5 internal links
  • 2-3 external authoritative links
  • Compelling meta title and description
  • Clear introduction and conclusion
  • Brand voice maintained
  • Compelling hook (no generic openings)
  • 2-3 mini-stories with specific names and details
  • 2-3 contextual CTAs distributed throughout
  • First CTA within 500 words
  • No paragraphs longer than 4 sentences
  • Varied sentence rhythm
  • Composite quality score ≥70
  • Humanity/Voice: Remove AI patterns
  • Specificity: Include concrete examples
  • Structure: Balance prose and lists
  • SEO: Meet all optimization requirements
  • Readability: 8th-10th grade level

​
Next Steps

After article creation:
  1. Review agent reports - Read all optimization suggestions
  2. Make improvements - Address high-priority issues
  3. Run optimize - Use /optimize for final polish
/optimize drafts/[article-name]-2025-03-04.md

​
Tips

Research First

Always run /research before /write for best results.

Strong Hooks

Avoid generic openings. Start with a question, scenario, or surprising stat.

Specific Examples

Use names, dates, and numbers in mini-stories for credibility.

Natural Keywords

Integrate keywords naturally. If it sounds forced, rewrite.

/research

Run research before writing

/optimize

Final optimization pass

Build docs developers (and LLMs) love

Get started for freeTalk to us