comparison-post-writer

Name: comparison-post-writer
Author: Affitor

5installs184forks

How to install comparison-post-writer?

affitor/affiliate-skills/comparison-post-writer

$npx -y skills add Affitor/affiliate-skills --skill comparison-post-writer

Installs into the current project.

Summary

Write "X vs Y" comparison blog posts that help readers choose between two competing products. Triggers on: "write a comparison post", "X vs Y blog post", "compare [product A] and [product B]", "which is better [A] or [B]", "head to head comparison", "[product] vs [product] articl

Files · 1

View on GitHub

SKILL.md

1	# Comparison Post Writer
2
3	Write high-converting "X vs Y" comparison blog posts that rank on Google and help readers make a confident buying decision. Each post includes a feature comparison table, individual product breakdowns, pros and cons, a clear winner recommendation, and affiliate CTAs placed at maximum-intent moments.
4
5	## When to Use
6
7	- User wants to compare two or three competing products side by side
8	- User has two affiliate programs and wants a single article that covers both
9	- User says "vs", "versus", "compare", "which is better", "side by side"
10	- User wants to capture high-intent search traffic (X vs Y searches convert at 2-3x the rate of generic reviews)
11	- User has a product from S1 and wants to frame it against competitors
12
13	## Workflow
14
15	### Step 1: Identify Products to Compare
16
17	Parse the user's request for product names. You need a minimum of 2 and a maximum of 3 products.
18
19	If only 1 product is provided:
20	- Use `web_search` to find the top 1-2 competitors
21	- Search: `"[product name] alternatives" OR "[product name] vs" site:g2.com OR site:capterra.com OR site:trustradius.com`
22	- Pick the competitors with the most head-to-head search volume
23
24	If 3+ products are provided:
25	- Keep all 3 if they are genuinely comparable
26	- If the user listed 4+, ask which 2-3 to focus on — more than 3 makes the comparison unwieldy
27
28	Affiliate priority: The user's affiliate product goes first (featured position). If both products have affiliate links, feature the higher-commission one in the "winner" slot unless the product genuinely loses on quality.
29
30	### Step 2: Research Both Products
31
32	For each product, use `web_search` to gather:
33	1. Pricing: starting price, tiers, free trial availability
34	2. Key features: 8-12 features that matter to buyers
35	3. Target audience: who uses this product and why
36	4. Known weaknesses: common complaints on G2, Capterra, Reddit, or Trustpilot
37	5. Unique differentiator: one thing this product does better than everyone else
38	6. Search volume signal: `"[product A] vs [product B]"` — check if autocomplete shows this is a real query
39
40	Search queries to run per product:
41	- `"[product name] review [year]"`
42	- `"[product name] pricing"`
43	- `"[product name] pros cons"`
44
45	### Step 3: Build the Comparison Framework
46
47	Determine the 6-10 comparison dimensions that matter most for this product category. These should be:
48	- Directly relevant to buyer decisions (not vanity features)
49	- Measurable or clearly differentiable between products
50	- Things that appear in search queries ("does X have [feature]?")
51
52	Example dimensions by category:
53	- Email tools: deliverability, automation, templates, integrations, pricing/contacts ratio, free plan
54	- SEO tools: keyword database size, backlink data, site audit depth, reporting, API access, pricing
55	- Video tools: resolution, AI avatars, voice cloning, templates, render speed, watermark on free plan
56	- Project management: task limits on free, Gantt chart, time tracking, automations, integrations, mobile app
57
58	Assign a winner per dimension based on research. Mark ties where genuine.
59
60	### Step 4: Determine the Narrative Angle
61
62	Choose one of three angles based on what the data shows:
63
64	\| Angle \| When to use \| Headline formula \|
65	\|---\|---\|---\|
66	\| Clear winner \| One product is genuinely better for most users \| "[A] vs [B]: [A] Wins for Most, But [B] Is Better If..." \|
67	\| It depends \| Products serve different audiences \| "[A] vs [B]: Which Is Right for You? (Honest Comparison)" \|
68	\| Upset \| Lesser-known product beats the market leader \| "[A] vs [B]: Why [Lesser-Known] Is Actually Better in [Year]" \|
69
70	Default to "clear winner" — readers want a recommendation, not a non-answer.
71
72	### Step 5: Write the Article
73
74	Write the full comparison post following this exact structure:
75
76	1. FTC Disclosure (3 lines, above the fold)
77	Read `shared/references/ftc-compliance.md` and use the medium format. Insert immediately after the title.
78
79	2. Introduction (150-250 words)
80	- Open with the core tension: why this is a hard choice
81	- State who each product is best suited for (one sentence each)
82	- End with: "By the end of this post, you'll know exactly which one to pick."
83	- Include target keyword natural

