composio-skills-reference/twitter-algorithm-optimizer/SKILL.md

---
name: twitter-algorithm-optimizer
description: Analyze and optimize tweets for maximum reach using Twitter's open-source algorithm insights. Rewrite and edit user tweets to improve engagement and visibility based on how the recommendation system ranks content.
license: AGPL-3.0 (referencing Twitter's algorithm source)
---

# Twitter Algorithm Optimizer

## When to Use This Skill

Use this skill when you need to:
- **Optimize tweet drafts** for maximum reach and engagement
- **Understand why** a tweet might not perform well algorithmically
- **Rewrite tweets** to align with Twitter's ranking mechanisms
- **Improve content strategy** based on the actual ranking algorithms
- **Debug underperforming content** and increase visibility
- **Maximize engagement signals** that Twitter's algorithms track

## What This Skill Does

1. **Analyzes tweets** against Twitter's core recommendation algorithms
2. **Identifies optimization opportunities** based on engagement signals
3. **Rewrites and edits tweets** to improve algorithmic ranking
4. **Explains the "why"** behind recommendations using algorithm insights
5. **Applies Real-graph, SimClusters, and TwHIN principles** to content strategy
6. **Provides engagement-boosting tactics** grounded in Twitter's actual systems

## How It Works: Twitter's Algorithm Architecture

Twitter's recommendation system uses multiple interconnected models:

### Core Ranking Models

**Real-graph**: Predicts interaction likelihood between users
- Determines if your followers will engage with your content
- Affects how widely Twitter shows your tweet to others
- Key signal: Will followers like, reply, or retweet this?

**SimClusters**: Community detection with sparse embeddings
- Identifies communities of users with similar interests
- Determines if your tweet resonates within specific communities
- Key strategy: Make content that appeals to tight communities who will engage

**TwHIN**: Knowledge graph embeddings for users and posts
- Maps relationships between users and content topics
- Helps Twitter understand if your tweet fits your follower interests
- Key strategy: Stay in your niche or clearly signal topic shifts

**Tweepcred**: User reputation/authority scoring
- Higher-credibility users get more distribution
- Your past engagement history affects current tweet reach
- Key strategy: Build reputation through consistent engagement

### Engagement Signals Tracked

Twitter's **Unified User Actions** service tracks both explicit and implicit signals:

**Explicit Signals** (high weight):
- Likes (direct positive signal)
- Replies (indicates valuable content worth discussing)
- Retweets (strongest signal - users want to share it)
- Quote tweets (engaged discussion)

**Implicit Signals** (also weighted):
- Profile visits (curiosity about the author)
- Clicks/link clicks (content deemed useful enough to explore)
- Time spent (users reading/considering your tweet)
- Saves/bookmarks (plan to return later)

**Negative Signals**:
- Block/report (Twitter penalizes this heavily)
- Mute/unfollow (person doesn't want your content)
- Skip/scroll past quickly (low engagement)

### The Feed Generation Process

Your tweet reaches users through this pipeline:

1. **Candidate Retrieval** - Multiple sources find candidate tweets:
   - Search Index (relevant keyword matches)
   - UTEG (timeline engagement graph - following relationships)
   - Tweet-mixer (trending/viral content)

2. **Ranking** - ML models rank candidates by predicted engagement:
   - Will THIS user engage with THIS tweet?
   - How quickly will engagement happen?
   - Will it spread to non-followers?

3. **Filtering** - Remove blocked content, apply preferences

4. **Delivery** - Show ranked feed to user

## Optimization Strategies Based on Algorithm Insights

### 1. Maximize Real-graph (Follower Engagement)

**Strategy**: Make content your followers WILL engage with

- **Know your audience**: Reference topics they care about
- **Ask questions**: Direct questions get more replies than statements
- **Create controversy (safely)**: Debate attracts engagement (but avoid blocks/reports)
- **Tag related creators**: Increases visibility through networks
- **Post when followers are active**: Better early engagement means better ranking

**Example Optimization**:
- ❌ "I think climate policy is important"
- ✅ "Hot take: Current climate policy ignores nuclear energy. Thoughts?" (triggers replies)

### 2. Leverage SimClusters (Community Resonance)

**Strategy**: Find and serve tight communities deeply interested in your topic

- **Pick ONE clear topic**: Don't confuse the algorithm with mixed messages
- **Use community language**: Reference shared memes, inside jokes, terminology
- **Provide value to the niche**: Be genuinely useful to that specific community
- **Encourage community-to-community sharing**: Quotes that spark discussion
- **Build in your lane**: Consistency helps algorithm understand your topic

**Example Optimization**:
- ❌ "I use many programming languages"
- ✅ "Rust's ownership system is the most underrated feature. Here's why..." (targets specific dev community)

### 3. Improve TwHIN Mapping (Content-User Fit)

**Strategy**: Make your content clearly relevant to your established identity

- **Signal your expertise**: Lead with domain knowledge
- **Consistency matters**: Stay in your lanes (or clearly announce a new direction)
- **Use specific terminology**: Helps algorithm categorize you correctly
- **Reference your past wins**: "Following up on my tweet about X..."
- **Build topical authority**: Multiple tweets on same topic strengthen the connection

**Example Optimization**:
- ❌ "I like lots of things" (vague, confuses algorithm)
- ✅ "My 3rd consecutive framework review as a full-stack engineer" (establishes authority)

### 4. Boost Tweepcred (Authority/Credibility)

**Strategy**: Build reputation through engagement consistency

- **Reply to top creators**: Interaction with high-credibility accounts boosts visibility
- **Quote interesting tweets**: Adds value and signals engagement
- **Avoid engagement bait**: Doesn't build real credibility
- **Be consistent**: Regular quality posting beats sporadic viral attempts
- **Engage deeply**: Quality replies and discussions matter more than volume

**Example Optimization**:
- ❌ "RETWEET IF..." (engagement bait, damages credibility over time)
- ✅ "Thoughtful critique of the approach in [linked tweet]" (builds authority)

### 5. Maximize Engagement Signals

**Explicit Signal Triggers**:

**For Likes**:
- Novel insights or memorable phrasing
- Validation of audience beliefs
- Useful/actionable information
- Strong opinions with supporting evidence

**For Replies**:
- Ask a direct question
- Create a debate
- Request opinions
- Share incomplete thoughts (invites completion)

**For Retweets**:
- Useful information people want to share
- Representational value (tweet speaks for them)
- Entertainment that entertains their followers
- Information advantage (breaking news first)

**For Bookmarks/Saves**:
- Tutorials or how-tos
- Data/statistics they'll reference later
- Inspiration or motivation
- Jokes/entertainment they'll want to see again

**Example Optimization**:
- ❌ "Check out this tool" (passive)
- ✅ "This tool saved me 5 hours this week. Here's how to set it up..." (actionable, retweet-worthy)

### 6. Prevent Negative Signals

**Avoid**:
- Inflammatory content likely to be reported
- Targeted harassment (gets algorithmic penalty)
- Misleading/false claims (damages credibility)
- Off-brand pivots (confuses the algorithm)
- Reply-guy syndrome (too many low-value replies)

## How to Optimize Your Tweets

### Step 1: Identify the Core Message
- What's the single most important thing this tweet communicates?
- Who should care about this?
- What action/engagement do you want?

### Step 2: Map to Algorithm Strategy
- Which Real-graph follower segment will engage? (Followers who care about X)
- Which SimCluster community? (Niche interested in Y)
- How does this fit your TwHIN identity? (Your established expertise)
- Does this boost or hurt Tweepcred?

### Step 3: Optimize for Signals
- Does it trigger replies? (Ask a question, create debate)
- Is it retweet-worthy? (Usefulness, entertainment, representational value)
- Will followers like it? (Novel, validating, actionable)
- Could it go viral? (Community resonance + network effects)

### Step 4: Check Against Negatives
- Any blocks/reports risk?
- Any confusion about your identity?
- Any engagement bait that damages credibility?
- Any inflammatory language that hurts Tweepcred?

## Example Optimizations

### Example 1: Developer Tweet

**Original**:
> "I fixed a bug today"

**Algorithm Analysis**:
- No clear audience - too generic
- No engagement signals - statements don't trigger replies
- No Real-graph trigger - followers won't engage strongly
- No SimCluster resonance - could apply to any developer

**Optimized**:
> "Spent 2 hours debugging, turned out I was missing one semicolon. The best part? The linter didn't catch it.
>
> What's your most embarrassing bug? Drop it in replies 👇"

**Why It Works**:
- SimCluster trigger: Specific developer community
- Real-graph trigger: Direct question invites replies
- Tweepcred: Relatable vulnerability builds connection
- Engagement: Likely replies (others share embarrassing bugs)

### Example 2: Product Launch Tweet

**Original**:
> "We launched a new feature today. Check it out."

**Algorithm Analysis**:
- Passive voice - doesn't indicate impact
- No specific benefit - followers don't know why to care
- No community resonance - generic
- Engagement bait risk if it feels like self-promotion

**Optimized**:
> "Spent 6 months on the one feature our users asked for most: export to PDF.
>
> 10x improvement in report generation time. Already live.
>
> What export format do you want next?"

**Why It Works**:
- Real-graph: Followers in your product space will engage
- Specificity: "PDF export" + "10x improvement" triggers bookmarks (useful info)
- Question: Ends with engagement trigger
- Authority: You spent 6 months (shows credibility)
- SimCluster: Product management/SaaS community resonates

### Example 3: Opinion Tweet

**Original**:
> "I think remote work is better than office work"

**Algorithm Analysis**:
- Vague opinion - doesn't invite engagement
- Could be debated either way - no clear position
- No Real-graph hooks - followers unclear if they should care
- Generic topic - dilutes your personal brand

**Optimized**:
> "Hot take: remote work works great for async tasks but kills creative collaboration.
>
> We're now hybrid: deep focus days remote, collab days in office.
>
> What's your team's balance? Genuinely curious what works."

**Why It Works**:
- Clear position: Not absolutes, nuanced stance
- Debate trigger: "Hot take" signals discussion opportunity
- Question: Direct engagement request
- Real-graph: Followers in your industry will have opinions
- SimCluster: CTOs, team leads, engineering managers will relate
- Tweepcred: Nuanced thinking builds authority

## Best Practices for Algorithm Optimization

1. **Quality Over Virality**: Consistent engagement from your community beats occasional viral moments
2. **Community First**: Deep resonance with 100 engaged followers beats shallow reach to 10,000
3. **Authenticity Matters**: The algorithm rewards genuine engagement, not manipulation
4. **Timing Helps**: Engage early when tweet is fresh (first hour critical)
5. **Build Threads**: Threaded tweets often get more engagement than single tweets
6. **Follow Up**: Reply to replies quickly - Twitter's algorithm favors active conversation
7. **Avoid Spam**: Engagement pods and bots hurt long-term credibility
8. **Track Your Performance**: Notice what YOUR audience engages with and iterate

## Common Pitfalls to Avoid

- **Generic statements**: Doesn't trigger algorithm (too vague)
- **Pure engagement bait**: "Like if you agree" - hurts credibility long-term
- **Unclear audience**: Who should care? If unclear, algorithm won't push it far
- **Off-brand pivots**: Confuses algorithm about your identity
- **Over-frequency**: Spamming hurts engagement rate metrics
- **Toxicity**: Blocks/reports heavily penalize future reach
- **No calls to action**: Passive tweets underperform

## When to Ask for Algorithm Optimization

Use this skill when:
- You've drafted a tweet and want to maximize reach
- A tweet underperformed and you want to understand why
- You're launching important content and want algorithm advantage
- You're building audience in a specific niche
- You want to become known for something specific
- You're debugging inconsistent engagement rates

Use Claude without this skill for:
- General writing and grammar fixes
- Tone adjustments not related to algorithm
- Off-Twitter content (LinkedIn, Medium, blogs, etc.)
- Personal conversations and casual tweets