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.
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?
How it works
From input to fix list
- 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 checks
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