People who liked this also viewed

6 picks

Type

comparison-post-writer

5installs184forks

View on GitHub

How to install comparison-post-writer?

affitor/affiliate-skills/comparison-post-writer

$npx -y skills add Affitor/affiliate-skills --skill comparison-post-writer

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Comparison Post Writer
2
3	Write high-converting "X vs Y" comparison blog posts that rank on Google and help readers make a confident buying decision. Each post includes a feature comparison table, individual product breakdowns, pros and cons, a clear winner recommendation, and affiliate CTAs placed at maximum-intent moments.
4
5	## When to Use
6
7	- User wants to compare two or three competing products side by side
8	- User has two affiliate programs and wants a single article that covers both
9	- User says "vs", "versus", "compare", "which is better", "side by side"
10	- User wants to capture high-intent search traffic (X vs Y searches convert at 2-3x the rate of generic reviews)
11	- User has a product from S1 and wants to frame it against competitors
12
13	## Workflow
14
15	### Step 1: Identify Products to Compare
16
17	Parse the user's request for product names. You need a minimum of 2 and a maximum of 3 products.
18
19	If only 1 product is provided:
20	- Use `web_search` to find the top 1-2 competitors
21	- Search: `"[product name] alternatives" OR "[product name] vs" site:g2.com OR site:capterra.com OR site:trustradius.com`
22	- Pick the competitors with the most head-to-head search volume
23
24	If 3+ products are provided:
25	- Keep all 3 if they are genuinely comparable
26	- If the user listed 4+, ask which 2-3 to focus on — more than 3 makes the comparison unwieldy
27
28	Affiliate priority: The user's affiliate product goes first (featured position). If both products have affiliate links, feature the higher-commission one in the "winner" slot unless the product genuinely loses on quality.
29
30	### Step 2: Research Both Products
31
32	For each product, use `web_search` to gather:
33	1. Pricing: starting price, tiers, free trial availability
34	2. Key features: 8-12 features that matter to buyers
35	3. Target audience: who uses this product and why
36	4. Known weaknesses: common complaints on G2, Capterra, Reddit, or Trustpilot
37	5. Unique differentiator: one thing this product does better than everyone else
38	6. Search volume signal: `"[product A] vs [product B]"` — check if autocomplete shows this is a real query
39
40	Search queries to run per product:
41	- `"[product name] review [year]"`
42	- `"[product name] pricing"`
43	- `"[product name] pros cons"`
44
45	### Step 3: Build the Comparison Framework
46
47	Determine the 6-10 comparison dimensions that matter most for this product category. These should be:
48	- Directly relevant to buyer decisions (not vanity features)
49	- Measurable or clearly differentiable between products
50	- Things that appear in search queries ("does X have [feature]?")
51
52	Example dimensions by category:
53	- Email tools: deliverability, automation, templates, integrations, pricing/contacts ratio, free plan
54	- SEO tools: keyword database size, backlink data, site audit depth, reporting, API access, pricing
55	- Video tools: resolution, AI avatars, voice cloning, templates, render speed, watermark on free plan
56	- Project management: task limits on free, Gantt chart, time tracking, automations, integrations, mobile app
57
58	Assign a winner per dimension based on research. Mark ties where genuine.
59
60	### Step 4: Determine the Narrative Angle
61
62	Choose one of three angles based on what the data shows:
63
64	\| Angle \| When to use \| Headline formula \|
65	\|---\|---\|---\|
66	\| Clear winner \| One product is genuinely better for most users \| "[A] vs [B]: [A] Wins for Most, But [B] Is Better If..." \|
67	\| It depends \| Products serve different audiences \| "[A] vs [B]: Which Is Right for You? (Honest Comparison)" \|
68	\| Upset \| Lesser-known product beats the market leader \| "[A] vs [B]: Why [Lesser-Known] Is Actually Better in [Year]" \|
69
70	Default to "clear winner" — readers want a recommendation, not a non-answer.
71
72	### Step 5: Write the Article
73
74	Write the full comparison post following this exact structure:
75
76	1. FTC Disclosure (3 lines, above the fold)
77	Read `shared/references/ftc-compliance.md` and use the medium format. Insert immediately after the title.
78
79	2. Introduction (150-250 words)
80	- Open with the core tension: why this is a hard choice
81	- State who each product is best suited for (one sentence each)
82	- End with: "By the end of this post, you'll know exactly which one to pick."
83	- Include target keyword natural

People who liked this also viewed

6 picks

Type