Unified content writing toolkit — long-form (SEO blog articles, how-to tutorials, comparison posts, listicles), short-form (viral social posts, reddit posts, twitter threads, tiktok scripts), paid ad copy, email sequences, and content repurposing. Channel-aware. Single entry point for any copywriting task across formats and platforms.
Unified content writing toolkit — long-form (SEO blog articles, how-to tutorials, comparison posts, listicles), short-form (viral social posts, reddit posts, twitter threads, tiktok scripts), paid ad copy, email sequences, and content repurposing. Channel-aware. Single entry point for any copywriting task across formats and platforms.
layer
hub
category
affiliate-marketing
triggers
["ad copy","affiliate automation","affiliate blog","affiliate blog builder","affiliate content","comparison post","comparison post writer","content repurpose","content repurposer","how to tutorial writer","listicle","listicle generator","paid ad copy writer","product review","reddit post writer","social media post","tiktok script writer","twitter thread writer","viral post","viral post writer"]
content-writer
Unified content writing toolkit — long-form (SEO blog articles, how-to tutorials, comparison posts, listicles), short-form (viral social posts, reddit posts, twitter threads, tiktok scripts), paid ad copy, email sequences, and content repurposing. Channel-aware. Single entry point for any copywriting task across formats and platforms.
Absorbs
affiliate-blog-builder
comparison-post-writer
how-to-tutorial-writer
listicle-generator
viral-post-writer
reddit-post-writer
twitter-thread-writer
tiktok-script-writer
paid-ad-copy-writer
content-repurposer
From affiliate-blog-builder
Affiliate Blog Builder
Write full SEO-optimized blog articles that rank on Google and drive passive affiliate revenue. Supports four formats: product review, head-to-head comparison, best-of listicle, and how-to guide. Each article includes keyword strategy, structured headings, comparison tables, CTAs, FAQ schema, and FTC-compliant disclosure.
Stage
S3: Blog — The highest-value content type in the affiliate funnel. Blog articles rank on Google, drive organic traffic for months/years, and convert at higher rates than social posts because readers have high purchase intent.
When to Use
User wants to write a blog post reviewing an affiliate product
User wants a comparison article (Product A vs Product B)
User wants a "best of" listicle for a product category
User wants a how-to tutorial that naturally promotes an affiliate product
User has a product from S1 (affiliate-program-search) and wants to create long-form content
User says anything like "write a blog", "SEO article", "product review post", "roundup post"
Input Schema
product:# REQUIRED — the affiliate product to featurename:string# Product name (e.g., "HeyGen")description:string# What it doesreward_value:string# Commission (e.g., "30% recurring")url:string# Affiliate link URLreward_type:string# "recurring" | "one-time" | "tiered"cookie_days:number# Cookie durationtags:string[]# e.g., ["ai", "video", "saas"]format:string# OPTIONAL — "review" | "comparison" | "listicle" | "how-to"# Default: "listicle" (highest traffic potential)compare_with:object[]# OPTIONAL — competitors for comparison/listicle formats-name:string# Competitor namedescription:string# Brief descriptionurl:string# URL (non-affiliate OK)pricing:string# Starting pricetarget_keyword:string# OPTIONAL — primary SEO keyword to target# Default: auto-generated from product name + categoryblog_platform:string# OPTIONAL — "wordpress" | "ghost" | "hugo" | "astro" | "webflow" | "markdown"# Default: "markdown" (universal)tone:string# OPTIONAL — "professional" | "conversational" | "technical"# Default: "conversational"word_count_target:number# OPTIONAL — override default word count for the format
Chaining from S1: If affiliate-program-search was run earlier in the conversation, automatically pick up recommended_program from its output as the product input. The field mapping:
No Affitor branding in the article body (this is the user's blog, not ours)
No "AI-generated" disclaimers (the user will edit and personalize)
No placeholder text like "[insert your experience here]" — write complete content. If personal experience is needed, write realistic example scenarios clearly marked as examples
No keyword stuffing — natural language only
No false claims about products
Step 4: Format Output
Produce the final output in this exact structure:
Part 1: SEO Metadata Block
---
SEO METADATA
---
Title: [SEO title]
Slug: [url-slug]
Meta Description: [150-160 chars]
Target Keyword: [primary keyword]
Secondary Keywords: [comma-separated list]
Word Count: [actual count]
Format: [review/comparison/listicle/how-to]
---
Part 2: Full Article
The complete markdown article ready to paste into any blogging platform.
Part 3: Supplementary Data
---
SUPPLEMENTARY
---
FAQ Questions (for schema markup):
1. [Question] → [Answer]
2. [Question] → [Answer]
...
Image Suggestions:
1. [Description] — alt: "[alt text]"
2. [Description] — alt: "[alt text]"
...
Products Featured:
- [Product 1]: [affiliate URL] (featured/mentioned)
- [Product 2]: [affiliate URL] (compared/mentioned)
...
Next Steps:
- Personalize: Add your own experience, screenshots, and results
- Images: Take product screenshots and add them at suggested locations
- Links: Replace affiliate URLs with your own tracking links
- Publish: See references/wordpress-deploy.md for WordPress setup guide
- Promote: Run viral-post-writer to create social posts promoting this article
---
Output Schema
article:title:string# SEO-optimized titleslug:string# URL-friendly slugmeta_description:string# 150-160 character meta descriptiontarget_keyword:string# Primary keyword targetedformat:string# review | comparison | listicle | how-tocontent:string# Full markdown articleword_count:number# Actual word countheadings:# Article structure-level:number# 2 for H2, 3 for H3text:string# Heading textseo:secondary_keywords:string[]# 3-5 secondary keywords usedfaq_questions:# For FAQ schema markup-question:stringanswer:stringimage_suggestions:# Recommended images-description:string# What to screenshot/createalt_text:string# SEO alt textplacement:string# After which sectionproducts_featured:# All products mentioned-name:stringurl:string# Affiliate URLrole:string# "primary" | "compared" | "mentioned"reward_value:string# Commission info
Output Format
Present the output as a single markdown document with three clearly separated sections:
SEO Metadata — fenced block with all SEO settings for easy copy into WordPress/Yoast
Article — the full blog post in markdown, ready to paste
Supplementary — FAQ for schema markup, image suggestions, products list, and next steps
The article should be immediately publishable — not a draft or outline. The user should be able to copy-paste it into their blog editor, add their own screenshots and personal touches, and publish.
Error Handling
No product provided: "I need a product to write about. Run /affiliate-program-search first to find one, or tell me the product name and I'll research it."
Comparison with only 1 product: Auto-search for 2-3 competitors using web_search. Search: "best alternatives to [product]" on G2/Capterra.
No compare_with for listicle: Auto-search for 4-6 products in the category. Inform user: "I found these products to include — let me know if you want to swap any."
Unknown blog platform: Default to markdown output. Add note: "This is universal markdown — works with WordPress, Ghost, Hugo, Astro, and most platforms."
Product has no public info: Use web_search to research the product. If still insufficient: "I couldn't find enough information about [product] to write a credible article. Can you provide more details about features, pricing, and your experience?"
Controversial or questionable product: Include balanced pros/cons. Add note: "This product has mixed reviews — make sure you've personally verified these claims before publishing."
Examples
Example 1: Product Review (chained from S1)
User: "Now write a detailed review of HeyGen for my blog"
Context: S1 previously returned HeyGen as recommended_program
Action: Auto-detect format=review, pick up HeyGen product data from S1 output, generate full review article targeting "heygen review" keyword.
Example 2: Comparison Article
User: "Write a comparison blog post: HeyGen vs Synthesia vs Colossyan for AI video creation"
Action: Format=comparison, primary product=HeyGen (if from S1, else first mentioned), compare_with=[Synthesia, Colossyan], target keyword="heygen vs synthesia vs colossyan".
Example 3: Listicle (Default Format)
User: "Write a blog post about the best AI video tools"
Action: Format=listicle (matches "best"), web_search for top AI video tools, target keyword="best ai video tools", write 3-5K word roundup with 5-7 products.
Example 4: How-To Guide
User: "Write a tutorial blog post on how to create AI-generated videos for YouTube with HeyGen"
Action: Format=how-to (matches "tutorial", "how to"), target keyword="how to create ai videos for youtube", write step-by-step guide featuring HeyGen with affiliate CTAs.
Example 5: Minimal Input
User: "Blog post about Semrush"
Action: No format specified → default to listicle? No — single product implies review. Use format=review, web_search Semrush for features/pricing/reviews, target keyword="semrush review", generate full article.
Format detection logic for ambiguous cases: If only one product is mentioned with no format keyword, default to review. If a category is mentioned with no specific product, default to listicle.
References
references/seo-checklist.md — Title formulas, meta description rules, heading hierarchy, keyword density, content depth guidelines. Read in Step 2.
references/blog-templates.md — Four article format templates (review, comparison, listicle, how-to) with exact structure. Read in Step 3.
references/wordpress-deploy.md — WordPress publishing guide, Yoast SEO setup, Pretty Links, FAQ schema implementation. Reference in Step 4 next steps.
shared/references/ftc-compliance.md — FTC disclosure requirements and format templates. Read in Step 3 for disclosure text.
shared/references/affitor-branding.md — Affitor brand guidelines. Note: NO Affitor branding in article body (user's blog). Only in tool output metadata.
shared/references/affiliate-glossary.md — Affiliate marketing terminology reference.
From comparison-post-writer
Comparison Post Writer
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.
When to Use
User wants to compare two or three competing products side by side
User has two affiliate programs and wants a single article that covers both
User says "vs", "versus", "compare", "which is better", "side by side"
User wants to capture high-intent search traffic (X vs Y searches convert at 2-3x the rate of generic reviews)
User has a product from S1 and wants to frame it against competitors
Workflow
Step 1: Identify Products to Compare
Parse the user's request for product names. You need a minimum of 2 and a maximum of 3 products.
If only 1 product is provided:
Use web_search to find the top 1-2 competitors
Search: "[product name] alternatives" OR "[product name] vs" site:g2.com OR site:capterra.com OR site:trustradius.com
Pick the competitors with the most head-to-head search volume
If 3+ products are provided:
Keep all 3 if they are genuinely comparable
If the user listed 4+, ask which 2-3 to focus on — more than 3 makes the comparison unwieldy
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.
Known weaknesses: common complaints on G2, Capterra, Reddit, or Trustpilot
Unique differentiator: one thing this product does better than everyone else
Search volume signal: "[product A] vs [product B]" — check if autocomplete shows this is a real query
Search queries to run per product:
"[product name] review [year]"
"[product name] pricing"
"[product name] pros cons"
Step 3: Build the Comparison Framework
Determine the 6-10 comparison dimensions that matter most for this product category. These should be:
Directly relevant to buyer decisions (not vanity features)
Measurable or clearly differentiable between products
Things that appear in search queries ("does X have [feature]?")
Example dimensions by category:
Email tools: deliverability, automation, templates, integrations, pricing/contacts ratio, free plan
SEO tools: keyword database size, backlink data, site audit depth, reporting, API access, pricing
Video tools: resolution, AI avatars, voice cloning, templates, render speed, watermark on free plan
Project management: task limits on free, Gantt chart, time tracking, automations, integrations, mobile app
Assign a winner per dimension based on research. Mark ties where genuine.
Step 4: Determine the Narrative Angle
Choose one of three angles based on what the data shows:
Angle
When to use
Headline formula
Clear winner
One product is genuinely better for most users
"[A] vs [B]: [A] Wins for Most, But [B] Is Better If..."
It depends
Products serve different audiences
"[A] vs [B]: Which Is Right for You? (Honest Comparison)"
Upset
Lesser-known product beats the market leader
"[A] vs [B]: Why [Lesser-Known] Is Actually Better in [Year]"
Default to "clear winner" — readers want a recommendation, not a non-answer.
Step 5: Write the Article
Write the full comparison post following this exact structure:
1. FTC Disclosure (3 lines, above the fold)
Read shared/references/ftc-compliance.md and use the medium format. Insert immediately after the title.
2. Introduction (150-250 words)
Open with the core tension: why this is a hard choice
State who each product is best suited for (one sentence each)
End with: "By the end of this post, you'll know exactly which one to pick."
Include target keyword naturally in the first 100 words
3. Quick Verdict Box (immediately after intro)
A scannable summary for readers who won't read the full article:
**Quick Verdict**
- Best overall: [Product A] — [one-line reason]
- Best for [use case]: [Product B] — [one-line reason]
- Best for budget: [Product X]
- Skip if: [edge case where neither works]
4. Product Overviews (200-300 words each)
One H2 section per product:
Use ✅ / ❌ / ⚠️ (partial) for binary features. Use descriptive text for nuanced ones. Bold the winner per row.
6. Deep-Dive Sections (one H2 per key dimension, 3-4 total)
Pick the 3-4 dimensions that drive 80% of buying decisions. For each:
Explain what the feature does and why it matters
Compare both products specifically (not generically)
Include a sub-verdict: "Winner: [Product] because..."
7. Pricing Breakdown
Table showing all pricing tiers for both products
Calculate cost at 3 usage levels: starter, growing, scale
Highlight free plan differences
Note which has better value per feature
8. Pros and Cons
Two H3 sections (one per product), each with 4-6 bullet points per list.
9. Who Should Choose Each Product
Two H3 sections with bullet lists:
"Choose [Product A] if you..."
"Choose [Product B] if you..."
Be specific — job titles, use cases, budget ranges, team sizes.
10. The Verdict (200-300 words)
State the winner clearly: "[Product A] is the better choice for most people."
Explain why in 2-3 sentences
Acknowledge the exception case where [Product B] wins
Final affiliate CTA (strong format): **Get started with [Product A] →**(affiliate_url)
If [Product B] also has affiliate link: secondary CTA below
11. FAQ Section (5-7 questions)
Address the real questions people type into Google:
"Is [Product A] better than [Product B]?"
"Which is cheaper, [A] or [B]?"
"Does [Product A] offer a free trial?"
"Can I switch from [Product B] to [Product A]?"
"Which has better customer support?"
Step 6: Format Output
Produce output in three parts:
Part 1: SEO Metadata
---
SEO METADATA
---
Title: [title]
Slug: [product-a]-vs-[product-b]
Meta Description: [150-160 chars comparing both products with clear angle]
Target Keyword: [product-a] vs [product-b]
Secondary Keywords: [product-a] review, [product-b] alternatives, best [category] tool, [product-a] pricing
Word Count: [actual]
Format: comparison
Winner: [product name]
---
Part 2: Full Article
Complete markdown ready to paste into any blog platform.
Part 3: Supplementary Data
FAQ schema questions, image suggestions (comparison screenshots), products featured with affiliate URLs, next steps.
Input Schema
product_a:# REQUIRED — the primary affiliate productname:stringdescription:stringreward_value:string# e.g., "30% recurring"url:string# Affiliate linkreward_type:string# "recurring" | "one-time" | "tiered"cookie_days:numbertags:string[]product_b:# REQUIRED — the product to compare againstname:stringurl:string# Affiliate link if available, otherwise homepagedescription:string# Optional — will research if missingproduct_c:# OPTIONAL — third product for 3-way comparisonname:stringurl:stringdescription:stringtarget_keyword:string# OPTIONAL — default: "[product_a] vs [product_b]"tone:string# OPTIONAL — "conversational" | "technical" | "professional"# Default: "conversational"angle:string# OPTIONAL — "clear-winner" | "it-depends" | "upset"# Default: auto-detected from research
Output Schema
article:title:stringslug:string# e.g., "heygen-vs-synthesia"meta_description:stringtarget_keyword:stringformat:"comparison"content:string# Full markdown articleword_count:numberwinner:string# Name of the recommended productcomparison:dimensions:string[]# The features compareddimension_winners:# Who won each dimension-dimension:stringwinner:string# "product_a" | "product_b" | "tie"products_featured:-name:stringurl:stringrole:string# "primary" | "compared"reward_value:stringseo:secondary_keywords:string[]faq_questions:-question:stringanswer:stringimage_suggestions:-description:stringalt_text:string
Output Format
Present as three sections:
SEO Metadata — fenced block for copy-paste into WordPress/Yoast/Ghost
Supplementary — FAQ schema, image suggestions, products list, next steps
Target word count: 2,500-3,500 words. Longer for complex SaaS tools with many features.
Error Handling
Only 1 product provided: Auto-search for top 2 competitors. Inform user: "I found [B] and [C] as the main competitors — using those. Let me know if you want different ones."
No affiliate link for product_b: Use homepage URL. Note in output: "No affiliate link for [B] — using homepage. You can still earn on [A] clicks."
Products in completely different categories: Stop and ask — comparing an email tool to a project management tool is not useful.
Controversial product (MLM, scam accusations): Add warning note: "This product has mixed reputation signals. Review carefully before publishing — your credibility is at stake."
Tie on most dimensions: Use "it depends" angle. Never force a winner that isn't real — readers trust honest comparisons more.
Examples
Example 1: Two affiliate products
User: "Write a comparison post: HeyGen vs Synthesia"
Action: product_a=HeyGen (affiliate), product_b=Synthesia (affiliate), research both, detect angle=clear-winner (or it-depends based on data), write 3,000-word comparison targeting "heygen vs synthesia".
Example 2: Chained from S1
User: "Compare it with its top competitor"
Context: S1 returned HeyGen as recommended_program
Action: product_a=HeyGen from S1 output, web_search for top competitor, write comparison.
Example 3: Three-way comparison
User: "HeyGen vs Synthesia vs Colossyan comparison post"
Action: Three-way comparison, determine winner + runners-up, write 3,500-4,000 word article with side-by-side table.
Example 4: Underdog angle
User: "Compare Ahrefs vs Ubersuggest — I'm promoting Ubersuggest"
Action: product_a=Ubersuggest (affiliate), product_b=Ahrefs, angle=upset (lesser-known vs market leader), frame Ubersuggest as the budget-friendly winner for specific use cases.
References
shared/references/ftc-compliance.md — FTC disclosure text. Read in Step 5.
shared/references/affitor-branding.md — Do NOT add Affitor branding to blog body. Only applies to landing pages.
shared/references/affiliate-glossary.md — Terminology reference.
From how-to-tutorial-writer
How-To Tutorial Writer
Write practical, step-by-step tutorial blog posts that solve a real reader problem and naturally recommend affiliate products as the best tool for the job. Uses the "problem → solution → tool" pattern: establish what the reader wants to do, show them exactly how to do it, and position the affiliate product as the right instrument for each step.
When to Use
User wants to create educational content that drives affiliate conversions indirectly
User says "how to", "tutorial", "guide", "walkthrough", "step by step"
User wants to rank for "how to [task]" keywords (high traffic, lower competition than "best" keywords)
User has a product that is best understood through demonstration, not just description
User wants to build authority and trust in a niche before making a sale
Workflow
Step 1: Define the Tutorial Goal
Parse the request to identify:
The task: what the reader wants to accomplish (e.g., "create AI videos for YouTube")
The tool: which affiliate product enables the task (e.g., HeyGen)
The audience: who is asking this question (beginner / intermediate / advanced)
The end state: what the reader will have built or achieved by the end
If the task is vague ("write a tutorial about HeyGen"), default to the most popular use case for that tool — search for it: "[product name] tutorial" OR "how to use [product name]" — pick the highest-traffic query.
Tutorial types — detect from user's phrasing:
Signal
Type
Format
"How to get started", "beginners guide", "first time"
quickstart
5-8 steps, 1,500-2,000 words
"Step by step", "complete guide", "full tutorial"
deep-dive
8-15 steps, 2,500-3,500 words
"How to [specific feature]"
feature-focus
5-8 steps on one feature, 1,500-2,000 words
"How to [goal] without [product]" → redirect to product
problem-solution
6-10 steps, 2,000-2,500 words
Step 2: Research the Tutorial Content
Use web_search to gather:
The actual step-by-step process for accomplishing the task
Common mistakes or gotchas beginners encounter
Official documentation or help articles for the product
What the top-ranking tutorials already cover (identify gaps)
Search queries:
"how to [task] with [product]" — understand existing guides
"[product] tutorial [year]" — find current instructions
"[product] [feature] settings" — get accurate step names
"[task] mistakes beginners make" — find pain points to address
Content accuracy rule: Never invent product UI details. If unsure about a specific button name or menu path, describe the action generically ("navigate to the settings section") rather than naming something that may be wrong.
Step 3: Plan the Tutorial Structure
Map every section before writing. A well-structured tutorial follows this flow:
What readers need before starting (Prerequisites):
Account requirements (free plan vs. paid tier needed for tutorial steps)
Technical requirements
Assets they should have ready (images, scripts, data)
The steps themselves:
Each step = one atomic action (not a cluster of actions)
Steps should be numbered, not just bulleted
Each step has: action verb headline + explanation + expected result
Decision points get callout boxes: "If you see X, do Y instead"
Affiliate integration points (natural, not forced):
In the Prerequisites section: "You'll need a [Product] account. Sign up free here →"
At the step where the product's key feature is used: contextual CTA
After showing the final result: "You just did X with [Product]. Here's what else it can do: [affiliate CTA]"
In the "Next Steps" section at the end
Rule: Never interrupt a step sequence with a hard sell. CTAs belong at natural pause points — before the reader starts, after they finish a major phase, and at the very end.
Step 4: Write the Full Tutorial
Title formula:
How to [Task] with [Product]: Step-by-Step Guide ([Year])
How to [Task]: A Beginner's Guide Using [Product]
[Goal]: How to [Task] in [N] Steps (Even If You're New to [Topic])
Introduction (150-200 words):
Open with the reader's problem/desire (not with "In this tutorial...")
State the end result: "By the end, you'll have [specific output]"
Mention how long it takes and what level of experience is needed
One-sentence product intro: "[Product] is what makes this possible — here's how to use it."
Affiliate CTA if they need to sign up before starting
Prerequisites section:
**What you need before starting:**
- A [Product] account (free plan works / Pro plan required for [specific feature])
→ [Create your free account →](affiliate_url)
- [Any other required tool/asset/knowledge]
- Estimated time: [X minutes]
Step-by-Step Section:
Write each step as:
## Step [N]: [Action Verb] + [What You're Doing]
[2-4 sentence explanation of what this step does and why it matters]
1. [Specific sub-action with exact UI element names where known]
2. [Next sub-action]
3. [Continue...]
**You should see:** [description of what the expected result looks like]
> **Note:** [Optional callout for a common mistake or alternative path]
Result/Output Section:
After all steps, show what the reader has built:
Describe the final output in concrete terms
Include what they can do with it now
Contextual affiliate CTA: "Now that you've [achieved X], you can use [Product]'s [feature] to take it further."
Troubleshooting Section (optional, high SEO value):
3-5 common issues readers might hit:
"Error: [X]" → "This usually means [Y]. Fix it by [Z]."
"Step 4 doesn't work if [condition]" → "Instead, try [alternative]."
Next Steps Section:
What to do with the result
Related features of the product to explore next
Related tutorials (if user has other content)
Final strong affiliate CTA
FAQ Section (4-6 questions):
"Do I need a paid plan for [product] to follow this tutorial?"
"How long does [task] take?"
"Can I do this without [product]?"
"Is [product] free to use for [task]?"
"What should I do if [common problem]?"
Step 5: Format Output
Part 1: SEO Metadata
---
SEO METADATA
---
Title: [title]
Slug: how-to-[task-slug]
Meta Description: [150-160 chars — include "how to", the task, and product name]
Target Keyword: how to [task] with [product]
Secondary Keywords: [product] tutorial, [task] guide, how to [task] [year], [product] for beginners
Word Count: [actual]
Format: how-to
Steps: [N]
---
Part 2: Full Article
Complete markdown ready to publish.
Part 3: Supplementary Data
FAQ schema questions/answers
Screenshot suggestions (one per major step)
Products featured with affiliate URLs
Video script outline (optional — if user wants to turn this into a YouTube tutorial)
Input Schema
task:# REQUIRED — what the reader wants to accomplishdescription:string# e.g., "create an AI avatar video for YouTube"goal:string# The end state — "a published YouTube video with AI avatar"product:# REQUIRED — the affiliate tool that enables the taskname:stringdescription:stringreward_value:stringurl:string# Affiliate linkreward_type:stringcookie_days:numbertags:string[]tutorial_type:string# OPTIONAL — "quickstart" | "deep-dive" | "feature-focus" | "problem-solution"# Default: auto-detected from task complexityaudience_level:string# OPTIONAL — "beginner" | "intermediate" | "advanced"# Default: "beginner" (wider audience)supporting_tools:object[]# OPTIONAL — other tools used alongside the primary product-name:stringurl:stringpurpose:string# What role this tool plays in the tutorialtarget_keyword:string# OPTIONAL — override default "how to [task]" keywordtone:string# OPTIONAL — "conversational" | "technical"# Default: "conversational"include_video_outline:boolean# OPTIONAL — generate a YouTube video script outline alongside# Default: false
Output Schema
article:title:stringslug:stringmeta_description:stringtarget_keyword:stringformat:"how-to"tutorial_type:string# quickstart | deep-dive | feature-focus | problem-solutioncontent:stringword_count:numbersteps:-number:numberheadline:string# Step headingaffiliate_cta:boolean# Whether this step contains a CTAproducts_featured:-name:stringurl:stringrole:string# "primary-tool" | "supporting-tool"reward_value:stringcta_placement:string[]# Which sections contain CTAs for this productseo:secondary_keywords:string[]faq_questions:-question:stringanswer:stringscreenshot_suggestions:# One per major step — high-value for tutorials-step:numberdescription:stringalt_text:stringvideo_outline:# Only if include_video_outline=truetitle:stringhook:string# First 30 seconds scriptchapters:-timestamp:string# e.g., "0:00"title:stringdescription_for_youtube:stringtags:string[]
Output Format
Present as three sections:
SEO Metadata — fenced block for copy-paste into CMS
Target word count: 1,500-3,500 words based on tutorial type. Quality over length — do not pad steps.
Error Handling
Task too vague ("tutorial about email marketing"): Ask: "What specific task should the tutorial walk through? For example: 'how to set up an automated welcome email sequence in Mailchimp'."
No product provided: "Which product should this tutorial feature? If you don't have one in mind, I can suggest the best tool for [task]."
Product feature requires paid plan: Note clearly in Prerequisites section and add affiliate CTA. Do not hide paid requirements.
Task not suited for a single tutorial (too complex): "This task has multiple phases — I'll write a [quickstart] tutorial focused on [first phase]. Let me know if you want additional tutorials for the other phases."
Product UI has changed: Use generic action descriptions where UI details are uncertain. Add note: "Screenshots may vary slightly from your current version of [Product]."
Examples
Example 1: Product-driven tutorial
User: "Write a tutorial on how to create AI avatar videos with HeyGen"
Action: task="create AI avatar video", product=HeyGen, audience=beginner, tutorial_type=deep-dive, write 12-step guide targeting "how to create ai avatar video with heygen".
Example 2: Goal-driven tutorial
User: "Write a how-to guide for automating social media posts"
Action: web_search for best social media automation tool, present to user for affiliate selection (or auto-select if S1 already ran), write problem-solution tutorial targeting "how to automate social media posts".
Example 3: Feature-specific tutorial
User: "Tutorial on how to use Semrush keyword magic tool"
Action: task="find keywords with Semrush Keyword Magic Tool", tutorial_type=feature-focus, write focused 8-step guide, affiliate CTAs at start and end.
Example 4: With video outline
User: "Write a HeyGen tutorial that I can also use as a YouTube video script"
Action: Same as Example 1 but with include_video_outline=true, output includes full video description, chapter markers, and hook script.
References
shared/references/ftc-compliance.md — FTC disclosure text. Insert after title.
shared/references/affiliate-glossary.md — Terminology reference.
From listicle-generator
Listicle Generator
Write "Top N Best [Category]" roundup articles that rank on Google, capture featured snippets, and drive affiliate conversions across multiple products. Each list entry is a self-contained mini-review with features, pricing, pros/cons, audience fit, and a CTA. The article is structured to win both the featured snippet and the "People Also Ask" box.
When to Use
User wants to cover an entire product category with multiple affiliate links
User says "best", "top", "roundup", "list of", or mentions a number with a category
User wants to capture high-volume generic keywords ("best email marketing tools") vs. specific product searches
User has multiple affiliate programs in the same category and wants one article to cover them all
User wants an article format that benefits from regular updates (add/remove products as market evolves)
Workflow
Step 1: Determine List Parameters
Parse the user's request for:
Category: what type of product (e.g., "email marketing tools", "AI video generators")
List size (N): explicitly stated number, or auto-select based on category depth
Niche/specialized categories: 5-7 products
Broad/competitive categories: 7-10 products
Very broad (e.g., "project management tools"): 10-12 products
Target audience: inferred from category + any context clues (beginners, enterprises, specific industries)
Year: always use current year in the title for freshness signal
If no affiliate product is specified:
Ask: "Which product are you promoting? I'll feature it prominently in the list."
If user says to proceed anyway, generate a balanced list and note where they should insert their affiliate link.
Step 2: Research the Product Landscape
Use web_search to build the product list:
Seed query: "best [category] tools [year]" site:g2.com OR site:capterra.com OR site:trustradius.com
Validate with traffic: "best [category]" — check autocomplete for common phrasings
Evaluation Criteria (H2, before the list):
List the 4-6 criteria used to rank products. This builds credibility and explains why your #1 pick is #1.
Example criteria: ease of use, feature depth, pricing value, customer support quality, integration ecosystem, scalability.
Individual Product Entries:
Write each entry following the per-entry structure above. Vary the opening sentence — don't start every entry the same way. Include specific, verifiable details (actual feature names, real pricing tiers, concrete limitations) — not generic praise.
Master Comparison Table:
After all product entries, include a comprehensive feature matrix:
How to Choose (H2, 300-400 words):
A decision framework for readers who are still unsure after reading the list:
"If you're a beginner with a tight budget → [Product X]"
"If you need [specific feature] → [Product Y]"
"If you're scaling a team → [Product Z]"
"If you're migrating from [common competitor] → [Product A]"
FAQ Section (5-7 questions):
"What is the best [category] tool?"
"What is the cheapest [category] tool?"
"What [category] tool has the best free plan?"
"Is [top product] worth it?"
"How do I choose [category] software?"
Final Recommendation (H2):
Restate the #1 pick with a 2-sentence reason
Give a backup pick for a different audience
Strong CTA: **Start with [Product] — it's free to try.** [Get started →](affiliate_url)
Step 5: Format Output
Part 1: SEO Metadata
---
SEO METADATA
---
Title: [title with year and number]
Slug: best-[category-slug]-tools
Meta Description: [150-160 chars, include number + year + top product name]
Target Keyword: best [category] tools
Secondary Keywords: [category] software, [product 1] review, [product 2] alternatives, top [category] [year]
Word Count: [actual]
Format: listicle
Products: [N]
---
Part 2: Full Article
Complete markdown ready to publish.
Update reminder: "This article should be refreshed every 6 months to keep rankings."
Input Schema
category:# REQUIRED — product category to covername:string# e.g., "AI video generators", "email marketing platforms"tags:string[]# Optional — helps with research targetingprimary_product:# OPTIONAL but recommended — the affiliate product to feature at #1name:stringdescription:stringreward_value:stringurl:string# Affiliate linkreward_type:stringcookie_days:numbertags:string[]additional_affiliates:# OPTIONAL — other affiliate products to include in the list-name:stringurl:stringreward_value:stringlist_size:number# OPTIONAL — how many products (5-12). Default: auto-select.target_audience:string# OPTIONAL — "beginners" | "enterprise" | "freelancers" | "agencies"# Default: inferred from categoryyear:number# OPTIONAL — year for title/freshness. Default: current year.target_keyword:string# OPTIONAL — override default keywordtone:string# OPTIONAL — "conversational" | "professional". Default: "conversational"
Output Schema
article:title:stringslug:stringmeta_description:stringtarget_keyword:stringformat:"listicle"content:stringword_count:numberproduct_count:numberproducts_featured:-name:stringurl:stringrank:number# Position in the list (1 = top)role:string# "affiliate-primary" | "affiliate-secondary" | "editorial"reward_value:stringseo:secondary_keywords:string[]at_a_glance_table:string# Markdown table — can be extracted for featured snippetfaq_questions:-question:stringanswer:stringimage_suggestions:-description:stringalt_text:stringplacement:stringupdate_schedule:recommended_frequency:string# "every 6 months" for most categoriesitems_to_check:string[]# What to verify on next update
Output Format
Present as three sections:
SEO Metadata — fenced block for copy-paste into blog CMS
Target word count: 3,000-5,000 words depending on list size (aim for 400-500 words per product entry plus structural sections).
Error Handling
No category provided: "What category of products should this listicle cover? For example: 'best email marketing tools' or 'top AI writing assistants'."
No affiliate product specified: Generate a balanced editorial list. Flag in output: "Affiliate link not set — insert your tracking URL for [top pick] before publishing."
Category too broad ("best software"): Narrow it. Ask: "That's very broad — can you narrow it down? For example: 'best project management software for small teams'."
Category too niche (fewer than 5 good products exist): Reduce list size and be transparent: "Only 5 strong options exist in this niche — I've included all of them."
Product research returns low-quality results: Use web_search with 3 different query variations before giving up. Fallback: base entries on official product pages + G2 reviews.
Examples
Example 1: Standard category listicle
User: "Write a top 10 best AI video tools article"
Action: category="AI video generators", list_size=10, research top tools, position user's affiliate at #1, write 4,500-word listicle targeting "best ai video tools [year]".
Example 2: Niche with specific audience
User: "Best email marketing tools for e-commerce, I'm promoting Klaviyo"
Action: category="email marketing for e-commerce", primary_product=Klaviyo, target_audience="e-commerce store owners", list_size=7, write article with Klaviyo at #1.
Example 3: Alternatives format
User: "Write a 'best alternatives to Mailchimp' article"
Action: Treat as listicle where Mailchimp is the incumbent being replaced. Title: "7 Best Mailchimp Alternatives in [Year] (Cheaper + More Powerful)". Position user's affiliate at #1 as top alternative.
Example 4: Chained from S1
User: "Now write a roundup post for the category"
Context: S1 returned Semrush in the SEO tools category
Action: category=SEO tools, primary_product=Semrush, auto-select list_size=8, write "Best SEO Tools [year]" with Semrush at #1.
References
shared/references/ftc-compliance.md — FTC disclosure text. Read before Step 4.
shared/references/affiliate-glossary.md — Terminology reference.
From viral-post-writer
Viral Post Writer
Write high-converting social media posts that promote affiliate products without feeling salesy. Each post uses proven viral frameworks, is tailored to the target platform, and includes proper FTC disclosure.
Stage
This skill belongs to Stage S2: Content
When to Use
User wants to promote an affiliate product on social media
User asks for LinkedIn posts, X/Twitter threads, Reddit posts, or Facebook posts
User has picked a program (from S1 or manually) and needs content
User wants "viral" or "engaging" social media content for affiliate marketing
User asks how to naturally promote a product on a specific platform
Input Schema
{
product: { # (required) Product to promote — from S1 output or user-provided
name: string # "HeyGen"
description: string # What the product does (1-2 sentences)
reward_value: string # "30%" (for context — never shown in post)
url: string # Product website or affiliate link
}
platform: string # (required) "linkedin" | "x" | "reddit" | "facebook" | "all"
angle: string # (optional, default: auto-selected) Content angle — see Viral Frameworks
tone: string # (optional, default: "conversational") "conversational" | "professional" | "casual" | "storytelling"
audience: string # (optional, default: inferred from platform) Target audience description
personal_experience: string # (optional) User's real experience with the product — makes content authentic
cta_style: string # (optional, default: "soft") "soft" | "direct" | "question"
}
Workflow
Step 1: Gather Context
If not clear from conversation:
What product are they promoting? (Check if S1 ran earlier — use recommended_program from context)
Which platform? (If "all", generate for LinkedIn + X + Reddit)
Any personal experience with the product? (Authentic stories convert 3-5x better)
If user just says "write a post for HeyGen" → default to LinkedIn, conversational tone, soft CTA.
If product details are missing, use web_search "[product name] features pricing" to research.
Step 2: Research the Product
Even if product info is provided, do a quick web_search to find:
Recent product updates or launches (recency = virality)
Common pain points the product solves (hook material)
Competitor comparisons (contrast = engagement)
Real user testimonials or reviews (social proof)
Extract 2-3 specific details — exact numbers, real features, concrete use cases. Generic "this tool is amazing" posts don't go viral.
Step 3: Pick the Viral Framework
Select from references/viral-frameworks.md based on product + platform + angle.
If user specified an angle, use that framework. Otherwise, auto-select:
Platform
Best Default Framework
LinkedIn
Transformation Story or Contrarian Take
X
Thread (Problem → Solution) or Hot Take
Reddit
Genuine Recommendation or Problem-Solve
Facebook
Before/After or Listicle
Step 4: Write the Post
Apply the selected framework from references/viral-frameworks.md.
Critical rules:
Hook in first line — reader decides in 1.5 seconds whether to keep reading
Specific > generic — "saved 4 hours/week on video editing" beats "great tool"
Story > pitch — wrap the recommendation in a narrative or discovery
Platform-native format — see references/platform-specs.md for formatting rules
One CTA only — don't overwhelm. One clear next step
FTC compliance — include disclosure per shared/references/ftc-compliance.md placement rules
Never do:
Start with "I'm excited to share..." (LinkedIn death sentence)
Use "game-changer", "revolutionary", "hands down the best" (empty superlatives)
Put the link in the main post body on LinkedIn (algorithm penalty)
Hard-sell in the first sentence
Mention commission rates or that you're an affiliate (FTC requires disclosure, not details)
Include "Powered by Affitor" branding (see shared/references/affitor-branding.md)
Step 5: Add FTC Disclosure
Per platform (from shared/references/ftc-compliance.md):
LinkedIn: "#ad | Affiliate link" at the end of the post body
X: "#ad" in the tweet containing the link (usually last tweet in thread)
Reddit: "Full disclosure: affiliate link" at the bottom
Facebook: "#ad | Affiliate link" at the end
Step 6: Format Output
Present the post ready to copy-paste. Include:
The post content (formatted for the platform)
Where to place the affiliate link
Best time to post (platform-specific)
2-3 engagement tips for the specific platform
Output Schema
Other skills can consume these fields from conversation context:
{
posts: [
{
platform: string # "linkedin" | "x" | "reddit" | "facebook"
framework: string # Which viral framework was used
content: string # The full post text, ready to copy-paste
link_placement: string # Where to put the affiliate link
disclosure: string # FTC disclosure text included
hashtags: string[] # Suggested hashtags (if applicable)
best_time: string # Best posting time for this platform
}
]
product_name: string # For downstream skill chaining
content_angle: string # The angle used (for consistency across content)
}
Output Format
## Viral Post: [Product Name] on [Platform]
**Framework:** [Name of viral framework used]
**Angle:** [The content angle]
---
### Post Content
[Full post text, formatted for the platform. Ready to copy-paste.]
---
### Posting Guide
| Detail | Value |
|--------|-------|
| Link placement | [Where to put the link] |
| Best time to post | [Platform-specific optimal time] |
| Expected engagement | [What metrics to watch] |
### Engagement Tips
1. [Tip specific to this platform + content type]
2. [Tip about responding to comments]
3. [Tip about amplifying reach]
### Variations
Want more options? Try these angles:
- **[Framework 2]:** [1-line preview of alternative approach]
- **[Framework 3]:** [1-line preview of alternative approach]
When platform = "all", generate separate sections for LinkedIn, X, and Reddit.
Error Handling
No product info: Ask the user what product they want to promote. Suggest running affiliate-program-search first.
Unknown platform: Default to LinkedIn. Mention available platforms.
No personal experience: Generate research-based content. Flag that personal stories convert better and suggest the user adds their own experience.
Product has no public info: Use web_search to find product details. If truly nothing found, ask user to describe the product.
Controversial product: If the product has significant negative reviews or ethical concerns, flag this to the user and suggest adjusting the angle.
Examples
Example 1:
User: "Write a LinkedIn post promoting HeyGen"
→ Research HeyGen (AI video, 30% recurring, 60-day cookie)
→ Select "Transformation Story" framework for LinkedIn
→ Write: hook about video creation pain → discovered HeyGen → specific result → soft CTA
→ Link in first comment, FTC disclosure in post body
Example 2:
User: "Create an X thread about Semrush for SEO marketers"
→ Research Semrush features + recent updates
→ Select "Thread: Problem → Solution" framework
→ Write: 5-7 tweet thread, hook → pain points → how Semrush solves each → results → CTA in last tweet
→ FTC "#ad" in the tweet with the link
Example 3:
User: "I've been using Notion for 2 years, help me write a Reddit post"
→ Use personal experience as the core (authenticity = Reddit gold)
→ Select "Genuine Recommendation" framework
→ Write: problem context → how they discovered Notion → specific workflows → natural mention
→ "Full disclosure: affiliate link" at bottom
→ Recommend posting in r/productivity or r/Notion
Example 4:
User: "Promote GetResponse on all platforms"
→ Research GetResponse (email marketing, 33% recurring)
→ Generate 3 posts: LinkedIn (Transformation Story), X (Thread), Reddit (Genuine Recommendation)
→ Each tailored to platform format, audience, and link rules
References
references/viral-frameworks.md — the viral content frameworks with templates and examples
references/platform-specs.md — character limits, formatting, optimal posting times per platform
shared/references/ftc-compliance.md — FTC disclosure requirements and placement rules
shared/references/affitor-branding.md — when to include/exclude Affitor branding (social = NO branding)
Write Reddit posts and comments that earn upvotes by leading with genuine value.
The affiliate recommendation comes second — after trust is built. Reddit users
have a finely tuned spam detector. This skill helps affiliates write like Redditors,
not marketers.
Stage
This skill belongs to Stage S2: Content
When to Use
User wants to drive affiliate traffic from Reddit
User wants to recommend a product in a relevant subreddit
User is active in a community and wants to add a helpful product mention
User has a genuine experience with a product and wants to share it naturally
User asks how to participate on Reddit without getting banned for self-promotion
Input Schema
{
product: {
name: string # (required) "Notion"
description: string # (optional) What the product does
url: string # (optional) Affiliate link — used in disclosure only
reward_value: string # (optional) Commission — never revealed in post
}
subreddit: string # (optional) Target subreddit, e.g., "r/productivity"
post_type: string # (optional, default: auto) "post" | "comment_reply" | "ama_style"
trigger_question: string # (optional) Specific Reddit question or post you're replying to
personal_experience: string # (optional) Real experience with the product to use as anchor
audience: string # (optional) Who reads this subreddit — "students", "developers"
tone: string # (optional, default: "genuine") "genuine" | "analytical" | "casual"
problem_focus: string # (optional) The specific problem this post addresses
}
Workflow
Step 1: Understand Reddit Culture First
Before writing, confirm the target subreddit context. If subreddit is provided,
use web_search "reddit r/[subreddit] rules affiliate" to check:
Are affiliate links explicitly banned? (many subreddits ban them outright)
What post formats are most common? (links, text posts, discussions)
What gets upvoted vs. downvoted in this community?
Is there a community expectation of neutrality or personal experience?
Subreddits that generally tolerate product mentions:
r/productivity, r/entrepreneur, r/Entrepreneur, r/sidehustle, r/personalfinance,
r/freelance, r/marketing, r/SEO, r/webdev, r/startups, r/smallbusiness
Subreddits that are extremely ban-happy about promotion:
r/frugal, r/cscareerquestions, r/AskReddit, r/personalfinance (strict on direct links)
If subreddit bans affiliate links: do NOT write a post with a link. Instead, write
a post that mentions the product by name with a note like "Search for [product]
affiliate program if interested." Disclose and redirect.
Step 2: Determine the Post Type
Option A — Original Post (new thread):
Best when there's no existing discussion. Write a story, question, or breakdown that
organically leads to a product mention.
"How I went from X to Y — the exact tools I used"
"Anyone else use [product] for [use case]? Here's my 6-month review"
"I tested 5 [category] tools so you don't have to — honest breakdown"
Option B — Comment Reply (responding to an existing post):
Highest trust format. Someone asks "what tool do you use for X?" and you reply helpfully.
Write a substantive answer that doesn't mention the product until the 3rd+ paragraph
Add value even without the product mention — if removed, the comment should still be helpful
Product mention: "Personally, I use [product] and it's been solid for [specific use case]"
Option C — AMA-Style / Experience Share:
"I've been doing [X] for [N] years. Happy to share what's worked."
Opens conversation, positions creator as authority
Product naturally comes up when people ask "what tools do you use?"
If trigger_question is provided → use Option B. Otherwise, default to Option A.
Step 3: Research Product and Find Reddit-Specific Angles
Use web_search "reddit [product name] review" to find:
What real Reddit users are saying about the product (use their language)
Common objections raised on Reddit (address these proactively)
How competitors are discussed (context for framing)
Questions people ask that your post can answer
Also use web_search "reddit [problem space] best tools" to understand:
What alternatives Redditors currently recommend
How to frame your recommendation as additive, not replacing their preferences
What not to say (phrases that get downvoted in this community)
Step 4: Write the Post
Reddit post structure that converts:
Title (for new posts): specific, searchable, sounds like a real person's question or story
Good: "I tried 4 project management tools over 2 years — here's what I actually use now"
Bad: "The BEST productivity tool I've ever used!! (link in post)"
Good: "[6 months update] How I finally stopped context-switching between apps"
Opening paragraph: establish credibility or relatability. NO product mention here.
"I've been freelancing for 3 years and I'm embarrassed by how long I tried to manage
everything in spreadsheets."
Body: share the actual useful content — your experience, the problem, what you tried.
This section should be valuable even without the product mention.
Product introduction (70-80% through the post): introduce naturally.
"Eventually I landed on [product] and I've stuck with it for [X months]."
Specific use case: what exactly you use it for, not vague praise
ONE honest con: "It's not perfect — the mobile app is weak — but for desktop work
it's exactly what I needed." Cons dramatically increase trust.
FTC disclosure (at the bottom):
"Full disclosure: the link in my profile leads to an affiliate link. No extra cost
to you, and I would recommend this tool regardless."
Or if not posting a link: "Not affiliated, just a genuine fan."
Per shared/references/ftc-compliance.md — disclosure is required for Reddit too.
Closing: invite discussion, not clicks.
"Happy to answer questions about my workflow in the comments."
Ask a question back: "What does your current setup look like?"
Step 5: Anti-Spam Checklist
Before finalizing, run through this checklist:
Post adds value even if the product mention is removed
No exclamation marks in praise ("This tool is AMAZING!!")
No superlatives without evidence ("best tool I've ever used" → needs qualifier)
Affiliate link goes in comments or profile bio, NOT the main post body (most subreddits)
FTC disclosure is present and clear
Post doesn't read like a press release
Includes at least one real limitation or caveat about the product
Tone matches the subreddit (match voice to community)
Username context matters — new accounts posting affiliate content get instant downvotes
Step 6: Add Engagement Strategy
Reddit rewards participation, not broadcasting. Include:
Reply strategy: when commenters respond, how to keep conversation going naturally
Upvote path: what type of engagement to solicit (awards, saves, discussion)
Subreddit timing: best day/time to post in this subreddit
Cross-post candidates: which other subreddits this post could work in
Output Schema
{
post: {
type: string # "post" | "comment_reply" | "ama_style"
subreddit: string # "r/productivity"
title: string | null # For new posts only
body: string # Full post/comment body
link_placement: string # Where to put the affiliate link
disclosure: string # The disclosure text used
char_count: number
}
subreddit_notes: {
allows_affiliate_links: boolean
community_tone: string
best_post_time: string
cross_post_subreddits: string[]
}
engagement_tips: string[]
product_name: string
content_angle: string
}
Output Format
## Reddit Post: [Product Name]
**Type:** [New Post / Comment Reply / AMA-style]
**Target Subreddit:** [r/subreddit]
**Subreddit allows affiliate links:** [Yes / No / Link in comments only]
---
### Post Title (for new posts)
[Post title here]
---
### Post Body
[Full post text, formatted with Reddit markdown — use **bold**, *italic*, > quotes
as appropriate. Paragraphs separated by blank lines.]
---
### Link Placement
[Where to put the affiliate link — in post, in comment, or profile bio — and why]
---
### Subreddit Notes
- **Community tone:** [What vibe this subreddit has]
- **Best time to post:** [Day and time]
- **Watch out for:** [Specific rules or sensitivities]
---
### Cross-Post Opportunities
This post could also work in:
1. [r/subreddit2] — [why]
2. [r/subreddit3] — [why]
---
### Engagement Tips
1. [How to respond to likely comments]
2. [How to handle skeptics or downvotes]
3. [When to resurface this content]
---
### Alternative Angles
- **[Alternative 1]:** [Different framing for the same product]
- **[Alternative 2]:** [...]
Error Handling
Subreddit bans affiliate links outright: Flag this clearly. Rewrite without a direct
link — mention the product by name only, disclosure becomes "not affiliated, genuine rec."
Suggest building karma in the subreddit first with unrelated helpful posts.
No personal experience provided: Write from a researched perspective but clearly label
it as such ("Based on what I've seen from other users..."). Recommend the user add their
own experience before posting — fabricated personal experience on Reddit gets called out.
Product is controversial on Reddit: Acknowledge the controversy directly in the post.
"I know [product] gets mixed reviews here. Here's my honest take after [X months]..."
This signals authenticity and pre-empts downvote brigading.
User asks to mass-post the same content: Refuse this pattern. It's spam and will
result in account bans. Write unique versions for each subreddit.
New Reddit account: Add warning: "New accounts posting affiliate content are
immediately suspect. Build 3-6 months of genuine participation first."
Product has no free tier / high price: Don't hide this. State the price early.
"It's not cheap — $X/mo — but here's why it's been worth it for me."
Examples
Example 1:
User: "Write a Reddit post for r/productivity recommending Notion"
→ No trigger question → write original post
→ Title: "Finally stopped fighting my productivity system — 18 months with Notion"
→ Body: relatable struggle with scattered notes → what I tried → landed on Notion →
specific workflows I use → honest con (learning curve) → disclosure at bottom
→ Affiliate link in first comment, not the post body
Example 2:
User: "Someone on r/freelance asked 'what tools do you use to manage clients?' — write a reply"
→ Comment reply format, responding to that specific question
→ Open with the full workflow (3-4 tools) — Notion is one of several, not the only mention
→ Position Notion as the project management layer specifically
→ Mention it's in my profile link if they want the affiliate version
→ Disclosure at bottom of comment
Example 3:
User: "Write a Reddit post about HeyGen for r/videography"
→ Check r/videography rules — likely strict about promotion
→ Frame as experience share: "I tried AI avatar video for client work — here's my honest take"
→ Include real limitations prominently (not real filmmaker footage, uncanny valley)
→ Position as "works for explainer/promo videos, not cinema" — niche and honest
→ Disclosure present, link in comments only
References
shared/references/ftc-compliance.md — FTC disclosure requirements for Reddit
shared/references/platform-rules.md — Reddit-specific format and link rules
Write X/Twitter threads that deliver genuine value, build authority, and naturally
recommend affiliate products without feeling like ads. The best affiliate threads
get bookmarked for the insights and clicked for the product recommendation.
Stage
This skill belongs to Stage S2: Content
When to Use
User wants to promote an affiliate product on X/Twitter
User wants to build an audience on X while monetizing with affiliate links
User has expertise to share and wants to weave in a product recommendation
User asks how to write threads that convert without being spammy
User wants content that compounds (bookmarks → future impressions)
Input Schema
{
product: {
name: string # (required) "ConvertKit"
description: string # (optional) What it does
url: string # (optional) Affiliate link
reward_value: string # (optional) For context only — never shown in thread
}
thread_angle: string # (optional, default: auto) See Thread Frameworks below
expertise_area: string # (optional) Creator's area of authority — "email marketing", "SaaS growth"
audience: string # (optional) "founders", "freelancers", "content creators"
tone: string # (optional, default: "direct") "direct" | "educational" | "storytelling" | "contrarian"
tweet_count: number # (optional, default: 8) Number of tweets in thread: 5-15
personal_story: string # (optional) Real experience or result to anchor the thread
cta_style: string # (optional, default: "soft") "soft" | "direct" | "question"
}
Workflow
Step 1: Research the Product and Angle
Use web_search "[product name] best features use cases" and
web_search "[product name] vs [competitor]" to find:
The 2-3 strongest use cases (thread body material)
The problem it solves that X audiences care about
Any recent updates, launches, or news (recency boosts engagement)
Real user testimonials or case study numbers (third-party proof)
Also search web_search "site:twitter.com [product name] affiliate" to see what
existing threads look like — then do something different or better.
Step 2: Select the Thread Framework
Framework
Structure
Best For
Lessons Learned
"I used [product] for X months. Here's what I learned:" → 7 insights → CTA
Tools you've genuinely used
Problem → Solution
Hook pain → Agitate it → Introduce solution → Show how it solves each pain → CTA
High-awareness problems
Contrarian Take
"Everyone says [common advice]. I disagree. [product] changed my mind."
Standing out in crowded niches
Numbers Story
"From [before metric] to [after metric] using [product]. Here's how:" → step-by-step → CTA
When you have real results
How-to Tutorial
"How to [achieve outcome] with [product] in [timeframe]:" → step-by-step → CTA
Educational, drives bookmarks
Tool Stack
"My [role] tool stack in 2024: Thread on each → [product] gets its own deep-dive tweet → CTA
Multi-product threads
Myth Busting
"5 myths about [problem space] — and what actually works:" → each myth → [product] as the solution
High engagement, saves
Auto-select based on:
Has personal experience → Numbers Story or Lessons Learned
No personal experience → How-to Tutorial or Problem → Solution
Large audience, strong takes → Contrarian Take
Beginner-friendly product → How-to Tutorial
Step 3: Write the Hook Tweet (Tweet 1)
The hook tweet determines if anyone reads tweet 2. It must:
Promise a specific, tangible outcome ("how I 3x'd my email open rate")
Or state a bold, curiosity-generating claim ("most email marketing advice is wrong")
Or open a story loop ("6 months ago I had 400 email subscribers. Today I have 12,000.")
End with a signal that a thread follows: "A thread:" or "Here's how:" or "Thread 🧵"
Never start with: "I want to share...", "In this thread...", "Have you ever..."
Never use buzzwords as hooks: "game-changing", "revolutionary", "must-read"
Deliver a complete thought — readable as a standalone tweet
Build on the previous tweet — threads should reward people who read all the way
Include a specific detail — numbers, names, steps, not vague generalizations
Stay under 280 characters — hard limit. No tweet should require expanding
Use whitespace — line breaks between ideas, not wall-of-text tweets
Place the product recommendation at 60-70% through the thread (tweet 5-7 of 8-10).
It should feel discovered, not pitched:
"The tool that actually made this easy for me: [product name]"
"I tried 4 tools before finding [product]. Here's why it worked:"
"If I had to pick one tool for this: [product]"
Mention the product once prominently. A brief second mention in the CTA tweet is fine.
Step 5: Write the CTA Tweet (Last Tweet)
The CTA tweet should:
Summarize what the thread delivered
Recommend action (try the product, sign up, or check it out)
Include the affiliate link OR direct to bio for the link
Include FTC disclosure "#ad" per shared/references/ftc-compliance.md
Soft CTA example: "If you want to try [product], there's a free trial at [link]. I use it daily. #ad"
Direct CTA: "[Product] is how I [result]. Link to try it free: [link] #ad"
Step 6: Add Engagement Mechanics
Increase bookmark and retweet probability:
Add a summary tweet after the CTA: "TL;DR: [3 bullets from the thread]"
Summaries drive bookmarks from skimmers.
First reply (pinned under thread): "If you found this useful, follow me for more [topic]."
Engagement question somewhere in thread: "Which of these do you do already?
Drop your answer below." (Boosts reply count → algorithm boost)
Step 7: Format Output
Present tweets numbered and ready to paste. Include character count for each.
Flag any tweet at 250+ characters for potential trimming.
Output Schema
{
thread: [
{
tweet_number: number # 1, 2, 3...
content: string # Full tweet text
char_count: number # Character count
role: string # "hook" | "body" | "product_mention" | "cta" | "summary"
}
]
framework: string # Which framework was used
product_mention_tweet: number # Which tweet number introduces the product
disclosure_tweet: number # Which tweet has #ad
suggested_hashtags: string[] # 2-3 hashtags for the thread
best_time_to_post: string # Optimal posting time for X
product_name: string
content_angle: string
}
Output Format
## Twitter Thread: [Product Name]
**Framework:** [Name]
**Angle:** [Content angle]
**Tweets:** [N] tweets
---
**Tweet 1 (Hook)** — [X chars]
[Tweet content]
---
**Tweet 2** — [X chars]
[Tweet content]
---
*...continue for all tweets...*
---
**Tweet [N] (CTA)** — [X chars]
[Tweet content including #ad disclosure]
---
**Pinned Reply** — [X chars]
[Suggested first reply to boost engagement]
---
### Posting Guide
| Detail | Value |
|--------|-------|
| Best time to post | [Day + time] |
| First action after posting | [Like all tweets to boost visibility, pin reply] |
| Expected engagement pattern | [What metrics to watch] |
### Alternate Hook Options
- **[Hook style 2]:** "[Alternative tweet 1]"
- **[Hook style 3]:** "[Alternative tweet 1]"
Error Handling
No product info: Pull recommended_program from S1 context if available.
Otherwise ask what product they want to promote.
No personal experience: Write research-based content. Flag that personal
experience threads get 2-3x more engagement and suggest adding a real data point.
Thread feels too promotional too early: Move product mention to tweet 6+.
Add 1-2 more value tweets before the recommendation.
Content is too generic: Use web_search to add specific stats, quotes, or
examples. Replace every vague claim with a concrete number or example.
Tweet over 280 characters: Auto-split or suggest cut. Never truncate — the
full thought must fit in one tweet.
Creator has no X following: Add note: "New accounts should engage in replies
for 1-2 weeks before posting threads. Algorithm rewards accounts with engagement history."
Examples
Example 1:
User: "Write a Twitter thread promoting ConvertKit to freelancers"
→ Angle: "How I built a 3,000-subscriber email list as a freelancer — what worked"
→ Framework: Numbers Story
→ 9 tweets: Hook (metrics) → 6 lessons → ConvertKit mention at tweet 6 → CTA + #ad
→ Emphasis: free plan, creator-friendly, no bloat
Example 2:
User: "I want to write a contrarian thread about email marketing tools"
→ Angle: "Most people pick the wrong email platform. Here's why:"
→ Framework: Contrarian Take
→ Myths to bust: "Mailchimp is fine for beginners", "you need fancy automations"
→ Natural product mention: "After trying 5 tools, I settled on ConvertKit because..."
Example 3:
User: "8-tweet thread about HeyGen for video creators"
→ Framework: How-to Tutorial — "How to create a talking-head video without a camera"
→ Step-by-step: sign up → upload script → pick avatar → generate → edit → export
→ Product mention woven in at step 1 (that's HeyGen)
