---
name: comparison-article-writer
description: "A balanced, search-friendly A vs B comparison article that helps readers choose between two products or ideas, with an optional table and verdict. Use when a writer needs an X vs Y comparison article or blog post that ranks for a keyword and helps readers choose. Do not use for a single-product review or a ranked list of many options. Related topics: writing, seo, comparison."
---

# Comparison Article Writer

A balanced, search-friendly A vs B comparison article that helps readers choose between two products or ideas, with an optional table and verdict.

## When to use

Use this skill when a writer needs an X vs Y comparison article or blog post that ranks for a keyword and helps readers choose. Do not use it for a single-product review or a ranked list of many options.

## Workflow

1. Ask the user for each input listed below in a single message, skipping any they have already given. Where options are listed, offer them, but accept other answers too.
2. Define the reader and the one decision they face, and write the opening that names both items and the keyword.
3. Draft one subheading per chosen criterion, covering A and B in the same order and at similar length.
4. Add the comparison table right after the introduction when requested, with one row per criterion.
5. Write the verdict by reader type if a winner is requested, otherwise a neutral which-to-choose summary.
6. Trim or extend to land within ten percent of the word count and confirm the keyword appears in title, opening, and one subheading.

## Inputs

- **Item A** (free text, e.g. "First product or concept")
- **Item B** (free text, e.g. "Second product or concept")
- **Topic category** (choose one: Software, Hardware, Services, Strategies, Courses, Books, Other)
- **Target keyword** (free text, e.g. "React vs Vue for beginners")
- **Criteria to compare** (choose any: Pricing, Features, Performance, Ease of use, Support & community, Scalability, Integrations)
- **Declare a winner at the end** (choose one: Yes, No)
- **Include a comparison table** (choose one: Yes, No)
- **Word count target** (number from 500 to 3000)
- **Tone** (choose one: Neutral & objective, Opinionated, Beginner-friendly)

## Output

A titled article with an intro, one subheading per criterion, an optional comparison table, and a closing verdict or summary, at the requested word count.

## Prompt template

Fill the inputs into this template and follow it as the full instruction.

### Comparison Article Writer

Write an SEO-optimised comparison article that helps a reader decide between two options.

- Item A: {{Item A}}
- Item B: {{Item B}}
- Topic category: {{Topic category}}
- Target keyword: {{Target keyword}}
- Criteria to compare: {{Criteria to compare}}
- Declare a winner at the end: {{Declare a winner at the end}}
- Include a comparison table: {{Include a comparison table}}
- Word count target: {{Word count target}}
- Tone: {{Tone}}

Put the target keyword in the title, the first paragraph, and one subheading, and never force it elsewhere. Open by naming who this comparison is for and the one question it answers. Give each chosen criterion its own subheading and treat A and B in the same order and depth, so neither looks favoured by length. Use specifics the reader can check, and say when a point depends on the reader's situation. If a winner is requested, give a verdict per reader type rather than a single universal pick. If a table is requested, place it right after the introduction. Close with a short "which to choose" summary.

## Pitfalls

- Giving the favoured item more space or warmer wording, which readers read as bias.
- Repeating the keyword in every paragraph until the article reads as stuffed.
- Naming a winner without saying for whom, so the verdict is wrong for half the readers.
- Stating prices or features from memory that may be out of date.
