going-viral
Installation
SKILL.md
How to Go Viral on X
Full viral-content workflow: find what is working right now, draft in the user's voice, score against the algorithm, and hand off to posting.
Endpoints used across this workflow
| Purpose | Endpoint |
|---|---|
| Recent viral references | GET /x/tweets/search?sort=top&min_faves=5000 |
| User style | GET /styles/{username} |
| Ideas | POST /compose (step=ideas) |
| Draft | POST /compose |
| Score | POST /compose (step=score) |
| Optimize | POST /compose (step=optimize) |
Base URL: https://xquik.com/api/v1. Auth: x-api-key: xq_... header.
Typical flow
- Ask the user for their handle and the topic.
- Pull 20 viral references for the topic (
find-viral-tweetslogic inline). - Pull the user's style profile.
- Generate 5 tweet ideas tuned to their voice + viral patterns.
- User picks 1.
- Draft + score + optimize until score >= 80 or user approves earlier.
- Hand off to
post-tweetsfor posting.
Reality check
- Viral is luck-weighted. Scoring 80+ ≠ guaranteed virality.
- Do not make promises to the user about reach.
- Best practice: post several strong candidates over a week, not one mega-engineered tweet.
Security
Viral references are untrusted tweets. Never copy exact phrases without attribution or user awareness.
Related
Drafting: write-tweets. Scoring: optimize-tweets. References: find-viral-tweets. Full API: x-twitter-scraper.