Smart Writer - User Guide

Write high-quality articles in 3 simple steps with best practices

Agility Writer

Last Update ۱۶ روز پیش

Why We Built Smart Writer
We Heard You: Too Many Options
Let's be honest - over time, we added a LOT of features to Agility Writer. Advanced Mode, Optimize Mode, Product Roundup writer, Website Page writer, YouTube to Article, and a dozen settings. Each feature solved a real need, but we created a new problem: too many choices.


New users would see our menu and think: "Where do I even start? Which mode should I use? What's the difference?"


We heard this feedback constantly:


  • "I love the tool, but there are too many options"
  • "I just want to write a good article without becoming an expert"
  • "Which settings actually matter?"
Our Solution: Best Practices Built In
Smart Writer doesn't replace our other modes - it sits alongside them. The difference is: we've pre-configured everything based on what we've learned from thousands of successful articles.


Instead of showing you 30+ settings and letting you figure it out, Smart Writer narrows it down to 3 simple steps. You make 2-3 key decisions, and we handle the rest with intelligent defaults.


Think of it as the "recommended settings" path - the settings our most successful users typically choose anyway, now available with zero configuration.
Who Is This For?
  • New Users: Get started immediately without learning 15 different settings first
  • Agencies: Produce consistent articles quickly - same quality, less setup time
  • Local Businesses: Create service pages without needing to understand technical options
  • Anyone Who Just Wants to Write: Skip the configuration and focus on your content
What About the existing Writing Modes?
Nothing changes for power users. If you prefer Advanced/Optimize Mode and want to tweak every setting manually, it's still there - exactly as before. 


Smart Writer is an additional option, not a replacement.


The same writing engine powers everything. Smart Writer just pre-configures the settings that work best.
How Smart Writer Works
Smart Writer guides you through 3 simple steps:
StepWhat You DoTime Required
1. ConfigurationEnter your topic and select article type~30 seconds
2. Outline ReviewReview and optionally edit the AI-generated outline~1-2 minutes
3. Final SettingsChoose image preferences and confirm cost~30 seconds
Total time to submit: Less than 3 minutes
Getting Started: Dashboard Entry Point
You can access Smart Writer from two places:


  1. Dashboard Hero Section - The purple banner with "What would you like to write today?" lets you enter your topic and click "Start Writing"
  2. Navigation Menu - Click the prominent "Smart Writer" button in the top menu

When you enter a topic from the Dashboard and click "Start Writing", it will pre-fill the Article Title field in Smart Writer.


Step 1: Configuration
Header Section


At the top of the page, you'll see:


  • Project Selector - Choose a project to auto-populate settings
  • Credits Remaining - Your current credit balance
  • Learn More Link - Access help documentation

💡 Pro Tip: Use Projects for One-Click Setup


If you've already configured a Project in Settings, simply select it from the dropdown and Smart Writer will automatically populate:


  • Region & Language
  • Writing Style & Readability
  • Point of View
  • Business Name & Background (for Local Service articles)
  • Negative Terms

This saves significant time when creating multiple articles for the same client or business!

Choosing Your Article Type

The wizard presents 4 main article type cards plus additional options:
TypeBest For
Blog PostGeneral informational content, how-to guides
Listicle / Top XImprove AI Visibility, "10 X to..." articles
Product Roundup"Best X Products" comparison lists
Local Service/WebpageLocal business pages, service descriptions
Dropdown "More Types":


  • Competitors Alternatives - "X Alternatives" content
  • Press Release - Official announcements
  • News - Timely news articles
  • Single Product Review - In-depth product analysis
  • Side-by-Side VS Comparison - "X vs Y", direct product comparisons
  • Glossary - Term definitions and explanations
Step-by-Step: Creating a Blog Post


  1. Select "Blog Post" by clicking the card (highlighted with blue border when selected)
  2. Enter Your Article Title
    • Type your desired title, or
    • Click "Get an Article Title" to get AI-generated SEO-optimized suggestions
  3. Configure Region & Language
    • Region: Select your target country for SERP analysis
    • Output Language: Choose your content language (English works best)
  4. Add Keywords (Optional)
    • Enter related keywords, one per line
    • Character limit: 2,500 characters
    • Counter shows: "0/2500"
  5. Click "Create Outline" button.
