Agent skill

X Viral Topic

by kangarooking in kangarooking/kangarooking-skills

Find low-follower viral posts on X/Twitter for account-growth topic selection.

No licenceAuto-check passedWriting & Content

Install X Viral Topic

skills CLI
$ npx skills add kangarooking/kangarooking-skills --skill x-viral-topic -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kangarooking/kangarooking-skills x-viral-topic --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kangarooking/kangarooking-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/viral-topic/x-viral-topic .claude/skills/x-viral-topic && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
x-viral-topic
GitHub stars
661
Token cost
~713 tokens
SKILL.md length
262 words
Files
5 (incl. scripts, references)
Skills in repo
19
Repo updated
First seen
Licence
None found

At a glance

Find low-follower viral posts on X/Twitter for account-growth topic selection.

  • Works in 7 steps: Convert the user's niche into short… → Search twitterapi.io advanced search… → Keep broad authority-account search off… → …
  • The user asks for X low-fan hits
  • SKILL.md covers Quick Start, Workflow, Query Pattern and Output Contract, plus 1 more section
  • Runs Python scripts from its folder; calls python3; needs TWITTER_API_KEY and TWITTERAPI_IO_KEY

What it does

X Viral Topic is an agent skill from kangarooking/kangarooking-skills. Find low-follower viral posts on X/Twitter for account-growth topic selection. Use when the user asks for X low-fan hits, Twitter low follower viral posts, 起号选题 from X, niche tweet inspiration, or viral posts ranked by author followers, views, bookmarks, likes, reposts, and replies.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/querying.md` and `references/scoring.md`).

It sits in Writing & Content, covering Social media posts. It works with X (Twitter). The repository describes itself as: My custom AI Agent skills.

When your agent uses it

  • The user asks for X low-fan hits
  • Twitter low follower viral posts
  • Niche tweet inspiration
  • Viral posts ranked by author followers

Example prompts

  • “/x-viral-topic”

Requirements

  • Python 3
  • A credential in TWITTERAPI_IO_KEY
  • A credential in TWITTER_API_KEY

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Convert the user's niche into short query clusters. Prefer exact phrases and product/category terms.
  2. Search twitterapi.io advanced search using both Top and Latest.
  3. Keep broad authority-account search off by default; low-fan discovery should not be dominated by official or celebrity accounts.
  4. Extract tweet metrics and author follower count.
  5. Filter
  6. Rank by breakout evidence
  7. Return JSON for automation or Markdown for topic review.

What it can do on your machine

Read from SKILL.md and the folder at commit 08bbee0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TWITTER_API_KEY
    • TWITTERAPI_IO_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

X Viral Topic loads about 713 tokens when it runs, and up to ~1.2k if it reads all its reference files. Until then it costs about 74 tokens; SKILL.md has 262 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~713
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 262 words (~713 tokens).

“Use this skill to find X posts that significantly outperform the author's follower base.”

— opening of SKILL.md by kangarooking
name
x-viral-topic

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (scripts, references) in viral-topic/x-viral-topic of kangarooking/kangarooking-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/querying.md
  • references/scoring.md
  • scripts/search_x_viral_topic.py

Open the folder on GitHubat commit 08bbee0

Compare with similar skills

X Viral Topic next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

X Viral Topic compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Viral Topic this skillkangarooking/kangarooking-skills661—~713Automated safety check: PassNone
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Social Contentfreekmurze/dotfiles1k23 repos~2.1kAutomated safety check: PassNone
Typefullyfreekmurze/dotfiles1k1 repos~3.4kAutomated safety check: NotesNone
Changelog Social RecapFlorianBruniaux/claude-code-ultimate-guide6.1k—~1.8kAutomated safety check: NotesCC-BY-SA-4.0
X Mastery Mentoralchaincyf/x-mentor-skill1.2k—~2.3kAutomated safety check: PassMIT

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 23 repos~2.1k tokens
    Writing & ContentAuto-check passed
  • Typefully

    freekmurze/dotfiles

    Create, schedule, and manage social media posts via Typefully.

    1k GitHub starsUsed in 1 repo~3.4k tokens
    Writing & ContentAuto-check: notes
  • Changelog Social Recap

    FlorianBruniaux/claude-code-ultimate-guide

    Turns CHANGELOG.md entries for a release or a week into LinkedIn, Twitter/X, newsletter and Slack posts in French and English.

    6.1k GitHub stars~1.8k tokensUpdated 2 days ago
    Writing & ContentAuto-check: notes
  • X Mastery Mentor

    alchaincyf/x-mentor-skill

    $10K/hr级X/Twitter运营导师。基于Nicolas Cole、Dickie Bush、Sahil Bloom、Justin Welsh、 Dan Koe、Alex Hormozi六位顶级创作者的方法论 + X开源算法深度分析 + AI/科技赛道专精策略, 提炼6个核心心智模型、10条决策启发式、完整的选题-写作-增长操作手册。

    1.2k GitHub stars~2.3k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Voice Builder

    charlie947/social-media-skills

    Build a personalised voice profile inside a Codex or Claude project from a short interview plus 3 to 5 sample pieces of writing.

    3.8k GitHub stars~3.3k tokensUpdated 24 days ago
    Writing & ContentAuto-check passed

More from kangarooking/kangarooking-skills

All 19 skills in this repo
  • Scroll Promo Site Builder

    kangarooking/kangarooking-skills

    Create a scroll-controlled cinematic product website with rich motion (动效网站) from product materials, reference pages or videos, and brand assets.

    661 GitHub stars~2.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Twitter Monitor

    kangarooking/kangarooking-skills

    Fetch recent posts from one or more X/Twitter accounts through twitterapi.io, output structured JSON/CSV records, optionally sync records to Feishu/Lark Bitable through feishu-cli, and optionally…

    661 GitHub stars~798 tokensUpdated 1 mo ago
    Auto-check passed
  • Apimart Image Gen

    kangarooking/kangarooking-skills

    Generate and download images through APIMart's asynchronous GPT-Image-2 API.

    661 GitHub stars~745 tokensUpdated 1 mo ago
    Auto-check passed
  • Bilibili Viral Topic

    kangarooking/kangarooking-skills

    Find low-follower viral Bilibili videos for account-growth topic selection.

    661 GitHub stars~756 tokensUpdated 1 mo ago
    Auto-check passed
  • Viral Title

    kangarooking/kangarooking-skills

    Generate high-potential viral title candidates for content across WeChat public account articles, X/Twitter posts, YouTube videos, Bilibili videos, and similar content platforms.

    661 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Wechat Viral Topic

    kangarooking/kangarooking-skills

    Find WeChat public-account articles that break out above the account's average reads for account-growth topic selection.

    661 GitHub stars~914 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about X Viral Topic

What does X Viral Topic do?

Find low-follower viral posts on X/Twitter for account-growth topic selection. X Viral Topic is an agent skill from kangarooking/kangarooking-skills. Find low-follower viral posts on X/Twitter for account-growth topic selection.

When should I use X Viral Topic?

X Viral Topic fits situations like: the user asks for X low-fan hits; twitter low follower viral posts; niche tweet inspiration; viral posts ranked by author followers.

How do I install X Viral Topic in Claude Code?

Run `npx skills add kangarooking/kangarooking-skills --skill x-viral-topic -a claude-code`. Or copy the skill folder (viral-topic/x-viral-topic in kangarooking/kangarooking-skills) into .claude/skills/x-viral-topic in your project. Claude Code loads it when a task matches its description.

How do I install X Viral Topic in Codex?

Run `npx skills add kangarooking/kangarooking-skills --skill x-viral-topic -a codex`. Or copy the skill folder (viral-topic/x-viral-topic in kangarooking/kangarooking-skills) into .agents/skills/x-viral-topic in your project. Codex loads it when a task matches its description.

Can I use X Viral Topic in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kangarooking/kangarooking-skills --skill x-viral-topic -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/x-viral-topic, .gemini/skills/x-viral-topic, .github/skills/x-viral-topic and .opencode/skills/x-viral-topic in your project.

What does X Viral Topic need to run?

Going by SKILL.md and its folder, X Viral Topic needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named TWITTER_API_KEY and TWITTERAPI_IO_KEY. Our summary lists: Python 3; A credential in TWITTERAPI_IO_KEY; A credential in TWITTER_API_KEY.

Does X Viral Topic access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is X Viral Topic safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does X Viral Topic use?

No licence was found for X Viral Topic or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does X Viral Topic use?

About 713 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 506 tokens, read only when the agent opens those files.

What are the alternatives to X Viral Topic?

Skills that share tags, products or a category with X Viral Topic: Social (coreyhaines31/marketingskills, 54k stars), Social Content (freekmurze/dotfiles, 1k stars), Typefully (freekmurze/dotfiles, 1k stars) and Changelog Social Recap (FlorianBruniaux/claude-code-ultimate-guide, 6.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Viral Topic?

kangarooking (a GitHub user) maintains it in kangarooking/kangarooking-skills, which has 661 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on September 7, 2026.

Source: kangarooking/kangarooking-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.