Skip to content

README.md

Latest commit

 

History

History
160 lines (116 loc) · 6.63 KB

README.md

File metadata and controls

160 lines (116 loc) · 6.63 KB

Agent Skill Library - X Tweet Optimization Suite

An open-source AI Agent skill library designed for X (Twitter) content creators. Contains two powerful intelligent agents: X-TweetOptimizer and X-ViralTweet, helping you analyze tweet performance and optimize content strategy.

📋 Overview

This project contains enterprise-grade tweet optimization skills based on the latest 2026 X algorithm research, supporting the following core functionalities:

  • Tweet Performance Diagnosis - Deep analysis of single or batch tweet performance
  • Personalized Strategy Generation - Build custom posting strategies based on your account's historical data
  • Viral Reach Optimization - Maximize reach and engagement using algorithmic signals
  • Bulk Content Calendar - Generate optimized weekly/monthly publishing plans

🎯 Core Skills

1. X-TweetOptimizer Agent

Personalized Tweet Optimization & Diagnosis Tool

Analyzes tweet performance based on your own historical data, extracting personalized algorithmic patterns. Unlike generic best practices, this skill treats your account's real data as ground truth—because what works for your niche, audience, and voice is more valuable than any universal benchmark.

Core Features:

  • Single Tweet Deep Diagnosis - Root cause analysis of why specific tweets succeeded or failed
  • Batch Pattern Extraction - Identify your account's performance fingerprint from 5-50 tweets
  • Account-Level Audit - Analyze overall publishing history and strategic recommendations
  • Personalized Posting Playbook - Data-driven comprehensive publishing strategy

Activation Triggers:

"Activate X-TweetOptimizer Agent"
"Analyze my tweet data and optimize my strategy"
"Why did this tweet flop / blow up?"
"Build my personalized X posting playbook"

2. X-ViralTweet Agent

Data-Driven Viral Content Generation Tool

Designed for creators, bloggers, and new accounts, leveraging the latest 2026 X algorithmic signals to maximize reach, engagement, and follower growth. All outputs strictly follow a data-driven priority stack.

2026 Algorithm Priority Stack:

Priority Algorithmic Signal Impact
1️⃣ Rich Media (Video / Visual First) Video = 10x engagement; Images = +150% retweets
2️⃣ Early Engagement Velocity + Interaction Hooks First 15-60 min replies/retweets trigger snowball effect
3️⃣ High-Arousal Emotion + Controversy Triggers quote storms and reply floods
4️⃣ Threads + Value / Story / Educational Content Extends dwell time, improves follower conversion
5️⃣ Trending Topics + Timeliness Exploits FOMO, prioritizes real-time relevant content
6️⃣ Humor / Relatable / Meme Content Low-cost, high-spread potential

Core Features:

  • Tweet Generation - Optimized single tweets or thread generation
  • Distribution Optimization - Best posting times, hashtag, and CTA strategy
  • Viral Launch Strategy - Early engagement secrets and self-engagement sequences
  • Performance Diagnosis - Analyze tweet performance and output optimization plan
  • Bulk Content Calendar - Weekly/monthly diversified tweet plans

Activation Triggers:

"Activate X-ViralTweet Agent"
"Use X-ViralTweet Agent to help me create…"
"Generate a viral tweet about…"
"Build me a tweet thread on…"

Skills Documentation

X-TweetOptimizer Input Schema

Option A - Single Tweet Diagnosis:

[TWEET COPY]      → Full tweet text
[MEDIA TYPE]      → None / image / video / GIF / poll
[POSTED AT]       → Date + time with timezone
[IMPRESSIONS]     → Total views
[LIKES]           → Like count
[REPLIES]         → Reply count
[RETWEETS]        → Retweet count
[QUOTE TWEETS]    → Quote tweet count
[BOOKMARKS]       → Bookmark count (if available)
[ACCOUNT STATUS]  → Follower count at posting / Premium status

Option B - Batch Analysis: Submit CSV or table containing the above fields

Option C - Account Audit: Describe your posting history in natural language

X-ViralTweet Input Schema

Topic / Core Idea       → Tweet topic
Target Audience         → Intended audience
Content Type            → Fact / story / opinion / product / rant / meme
Emotional Tone          → Controversial / inspiring / humorous / warm / provocative
Media Requirement       → Text-only / must include video / image optional
Account Status          → New / Growing / Verified / X Premium
Special Constraints     → Word count, language, brand voice restrictions

🔑 2026 Mandatory Algorithm Rules

X-ViralTweet Agent always enforces:

  • ✅ Reply to every comment within 1 hour of posting - Can increase main tweet impressions by 8-150x
  • ✅ No external links in main tweet body - Reduces reach by 30-50%; use replies or quote-tweets instead
  • ✅ X Premium accounts get 2-4x visibility multiplier - Agent will flag when applicable
  • ✅ Post 2-5 high-quality tweets per day - Consistency outperforms one-off viral attempts
  • ✅ Hook reader in first 3 seconds - Always open with a number, question, or unexpected reversal

📊 Output Format

All agent responses include:

  • Complete, copy-ready tweet package
  • Diagnostic and/or optimization recommendations
  • Specific next steps
  • Algorithm signal breakdown (for optimizer)
  • Distribution strategy (for viral tweets)

📝 Project Structure

agent-skill-library/
├── README.md                          # This file
├── LICENSE                            # MIT License
├── .gitignore                         # Git configuration
├── x-tweetoptimizer-agent/
│   ├── SKILL.md                      # Skill documentation
│   └── [Supporting files]
└── x-viraltweet-agent/
    ├── SKILL.md                      # Skill documentation
    └── [Supporting files]

🤝 Contributing

Contributions and improvements are welcome! Please:

  1. Fork this repository
  2. Create a feature branch (git checkout -b feature/improvement)
  3. Commit your changes (git commit -am 'Add improvement')
  4. Push to the branch (git push origin feature/improvement)
  5. Open a Pull Request

📜 License

This project is released under the MIT License. You are free to use, modify, and distribute this project.

Data-driven X optimization for modern content creators.