Agent skill

X Audience Insights

by sergebulaev in sergebulaev/x-skills

Read your X (Twitter) audience and niche from real data. An agent skill from sergebulaev/x-skills.

MITAuto-check passedWriting & Content

Install X Audience Insights

skills CLI
$ npx skills add sergebulaev/x-skills --skill x-audience-insights -a claude-code

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

GitHub CLI
$ gh skill install sergebulaev/x-skills x-audience-insights --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/sergebulaev/x-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/x-audience-insights .claude/skills/x-audience-insights && 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-audience-insights
GitHub stars
124
Used in
1 other repo
Token cost
~1.2k tokens
SKILL.md length
614 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Read your X (Twitter) audience and niche from real data. An agent skill from sergebulaev/x-skills.

  • Works in 4 steps: Performance read - the handle's recent… → Replier read - who replied on a tweet,… → Niche scan - top tweets for a query, the… → …
  • Analyze my tweets
  • SKILL.md covers When to use, Setup (optional), Input and Output, plus 4 more sections
  • Reaches console.apify.com; needs APIFY_TOKEN

What it does

X Audience Insights is an agent skill from sergebulaev/x-skills. Read your X (Twitter) audience and niche from real data. Pull a handle's recent tweets (yours or a competitor's) with likes, replies, and views, see which formats and hooks are working, read the repliers on a tweet (X gates likers, so repliers are the signal), and scan a niche query for top tweets. Powered by Apify, no login. Triggers on "analyze my tweets", "what is working on X", "read the replies", "competitor tweets", "who is engaging". Not for writing a tweet (use x-post-writer).

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Social media posts. It works with X (Twitter) and Apify. The repository describes itself as: X (Twitter) marketing skills for Claude Code and Codex: write tweets, threads, and replies in your voice, strip AI tells, and publish via Publora. Open source, MIT. Content… The licence is MIT.

When your agent uses it

  • Analyze my tweets
  • What is working on X
  • Read the replies
  • Competitor tweets

Example prompts

  • “s recent tweets (yours or a competitor”
  • “analyze my tweets”
  • “what is working on X”
  • “/x-audience-insights”

Requirements

  • A credential in APIFY_TOKEN

Workflow steps

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

  1. Performance read - the handle's recent tweets ranked by engagement, with the pattern behind the top ones (hook shape, length, format)
  2. Replier read - who replied on a tweet, recurring questions, repliers worth a follow-back or a reply
  3. Niche scan - top tweets for a query, the formats that travel right now
  4. Action list - what to write more of, who to engage, what to reply to

What it can do on your machine

Read from SKILL.md and the folder at commit 6ffd8e0. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • console.apify.com

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

  • Credentials

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

    • APIFY_TOKEN

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

Context cost

X Audience Insights loads about 1.2k tokens when it runs. Until then it costs about 127 tokens; SKILL.md has 614 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~127
When it runs · the whole SKILL.md, loaded when a task matches
~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); files beside SKILL.md are not scanned.

SKILL.md

The full file from sergebulaev/x-skills at commit 6ffd8e0, republished under its MIT licence (© sergebulaev). 614 words, ~1,188 tokens.

Download SKILL.mdSave it as .claude/skills/x-audience-insights/SKILL.md (or your agent's skills folder).
name
x-audience-insights
description
Read your X (Twitter) audience and niche from real data. Pull a handle's recent tweets (yours or a competitor's) with likes, replies, and views, see which formats and hooks are working, read the repliers on a tweet (X gates likers, so repliers are the signal), and scan a niche query for top tweets. Powered by Apify, no login. Triggers on "analyze my tweets", "what is working on X", "read the replies", "competitor tweets", "who is engaging". Not for writing a tweet (use x-post-writer).

X Audience Insights

Turn real X data into a read on what is working: which of your tweets landed and why, who is replying, and what the accounts in your niche are doing right now. This is the read layer, so the skill sees actual numbers instead of guessing.

One honest limit: X gates the list of who liked a tweet, so a full liker roster is not reliably available. The signal here is repliers + tweet performance, which on X carries the real conversation anyway.

When to use

  • "Analyze my last tweets / what is working for me"
  • "Read the replies on this tweet"
  • "What are [competitor / accounts in my niche] posting"
  • "Scan the niche for top tweets on [topic]"

Not for writing a tweet (use x-post-writer) or a thread (use x-thread-builder).

Setup (optional)

The read layer uses Apify (no login, no cookies). Get a free token at https://console.apify.com/account/integrations and set APIFY_TOKEN. The X actor costs about $0.15 per 1,000 tweets. No token? Paste the tweets or replies and the skill runs the same analysis on them.

