From da5363b72cd17573823a696b53b4e8f437458df3 Mon Sep 17 00:00:00 2001 From: Prathit-tech Date: Wed, 21 Jan 2026 11:54:13 +0530 Subject: [PATCH] feat: add twitter algo skill --- .claude-plugin/marketplace.json | 6 + README.md | 1 + twitter-algorithm-optimizer/SKILL.md | 327 +++++++++++++++++++++++++++ 3 files changed, 334 insertions(+) create mode 100644 twitter-algorithm-optimizer/SKILL.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index b10ed9f..274a3b2 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -50,6 +50,12 @@ "source": "./meeting-insights-analyzer", "category": "communication-writing" }, + { + "name": "twitter-algorithm-optimizer", + "description": "Analyze and optimize tweets for maximum reach using Twitter's open-source algorithm insights. Rewrite and edit tweets to improve engagement and visibility.", + "source": "./twitter-algorithm-optimizer", + "category": "communication-writing" + }, { "name": "canvas-design", "description": "Creates beautiful visual art in PNG and PDF documents using design philosophy and aesthetic principles for posters, designs, and static pieces.", diff --git a/README.md b/README.md index 684380c..2db4b00 100644 --- a/README.md +++ b/README.md @@ -154,6 +154,7 @@ Claude Skills are customizable workflows that teach Claude how to perform specif - [family-history-research](https://github.com/emaynard/claude-family-history-research-skill) - Provides assistance with planning family history and genealogy research projects. - [Meeting Insights Analyzer](./meeting-insights-analyzer/) - Analyzes meeting transcripts to uncover behavioral patterns including conflict avoidance, speaking ratios, filler words, and leadership style. - [NotebookLM Integration](https://github.com/PleasePrompto/notebooklm-skill) - Lets Claude Code chat directly with NotebookLM for source-grounded answers based exclusively on uploaded documents. *By [@PleasePrompto](https://github.com/PleasePrompto)* +- [Twitter Algorithm Optimizer](./twitter-algorithm-optimizer/) - Analyze and optimize tweets for maximum reach using Twitter's open-source algorithm insights. Rewrite and edit tweets to improve engagement and visibility. ### Creative & Media diff --git a/twitter-algorithm-optimizer/SKILL.md b/twitter-algorithm-optimizer/SKILL.md new file mode 100644 index 0000000..b3c69d9 --- /dev/null +++ b/twitter-algorithm-optimizer/SKILL.md @@ -0,0 +1,327 @@ +--- +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 \ No newline at end of file