Comparison Page skill
A ready-to-run comparison page skill: how Okara’s Writer Agent builds fair, decisive "X vs Y" pages that win comparison searches without trashing rivals.
Download the skill instructions, see an example comparison, or run it live inside the Writer Agent to build a page for your category.
- Category
- Writer
- Agent
- Writer Agent
- Format
- comparison-page.md
- Price
- Free to download
The skill file
---
name: comparison-page
description: Build a fair, decisive comparison page ("X vs Y" or "alternatives to X") with an accurate table, honest positioning, and clear guidance on who should choose what.
owner: Okara Writer Agent
---
# Comparison Page
A comparison page wins by being trusted. Buyers on "X vs Y" and "alternatives"
searches are close to deciding — a fair, accurate comparison that admits
trade-offs converts far better than a one-sided pitch.Log in to view, copy, and download the complete skill file.
About this skill
What is the Comparison Page?
The Comparison Page skill is the instruction set Okara’s Writer Agent uses to build "X vs Y" and "alternatives to X" pages that buyers trust and search engines reward. It insists on a fair, accurate comparison table, honest acknowledgment of where each option wins, and clear "who should choose what" guidance — because a credible comparison converts better than a one-sided pitch.
It’s written as a SKILL.md, a plain-language instruction format that both people and AI agents can follow directly. Read it to understand the method, adapt it for your category, or let the Writer Agent draft the comparison from your details.
Downloading the instructions is free with an Okara account. Building and refreshing comparison pages across your competitors is part of the Writer Agent.
Comparison pages sit squarely inside that self-directed research window: commonly cited estimates put B2B buyers at roughly 60–70%+ of their way through the buying journey — consuming several pieces of content — before they ever talk to a salesperson, and "[you] vs [competitor]" is one of the highest-intent searches a buyer runs during that stretch. A page that dodges the comparison or spins it loses exactly the buyer who was close enough to decide alone; a fair one is often the deciding input sales never gets credit for.
Example
See it in action
You ask: “Write a comparison page: our email tool vs the market leader.”
Agent does: I’ll build it to be trusted, not just to win. It opens with a one-line summary of who each tool is best for, then a clean feature table that’s accurate — including the two areas where the leader is genuinely stronger, which keeps the whole page credible. The differentiators section focuses on where you actually win (price, deliverability, support), each backed by a specific proof point. It closes with a "choose us if / choose them if" block so the right buyer self-selects. I targeted "[your tool] vs [leader]" and "[leader] alternatives" in the copy. Want a migration-focused CTA at the end?
Comparison
The skill vs. the alternatives
| Do it yourself | Hire a freelancer or agency | Comparison Page skill (free) | Writer Agent | |
|---|---|---|---|---|
| Cost | Your own time | $500–$5,000+ per project | Free with an Okara account | Included in the AI CMO plan |
| Time to first result | Hours to days, per attempt | Days to weeks, plus revision rounds | Minutes — download and follow it | Same day, runs automatically |
| Consistency over time | Depends on remembering to do it | Only as long as the retainer lasts | One-time; you re-run it yourself | Continuous, on a schedule |
| Who does the work | You, from scratch each time | Someone who has to learn your business first | You (or your agent), following the exact steps | Okara's Writer Agent, end to end |
How it works
From input to output
- 1
You name the two options
Tell the Writer Agent what you’re comparing and your category.
- 2
Okara builds a fair comparison
It structures an accurate feature table and honest positioning for each option.
- 3
It sharpens your differentiators
Where you genuinely win is backed with specific proof, not adjectives.
- 4
You get a decisive page
A credible "who should choose what" comparison to publish or refine in the Writer Agent.
What's included
Everything it covers
Fair comparison table
Builds an accurate, side-by-side table that stays credible with buyers.
Honest positioning
Frames who each option is genuinely best for, so the right buyer self-selects.
Differentiator proof
Backs each advantage with a specific, verifiable proof point.
Decision guidance
Adds a "choose us if / choose them if" block that helps buyers decide.
"vs" & "alternatives" SEO
Targets high-intent comparison queries naturally in the copy.
Category framing
Sets the comparison criteria that actually matter in your category.
Use cases
When to reach for it
- Win high-intent "[you] vs [competitor]" searches with a credible page.
- Capture "[competitor] alternatives" traffic from buyers already shopping.
- Give sales a fair, linkable comparison to send undecided prospects.
- Position honestly against a stronger incumbent without losing trust.
- Keep comparison pages consistent and current across competitors.
Frequently Asked Questions
Related skills
Pair it with these skills
Blog Post
The blog-writing methodology Okara’s Writer Agent follows to turn a keyword into a focused, SEO-aware post that ranks and reads like a human wrote it.
--- name: blog-post description: Write a single, focused, SEO-aware blog post — one topic, one reader, one takeaway — that ranks in search and reads like a human wrote it. owner: Okara Writer Agent --- # Blog Post Write one publish-ready blog post built around a single topic and a single reader intent, structured to earn the search click and hold attention to the
Long-Form Content
The pillar-content methodology Okara’s Writer Agent uses to write comprehensive, authoritative guides that own a topic and earn links over time.
--- name: long-form-content description: Write a comprehensive, authoritative pillar guide (2,000-5,000+ words) that covers a topic end to end, anchors a content cluster, and earns links and rankings over time. owner: Okara Writer Agent --- # Long-Form Content Produce a definitive, in-depth guide that owns a broad topic — the page a reader bookmarks and other sites link to — not a quick post. Depth, structure,
Listicle
The list-article methodology Okara’s Writer Agent uses to write scannable, curated listicles where every item earns its place and the framing makes the choice easy.
--- name: listicle description: Write a scannable list article — "N X for Y" — with a curated set of items, parallel structure, and a framing that makes the reader's decision easier. owner: Okara Writer Agent --- # Listicle Write a list-format article that's genuinely useful, not padded. Every item earns its place, the structure is consistent, and the intro and wrap-up turn a
How-To Guide
The instructional-writing methodology Okara’s Writer Agent uses to turn a task into a step-by-step guide a reader can actually follow to the finish.
--- name: how-to-guide description: Write step-by-step instructional content that takes a reader from a clear starting point to a specific outcome, with prerequisites, testable steps, and troubleshooting. owner: Okara Writer Agent --- # How-To Guide Write a guide that gets the reader to a result. The measure of success is simple: can someone follow it and finish the task? Structure, sequence, and
Content Brief
The briefing methodology Okara’s Writer Agent uses to specify a piece — goal, audience, angle, structure, and specs — so it gets written right the first time.
--- name: content-brief description: Produce a writer-ready content brief that specifies the goal, audience, angle, structure, and specs so a piece can be written correctly the first time. owner: Okara Writer Agent --- # Content Brief Write the brief, not the article. A great brief removes ambiguity so any writer — human or AI — can execute it without a round of follow-up questions
Content Outline
The outlining methodology Okara’s Writer Agent uses to build a complete, logically sequenced heading hierarchy before a single sentence gets drafted.
--- name: content-outline description: Build the structural skeleton of a piece before drafting — a heading hierarchy with bulleted talking points that covers the query completely and flows logically. owner: Okara Writer Agent --- # Content Outline Design the skeleton before anyone writes a sentence. A strong outline decides what the piece covers and in what order, so drafting becomes filling in points