/twitter-thread-writer

name: twitter-thread-writer
description: >
  Write X/Twitter threads that get bookmarked, shared, and drive affiliate clicks.
  Use this skill when the user asks about writing Twitter threads, X threads, tweet
  threads for affiliate marketing, or says "write a thread about X", "Twitter thread
  promoting X", "X thread for affiliate", "write tweets that go viral", "thread that
  sells without selling", "educational thread with affiliate CTA", "Twitter content
  for affiliate marketing", "how to promote X on Twitter", "write a thread my
  audience will bookmark", "tweet storm about affiliate product".
license: MIT
version: "1.0.0"
tags: ["affiliate-marketing", "content-creation", "social-media", "copywriting", "twitter", "threads"]
compatibility: "Claude Code, ChatGPT, Gemini CLI, Cursor, Windsurf, OpenClaw, any AI agent"
metadata:
  author: affitor
  version: "1.0"
  stage: S2-Content

Twitter Thread Writer

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"

**Hook formula:** [Specific outcome or bold claim] + [Credibility signal] + [Thread signal]

Step 4: Write the Body Tweets (Tweets 2-N)

Each tweet in the body must: 1. **Deliver a complete thought** — readable as a standalone tweet 2. **Build on the previous tweet** — threads should reward people who read all the way 3. **Include a specific detail** — numbers, names, steps, not vague generalizations 4. **Stay under 280 characters** — hard limit. No tweet should require expanding 5. **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