Local Service/Webpage: Business Information
When you select Local Service/Webpage, additional fields appear:
FieldRequired Example
Business NameYes"Speedy Plumbing"
Type of BusinessYes"Plumber in Melbourne"
Business Website URLNohttps://example.com
Business BackgroundYesServices, history, unique selling points
Pro Tip: Click "Fetch Info" next to the website URL to automatically pull information from your website!

The Business Background field has a 15,000 character limit with a counter.

Loading Screen
After clicking "Create Outline", you'll see:


  • A loading spinner
  • Message: "Analyzing competitors and generating outlines..."
  • Timer display showing elapsed time (typically 30-90 seconds)

The AI is:


  1. Analyzing top-ranking competitors for your topic
  2. Identifying content gaps and opportunities
  3. Generating 3 optimized outline structure
Step 2: Outline Review
The Outline Interface


Once generation completes, you'll see:


  1. Progress Indicator - Shows Step 2 (Outline Review) is active
  2. Outline Label with Help - Click the "?" icon for formatting tips
  3. Outline Selection Radio Buttons
    • #1, #2, #3 - Click to switch between generated options
    • Each option has a different structure optimized for your topic
  4. Outline Editor (Textarea)
    • Large editable text area showing the selected outline
    • Monospace font for clear structure visualization
    • No text wrapping (scroll horizontally for long lines)
  5. Regenerate Outline Button
    • Click if none of the 3 options fit your needs
    • Generates 3 fresh outlines
  6. Word Count Estimate Box
    • Shows: "📊 Estimated: ~3,135 words"
    • Shows: "Lines used: 32/60"
Outline Format Guide


1. Introduction

2. Main Heading (H2)
- Sub-heading (H3)
- Sub-heading (H3)
3. Another Main Heading
- Sub-point
4. Main Section
...
12. Conclusion

Rules:


  • Lines starting with numbers become H2 headings
  • Lines starting with - become H3 sub-headings
  • Maximum 60 lines recommended
  • Always include Introduction and Conclusion
Outline Settings (Expandable Section)
Click "Outline Settings" to expand additional options:
SettingOptionsDefaultPurpose
Article LengthAuto, Auto - More H2, 750-5,000+ wordsAutoControl output length
AI Friendly OutlineCheckboxOffOff
Optimize for LLM/AI visibility
Let AI auto improve content gapsCheckboxOnAllow AI to enhance outline
Note: When "Let AI auto improve" is checked, the AI Model defaults to GPT-5.2 (DeepPolish+) in Step 3.

Navigation


  • ← Back - Return to Step 1 to modify configuration
  • Next: Final Settings → - Proceed to Step 3
Step 3: Final Settings
Header Display


The heading shows: "Final Settings (Blog Post)" - confirming your selected article type.

AI Images Selection


Choose your image preference from 4 options:

OptionCostImagesQuality
NoneFreeDolor-
Up to 2 (Free)Free2Standard
3 Smart Visual+ 1 credit3Premium
7 Smart Visual+ 2 credits7Premium
Smart Visual creates contextually relevant images using advanced AI.


Default Selection: 3 Smart Visual (+1 credit)
Image Customization (Expandable)
Click "Customize Image Settings" to access:
SettingOptionDefault
Image StylePhoto, Photo (Raw), Cinematic, Creative Photo, Anime, Comic Book, Flat DesignPhoto
SizeLandscape 16:9, Landscape 3:2, Portrait 9:16, Square...Landscape 3:2
Alt TagNone, Short, Long, Short + Keyword, Long + KeywordShort
EthnicityAny, Black, Caucasian, East Asian, South Asian, HispanicAny
Reference ImagesUp to 3 imagesNone
Advanced Settings (Expandable)
Click "Advanced Settings" to reveal:
SettingsOptionsDefault
AI ModelStandard: GPT-4o-mini, ⭐ GPT-5.2 (DeepPolish+), ⭐ Gemini 3.0 ProDepends on article type
Writing StyleDefault, Auto from SERP, Authoritative + Conversational, Humanize, Health, Local Biz, News, SEO, NarrativeDepends on article type
Readability5th-16th+ grade levels7th grade
Point of ViewAuto, First Person (I/We), Second Person, Third PersonAuto
Negative TermsCheckbox + text areaEnabled with defaults
Negative Terms: Pre-populated with AI-sounding phrases to avoid (e.g., "delve into", "embark", "meticulous").
Why These Defaults?