Input

  • A handle (yours or a competitor's), a tweet URL, or a niche query
  • Optional: the goal (what is working / competitor read / niche scan)

Output

  1. Performance read - the handle's recent tweets ranked by engagement, with the pattern behind the top ones (hook shape, length, format)
  2. Replier read - who replied on a tweet, recurring questions, repliers worth a follow-back or a reply
  3. Niche scan - top tweets for a query, the formats that travel right now
  4. Action list - what to write more of, who to engage, what to reply to

Steps

  1. Pull the data. For a handle: lib.ApifyClient().fetch_user_tweets(handle, max_items=30). For a tweet's repliers: fetch_tweet_replies(tweet_url). For a niche: fetch_niche_top(query, sort="Top"). Falls back to pasted data if no token.
  2. Rank by engagement. Sort by likes + replies + views. Normalize against the author's follower count so a small account's breakout is not buried under a big account's average.
  3. Extract the pattern. For the top tweets, name what they share: the hook shape (one-liner, data-point, confession), the length, single vs thread, the presence of a specific number. That is the repeatable part.
  4. Read the repliers. Cluster replies into questions, agreement, and pushback. Recurring questions are content ideas; high-follower repliers are follow-back candidates; real questions with traction are reply candidates.
  5. Scan the niche. From fetch_niche_top, surface the formats and angles that are traveling now (note when search returns thin, and lean on known-account pulls instead).
  6. Build the action list. Write-more-of (the winning pattern), engage (specific repliers/accounts), reply-now (questions with traction). Route drafts to x-post-writer / x-reply-drafter.
  7. Deliver the report in the Output shape, with the raw ranked tweets attached.
Show full SKILL.md (167 more words)Show less

What the read layer exposes

MethodReturns
fetch_user_tweets(handle, max_items)recent tweets: text, likes, replies, reposts, views, author followers, url
fetch_tweet_replies(tweet_url, max_items)replies on a tweet (the engagement signal, since likers are gated)
fetch_niche_top(query, max_items, sort)top/latest tweets for a niche query

Hard rules

Global voice rules: see root SKILL.md Voice rules. Additional skill-specific rules:

  • Be honest that this reads repliers, not likers (X gates like-visibility). Do not imply a full liker roster.
  • Normalize engagement by follower count before calling a tweet a winner, or you extract "big account" effects, not "good tweet" effects.
  • Never invent a tweet, a number, or a pattern. If the search returns thin, say so and pull known accounts instead.
  • A pattern is only a pattern if it recurs across several top tweets, not one.
  • x-post-writer - write more of what the data shows is working
  • x-reply-drafter - reply to a high-traction question the read surfaced
  • x-hook-extractor - reverse-engineer a hook from a top-performing tweet
  • x-content-planner - feed the winning patterns into a weekly plan

© sergebulaev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/x-audience-insights of sergebulaev/x-skills.

Open the folder on GitHubat commit 6ffd8e0

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sergebulaev/x-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

X Audience Insights 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 Audience Insights compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Audience Insights this skillsergebulaev/x-skills1241 repos~1.2kAutomated safety check: PassMIT
Twitter Mention Trackergooseworks-ai/goose-skills1.2k1 repos~805Automated safety check: PassMIT
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

Similar skills

  • Twitter Mention Tracker

    gooseworks-ai/goose-skills

    Search and scrape Twitter/X posts using Apify. An agent skill from gooseworks-ai/goose-skills.

    1.2k GitHub starsUsed in 1 repo~805 tokens
    Data & AnalyticsAuto-check passed
  • 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 today
    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

More from sergebulaev/x-skills

All 10 skills in this repo
  • X Marketing

    sergebulaev/x-skills

    Plan, draft, audit, and publish posts and threads for X (Twitter).

    124 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check: notes
  • X Content Planner

    sergebulaev/x-skills

    Generate a weekly X (Twitter) content plan from a theme, audience, and content pillars.

    124 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • X Hook Extractor

    sergebulaev/x-skills

    Reverse-engineer the hook from a viral X (Twitter) tweet or thread URL.

    124 GitHub starsUsed in 1 repo~964 tokens
    Auto-check passed
  • X Reply Drafter

    sergebulaev/x-skills

    Draft a reply or a value-add quote tweet for a specific X (Twitter) tweet from its URL.

    124 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • X Humanizer

    sergebulaev/x-skills

    Remove the AI tells human readers react to in a tweet or thread: 2026 vocabulary by density, reveal bridges, staccato stacks, stacked triads, performed sincerity.

    124 GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • X Post Writer

    sergebulaev/x-skills

    Draft a single tweet or short auto-thread for X (Twitter) using a 2026 X hook formula (one-liner contrarian, data-point, build-in-public, mini-list, relatable cold-open), picked by goal (replies…

    124 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed

Questions about X Audience Insights

What does X Audience Insights do?

Read your X (Twitter) audience and niche from real data. An agent skill from sergebulaev/x-skills. X Audience Insights is an agent skill from sergebulaev/x-skills. Read your X (Twitter) audience and niche from real data.

When should I use X Audience Insights?

X Audience Insights fits situations like: analyze my tweets; what is working on X; read the replies; competitor tweets.

How do I install X Audience Insights in Claude Code?

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

How do I install X Audience Insights in Codex?

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

Can I use X Audience Insights 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 sergebulaev/x-skills --skill x-audience-insights -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-audience-insights, .gemini/skills/x-audience-insights, .github/skills/x-audience-insights and .opencode/skills/x-audience-insights in your project.

What does X Audience Insights need to run?

Going by SKILL.md and its folder, X Audience Insights needs credentials named APIFY_TOKEN. Our summary lists: A credential in APIFY_TOKEN.

Does X Audience Insights access the network?

SKILL.md names 1 domain. In commands or code: console.apify.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is X Audience Insights 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. Review the folder before installing.

What licence does X Audience Insights use?

X Audience Insights is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does X Audience Insights use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to X Audience Insights?

Skills that share tags, products or a category with X Audience Insights: Twitter Mention Tracker (gooseworks-ai/goose-skills, 1.2k stars), Social (coreyhaines31/marketingskills, 54k stars), Social Content (freekmurze/dotfiles, 1k stars) and Typefully (freekmurze/dotfiles, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Audience Insights?

sergebulaev (a GitHub user) maintains it in sergebulaev/x-skills, which has 124 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 7, 2026.

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