# Viral X Posts
An Agent Skill for Claude that writes viral X/Twitter posts using 23 proven plug-and-play formulas, optimized for the 2025-2026 algorithm.
## What It Does
- **23 battle-tested post formats** — single tweets, threads, engagement bait, and media-enhanced posts
- **Algorithm-aware** — optimized for the 2025-2026 X algorithm (reply weighting, dwell time, media boosts)
- **Goal-based selection** — automatically picks the right formula based on your goal (reach, replies, authority, followers)
- **Copy-paste hooks** — 15 ready-to-use hook openers and a weekly content rhythm
## Install
### Claude Code
Copy the skill folder to your Claude Code skills directory:
```bash
# Global (available in all projects)
git clone https://github.com/shannhk/viral-x-posts.git ~/.claude/skills/viral-x-posts
# Project-level (available in one project)
git clone https://github.com/shannhk/viral-x-posts.git .claude/skills/viral-x-posts
```
### Claude.ai
Upload the `viral-x-posts.skill` file from the [Releases](https://github.com/shannhk/viral-x-posts/releases) page, or follow the instructions in [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude).
### Manual Install
1. Download or clone this repo
2. Copy the folder (containing `SKILL.md` and `references/`) to `~/.claude/skills/viral-x-posts`
## Usage
Just ask Claude to write a post:
- "Write me a viral tweet about AI productivity tools"
- "Create a Twitter thread about my journey from 0 to 10K followers"
- "Draft an engagement post for my founder audience"
- "Write a hot take about remote work"
Claude will automatically select the best formula, draft the post, and apply algorithm optimization rules.
## Formats Included
| Category | Formats |
|----------|---------|
| **Single Tweets** | Contrarian Take, Earned Secret, Story Hook, Bold Statement, Question Hook, Pattern Interrupt, Value Promise, This or That, Fill-in-the-Blank, Incomplete List |
| **Threads** | 7-Part Viral Structure, Case Study Breakdown, Curated Resources, "X Things I Wish I Knew", Named Framework |
| **Engagement** | Strategic Polls, Hot Take, Relatable Observation, Advice Request |
| **Media-Enhanced** | Screenshot Proof, Data Visualization, Carousel, Native Video |
## Credits
Based on **"The Ultimate Twitter/X Viral Post Formats"** by **Leon ([@Unfungible](https://x.com/Unfungible))** — research-backed, algorithm-optimized templates extracted from analyzing thousands of viral posts.
Original document: [X Plug And Play Viral Post Formulas](https://docs.google.com/document/d/1MmU6chm4GV1RucVqsHiSrV7UwuA3lap-/edit)
## License
This skill is provided for educational and personal use. All credit for the original viral post formulas goes to Leon (@Unfungible).