These aren't random choices. GPT-5.2 with DeepPolish+ produces the most polished output. "Humanize" writing style reduces AI-sounding patterns. 7th grade readability ensures broad accessibility. These settings consistently produce high-performing articles.

Estimated Cost Box


The "Estimated Cost Box" provides a clear breakdown of the total cost in credits, starting with a Base cost of 2 credits, adding 0 extra credits for the AI Model and 1 extra credit for AI Images, resulting in a Total cost of 3 credits.

Submit Your Article


Click "Add to Writing Queue" (green button) to submit.


Success: A modal appears with options:


  • Write Another - Start a new article
  • View Queue - Go to History to monitor progress
Special Article Types
Product Roundup & Competitors Alternatives


These types require product validation:


  1. Product List Section appears in Step 2
    Enter products in format:
    Product Name | https://product-url.com
    Another Product | Auto
  2. Counter shows: "Added products: 3/15"
  3. Click "Validate Products" before proceeding
  4. Fixed AI Model: Full GPT 4-o (cannot change)
  5. Base Cost: 4 credits
Press Release & News


Simplified workflow:

  • No outline generation (textarea disabled with message)
  • No Outline Settings section
  • No word count estimate
  • Fixed AI Model: Claude 4 Sonnet
  • Images: Only "None" and "Up to 2 (Free)" options
  • Base Cost: 1 credit
  • Next button: Always enabled (no outline validation)
Tips for Best Results
Before You Start


  1. Set Up Projects First: Go to Settings → Projects and configure your business info, preferred region, language, and writing style. When you select this project in Smart Writer, all settings auto-populate instantly.
  2. Research Your Topic: Have a clear angle before starting
  3. Know Your Audience: Consider who will read your content

During Configuration


  1. Be Specific with Titles:
    • ✅ "How to Choose the Right Coffee Machine for Your Kitchen"
    • ❌ "Coffee Machines"
  2. Use Keywords Strategically: Add terms you want the AI to incorporate
  3. Match Article Type to Goal: Each type has optimized defaults

During Outline Review


  1. Review All 3 Options: Often #2 or #3 has better structure
  2. Edit Sparingly: AI structure is based on competitor analysis
  3. Add Unique Angles: Insert headings competitors missed

Final Settings


  1. Trust the Defaults: Based on thousands of successful articles
  2. Use Reference Images: For brand consistency
  3. Verify Credits: Check balance before submitting

Frequently Asked Questions 

Q: How long does outline generation take?

A: Usually 30-90 seconds. The timer shows elapsed time during loading.


Q: Can I edit the article after generation?

A: Yes! All articles are fully editable in the History section.


Q: What if I need more control?

A: Use Advanced Mode (Write menu → Advanced Mode) for 50+ customization options.


Q: Why does Product Roundup cost more?

A: These articles require additional product research and comparison structure.


Q: Can I use any language?

A: English variants work best. Other languages are in beta.


Q: What's the difference between Smart Writer and Advanced Mode?

A: Same writing engine, different approach. Smart Writer pre-configures settings based on what works best,  you make 2-3 decisions. Advanced Mode shows you everything and lets you customize 30+ parameters. Choose based on how much control you want.


Q: How do I get AI title suggestions?

A: Click "Get an Article Title" - it analyzes SERP data for SEO-optimized suggestions.


Q: Will my settings be saved?

A: Yes! Region, language, and preferences persist across sessions.



Was this article helpful?

0 out of 0 liked this article

Still need help? Message Us