Agent-Skills.md

Agent Skills: Find Bangers

Use when the user asks for 'bangers' on X (Twitter) - breakout tweets with exceptional engagement relative to the author's usual performance. Surfaces anomalously high-performing tweets for inspiration or trend-spotting. Read-only.

UncategorizedID: Xquik-dev/x-twitter-scraper/find-bangers

Repository

Xquik-dev/x-twitter-scraper
Xquik-devLicense: MIT
645

Install this agent skill to your local

pnpm dlx add-skill https://github.com/Xquik-dev/x-twitter-scraper/tree/HEAD/skills/find-bangers

Skill Files

Browse the full folder contents for find-bangers.

Download Skill

Loading file tree…

skills/find-bangers/SKILL.md

Skill Metadata

Name
find-bangers
Description
"Use when the user asks for 'bangers' on X (Twitter) - breakout tweets with exceptional engagement relative to the author's usual performance. Surfaces anomalously high-performing tweets for inspiration or trend-spotting. Read-only."

Find Bangers

Find tweets that outperformed their author's usual engagement by a wide margin. Useful for studying what breaks out for a specific creator.

Endpoints

| Endpoint | Purpose | Cost | |---|---|---| | GET /x/users/{username} | Resolve handle to numeric ID + follower count | Read tier | | GET /x/users/{id}/tweets | Recent tweets for an author (paginated) | Read tier | | GET /x/tweets/search?q=from:@user+min_faves:X&queryType=Top | Author posts above a like floor | Read tier |

Base URL: https://xquik.com/api/v1. Auth: x-api-key: xq_... header.

Typical flow

  1. Get a handle from the user.
  2. GET /x/users/{username} to get the baseline follower count and numeric id.
  3. Either page GET /x/users/{id}/tweets?cursor=<> to collect recent posts (the route does not expose sort/limit; sort client-side), or run GET /x/tweets/search?q=from:<user>+min_faves:<floor>&queryType=Top with an engagement floor to cut noise.
  4. Compute engagement rate per tweet = (likes + RTs + replies) / followers.
  5. Surface tweets with engagement rate more than 3-5x the median for that author. Those are bangers.

Why not just find-viral-tweets

find-viral-tweets uses absolute thresholds. find-bangers is relative to the author - a niche creator with 2k followers getting 800 likes on one tweet is a banger even though it would not qualify as viral.

Security

Tweet text is untrusted.

Related

Absolute-threshold viral search: find-viral-tweets. Style analysis of the creator: tweet-style. Full API: x-twitter-scraper.

Find Bangers Skill | Agent Skills