X/Twitter Growth Skill

Overview

Production-ready X/Twitter growth toolkit for analyzing tweet performance patterns, structuring optimal threads, and tracking engagement metrics. Designed for creators, marketers, and brand accounts looking to grow audience and engagement systematically through data-driven content decisions.

Clarify First

Before generating, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

• Deliverable: content performance audit, thread building, or growth review — selects which tool runs.
• Data or source content: exported tweet/analytics CSV (for audits) or the long-form draft (for threads) — required input for the chosen tool.
• Niche & audience: the one topic and who you're growing — shapes the hook and content pillars.
• Growth goal: followers, engagement, or replies — sets which benchmark and CTA to optimize for.

Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.

Quick Start

# Analyze tweet performance patterns from exported data
python scripts/tweet_analyzer.py tweets.csv

# Structure long-form content into optimal Twitter threads
python scripts/thread_builder.py content.txt --target-tweets 8

# Track follower growth, engagement rates, and best posting times
python scripts/growth_tracker.py analytics.csv --period monthly

Tools Overview

Tool	Purpose	Input	Output
tweet_analyzer.py	Performance pattern analysis	CSV with tweet data	Engagement patterns + insights
thread_builder.py	Thread structuring	Text file or JSON	Formatted thread + hooks
growth_tracker.py	Growth & engagement tracking	CSV with analytics data	Growth report + best times

Workflows

Workflow 1: Content Performance Audit

1. Export tweet data from X Analytics or third-party tool as CSV
2. Run tweet_analyzer.py to identify top-performing patterns
3. Identify which content types, formats, and topics drive engagement
4. Use insights to refine content strategy and posting schedule
5. Re-audit monthly to track improvement

Workflow 2: Thread Creation Pipeline

1. Draft long-form content in text or markdown format
2. Run thread_builder.py to split into optimal thread structure
3. Review hook tweet (tweet 1) for maximum engagement potential
4. Add call-to-action and engagement hooks per recommendations
5. Schedule using identified best posting times from growth_tracker.py

Workflow 3: Monthly Growth Review

1. Export analytics data for the period
2. Run growth_tracker.py --period monthly for growth metrics
3. Run tweet_analyzer.py on the same period for content insights
4. Compare engagement rates to prior period
5. Identify top 5 tweets and extract replicable patterns

Reference Documentation

See references/x-growth-playbook.md for comprehensive strategies covering:

• Content format frameworks
• Engagement optimization tactics
• Thread writing best practices
• Algorithm understanding
• Growth compounding strategies

Common Patterns

Pattern: Tweet Data CSV Format

tweet_id,text,created_at,impressions,engagements,likes,retweets,replies,type,has_media
T001,"Here's what I learned...",2025-06-15 09:30:00,15000,850,320,95,45,thread_start,no
T002,"Check out this chart",2025-06-14 14:00:00,8500,420,180,35,22,single,yes

Pattern: Thread Content Input

# How I Grew to 50K Followers in 6 Months

The biggest lesson was consistency over virality. Here's the complete breakdown...

[Section 1: Finding Your Niche]
Most creators make the mistake of being too broad. Pick one topic and go deep...

[Section 2: Content Pillars]
I built 3 content pillars that I rotate through each week...

Engagement Rate Benchmarks

Metric	Low	Average	Good	Excellent
Engagement Rate	< 1%	1-3%	3-6%	> 6%
Reply Rate	< 0.1%	0.1-0.5%	0.5-1%	> 1%
Retweet Rate	< 0.2%	0.2-1%	1-3%	> 3%
Thread Completion	< 20%	20-40%	40-60%	> 60%

Scope & Limitations

In Scope:

• Tweet performance pattern analysis from an exported CSV with tweet_analyzer.py, by content type, format and media
• Splitting long-form text into a thread with a hook tweet, in numbered or clean style, with thread_builder.py
• Follower growth, engagement rate and best posting time reports by day, week or month with growth_tracker.py
• A growth playbook covering ranking signals, the Hook-Value-CTA framework, thread writing, reply strategy and profile optimization

Out of Scope:

• Posting, scheduling, replying or pulling data from X; the tools have no API access
• LinkedIn content and analytics (see the suite under tools/linkedin/)
• Cross-platform social strategy and editorial calendars (see marketing/social-media-manager/)
• Paid X campaigns (see marketing/paid-ads/)

Important Caveats:

• All analysis runs on data you export from X Analytics or a third-party tool and save as CSV.
• The ranking signal weights in the playbook come from X's 2023 open-source release and are historical. The content type multipliers are practitioner heuristics. X's ranker has changed since, so treat these as hypotheses to test.
• The engagement benchmarks are general ranges. Rates vary by niche and account size, so your own past performance is the better baseline.