Agent skill

x-algorithm

X/Twitter For You feed ranking algorithm - optimize tweets for maximum reach

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/x-algorithm

Metadata

Additional technical details for this skill

tags
twitter, x, algorithm, social, ranking, engagement

SKILL.md

X Algorithm Skill

Optimize tweets and threads for the X (Twitter) For You feed algorithm.

How the Algorithm Works

The X For You feed uses a Grok-based Phoenix transformer that predicts engagement probabilities for each tweet. No hand-engineered features—it learns entirely from engagement patterns.

The Formula

Final Score = Σ (weight × P(action))

Each tweet gets scored by predicting the probability you'll take various actions, then weighting them.

What It Predicts

Positive signals (boost score):

Signal What It Measures
P(favorite) Likelihood of like
P(reply) Likelihood of reply
P(repost) Likelihood of repost
P(quote) Likelihood of quote tweet
P(click) Likelihood of clicking through
P(profile_click) Likelihood of visiting author's profile
P(video_view) Likelihood of watching video
P(photo_expand) Likelihood of expanding image
P(share) Likelihood of sharing externally
P(dwell) Time spent reading/viewing
P(follow_author) Likelihood of following

Negative signals (reduce score):

Signal What It Measures
P(not_interested) Likelihood of "Not interested"
P(block_author) Likelihood of blocking
P(mute_author) Likelihood of muting
P(report) Likelihood of reporting

Additional Ranking Factors

  • Author Diversity: Repeated posts from same author get attenuated
  • Out-of-Network Boost: Discovered content (not from follows) gets special scoring
  • Candidate Isolation: Each tweet scored independently

Commands

/x-algorithm analyze [tweet]     # Score a tweet draft
/x-algorithm optimize [tweet]    # Suggest improvements
/x-algorithm signals             # Show all ranking signals
/x-algorithm hooks               # Generate high-engagement hooks

Usage

Analyzing a Tweet

/x-algorithm analyze "Just shipped a new feature"

ANALYSIS:
┌─────────────────────────────────────────────────┐
│  Tweet: "Just shipped a new feature"            │
├─────────────────────────────────────────────────┤
│  Predicted signals:                             │
│  ├─ P(favorite)      LOW   - no emotional hook  │
│  ├─ P(reply)         LOW   - no question/gap    │
│  ├─ P(repost)        LOW   - no value to share  │
│  ├─ P(quote)         LOW   - nothing to add to  │
│  ├─ P(dwell)         LOW   - too short          │
│  └─ P(not_interested) MED  - generic update     │
│                                                 │
│  Overall: WEAK                                  │
│                                                 │
│  Issues:                                        │
│  • No specificity (what feature? why care?)     │
│  • No emotional trigger                         │
│  • No reason to engage                          │
└─────────────────────────────────────────────────┘

Optimize? (yes/no)

Optimizing a Tweet

/x-algorithm optimize "Just shipped a new feature"

OPTIMIZED VERSIONS:

v1 (curiosity gap):
"The feature everyone asked for just shipped.

Took 6 months. Here's why it was worth the wait:"

v2 (social proof):
"1,247 people requested this feature.

Today we shipped it.

[screenshot]"

v3 (contrarian):
"Everyone said this feature was impossible.

We built it anyway.

Here's how:"

---

Which version, or iterate?

Optimization Principles

Maximize Positive Signals

For P(favorite) - likes:

  • Strong opinion or take
  • Relatable observation
  • Emotional resonance
  • Beautiful visually

For P(reply) - replies:

  • Ask a question
  • Create a knowledge gap
  • Be slightly wrong (people love to correct)
  • Request input

For P(repost) - reposts:

  • Provide shareable value (tips, insights)
  • Create "I wish I said that" moments
  • Make people look smart for sharing

For P(quote) - quotes:

  • Leave room for commentary
  • Take a stance others want to respond to
  • Share something people want to add context to

For P(dwell) - time on tweet:

  • Longer, readable content
  • Images that require study
  • Threads with substance
  • Videos

For P(follow) - new followers:

  • Demonstrate unique expertise
  • Show personality
  • Consistent topic/niche

Minimize Negative Signals

Avoid P(not_interested):

  • Don't be generic
  • Don't repeat what everyone says
  • Don't post off-topic

Avoid P(block/mute):

  • Don't be annoying
  • Don't spam
  • Don't be hostile
  • Don't engage in bad faith

Avoid P(report):

  • Don't violate ToS
  • Don't harass
  • Don't spread misinfo

High-Engagement Patterns

The Hook Patterns

1. CURIOSITY GAP
   "I spent 3 years learning [X]. Here's what I wish I knew:"

2. CONTRARIAN
   "Unpopular opinion: [hot take]"

3. STORY OPENER
   "In 2019 I was [relatable struggle]. Now I [impressive outcome]."

4. SPECIFIC NUMBER
   "I've [done X] 847 times. Here's what works:"

5. BEFORE/AFTER
   "I used to [common mistake]. Then I learned [insight]."

6. QUESTION
   "What's one thing you wish you learned earlier about [X]?"

Thread Structures That Work

LISTICLE:
"10 [things] about [topic]:"
→ High dwell, easy to repost individual tweets

BUILD-UP:
1. Hook
2. Context
3. Insight
4. Proof
5. Implication
6. CTA
→ Maximizes dwell across thread

STORY:
1. "It was 2AM when..."
2. Rising action
3. Crisis point
4. Resolution
5. Lesson
6. CTA
→ High engagement, emotional resonance

Visual Content

IMAGES:
- Screenshots > stock photos
- Before/after comparisons
- Data visualizations
- Behind-the-scenes

VIDEOS:
- Hook in first 1-3 seconds
- Subtitles (most watch muted)
- Native upload > links
- <2 min optimal

Integration with /content

When using /content thread or /content post, the X algorithm principles are automatically applied:

/content thread "our new pricing model"

Applying X algorithm optimization...
├─ Hook pattern: SPECIFIC NUMBER
├─ Thread structure: BUILD-UP
├─ Engagement triggers: curiosity, social proof
└─ Visual: screenshot recommendation

[generates thread with algorithm principles]

Author Diversity Consideration

The algorithm attenuates repeated authors. Posting strategy matters:

SUBOPTIMAL:
Post → Post → Post → Post (same hour)
Algorithm reduces later posts' reach

BETTER:
Post → [gap] → Post → [gap] → Post
Each post gets full scoring potential

Out-of-Network Discovery

To reach beyond your followers:

- Quote tweet popular accounts (your take on their content)
- Reply meaningfully to trending topics
- Create highly repostable content (others share to their network)
- Post content that generates quotes (your reach + quoter's reach)

Metrics to Watch

After posting, monitor:

Metric What It Tells You
Impressions from For You Algorithm reach
Impressions from profile Direct followers
Engagement rate Content quality signal
Quote:Repost ratio How "discussable" content is
Reply quality Community engagement depth

Source

Based on the open-sourced X algorithm: https://github.com/xai-org/x-algorithm

The algorithm is continuously updated. Check the repo for latest changes.

Didn't find tool you were looking for?

Be as detailed as possible for better results