Agent skill

X Thread Reader

by tokenbender in tokenbender/agent-guides

A skill your agent uses when the user provides an X/Twitter status URL and needs the full thread, context beyond the first post, comparison, summary, intent analysis, title extraction, or reliable…

Apache-2.0Auto-check passedWriting & Content

Install X Thread Reader

skills CLI
$ npx skills add tokenbender/agent-guides --skill x-thread-reader -a claude-code

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

GitHub CLI
$ gh skill install tokenbender/agent-guides x-thread-reader --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/tokenbender/agent-guides.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude-skills/x-thread-reader .claude/skills/x-thread-reader && 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-thread-reader
GitHub stars
367
Token cost
~506 tokens
SKILL.md length
202 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user provides an X/Twitter status URL and needs the full thread, context beyond the first post, comparison, summary, intent analysis, title extraction, or reliable…

  • Works in 4 steps: Extract the tweet id from the URL. → Build the thread-reader URL → Fetch the Twitter Thread Reader page… → …
  • The user provides an X/Twitter status URL and needs the full thread
  • SKILL.md covers Workflow, Output Rules and Example
  • Reaches twitter-thread.com and x.com

What it does

X Thread Reader is an agent skill from tokenbender/agent-guides. Use when the user provides an X/Twitter status URL and needs the full thread, context beyond the first post, comparison, summary, intent analysis, title extraction, or reliable post text. Convert status links to Twitter Thread Reader URLs using the tweet id when X is blocked, incomplete, or thread context matters.

Its SKILL.md is about 510 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). The repository describes itself as: one page guides that i let my subscribed/customised agents consume to perform actions. The licence is Apache-2.0.

When your agent uses it

  • The user provides an X/Twitter status URL and needs the full thread
  • Context beyond the first post
  • Intent analysis
  • Title extraction

Example prompts

  • “/x-thread-reader”

Workflow steps

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

  1. Extract the tweet id from the URL.
  2. Build the thread-reader URL
  3. Fetch the Twitter Thread Reader page before drawing conclusions from a single X post.
  4. Fall back only if Twitter Thread Reader fails or is missing tweets.

What it can do on your machine

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

    • twitter-thread.com
    • x.com

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

X Thread Reader loads about 506 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 202 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~506

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 tokenbender/agent-guides at commit a74dd9d, republished under its Apache-2.0 licence (© tokenbender). 202 words, ~506 tokens.

Download SKILL.mdSave it as .claude/skills/x-thread-reader/SKILL.md (or your agent's skills folder).
name
x-thread-reader
description
Use when the user provides an X/Twitter status URL and needs the full thread, context beyond the first post, comparison, summary, intent analysis, title extraction, or reliable post text. Convert status links to Twitter Thread Reader URLs using the tweet id when X is blocked, incomplete, or thread context matters.
metadata.short-description
Read full X threads through Twitter Thread Reader

X Thread Reader

Use this skill whenever an X/Twitter post may need more than the top-post text.

Workflow

  1. Extract the tweet id from the URL.

    • Match x.com/<user>/status/<id>, twitter.com/<user>/status/<id>, or equivalent status URLs.
    • Ignore query parameters such as ?s=20.
  2. Build the thread-reader URL:

    text
    https://twitter-thread.com/t/<tweet_id>
  3. Fetch the Twitter Thread Reader page before drawing conclusions from a single X post.

    • Use it to recover the thread text, tweet count, linked media alt text, quoted/replied context, and embedded links when available.
    • Cite the thread-reader URL in the final answer when it shaped the answer.
  4. Fall back only if Twitter Thread Reader fails or is missing tweets.

    • Try api.fxtwitter.com, cdn.syndication.twimg.com/tweet-result, X embed/oEmbed, web search, or browser-rendered inspection as appropriate.
    • State uncertainty when mirrors fail or only partial text is available.

Output Rules

  • Do not infer a thread's meaning from the opening tweet alone when a thread-reader page is available.
  • When comparing a thread to a local project, read the thread first, then compare it against the relevant local docs or code.
  • Preserve exact user output contracts. For title/capture tasks, return only the requested title format.
  • Avoid guessed content. If the full thread cannot be verified, say what was verified and what was not.

Example

text
https://x.com/FredKSchott/status/2050274923852210397?s=20
-> https://twitter-thread.com/t/2050274923852210397

© tokenbender, Apache-2.0. 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 claude-skills/x-thread-reader of tokenbender/agent-guides.

Open the folder on GitHubat commit a74dd9d

Compare with similar skills

X Thread Reader 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 Thread Reader compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Thread Reader this skilltokenbender/agent-guides367—~506Automated safety check: PassApache-2.0
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Social Contentfreekmurze/dotfiles1k23 repos~2.1kAutomated safety check: PassNone
Typefullyfreekmurze/dotfiles1k2 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 2 repos~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
  • 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 23 days ago
    Writing & ContentAuto-check passed

More from tokenbender/agent-guides

All 11 skills in this repo
  • Capability Horizon Estimator

    tokenbender/agent-guides

    Estimate whether an AI model can complete a task and how long it will take, using METR-style time-horizon modeling.

    367 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Technical Writing Workflow

    tokenbender/agent-guides

    A skill your agent uses for planning, researching, drafting, revising, or auditing technical write-ups, textbooks, papers, reports, READMEs, research notes, PR narratives, and public technical prose.

    367 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Epistemic Libido

    tokenbender/agent-guides

    Filter, compare, and rank papers, posts, captures, threads, bookmarks, product claims, or research ideas for high-entropy mechanistic insight and underpriced leverage.

    367 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Manim Math Explainer

    tokenbender/agent-guides

    Trigger when: (1) the user asks for Manim, Manim Community, or ManimCE, (2) code contains from manim import , or (3) the task is to build a mathematical explainer animation.

    367 GitHub stars~799 tokensUpdated 2 mo ago
    Auto-check passed
  • Worklog

    tokenbender/agent-guides

    Issue-led atomic work logging. An agent skill from tokenbender/agent-guides.

    367 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed
  • Audit Sft Data Quality

    tokenbender/agent-guides

    Audit supervised fine-tuning datasets against the behavior and task they are meant to teach.

    367 GitHub stars~2.7k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about X Thread Reader

What does X Thread Reader do?

A skill your agent uses when the user provides an X/Twitter status URL and needs the full thread, context beyond the first post, comparison, summary, intent analysis, title extraction, or reliable…. X Thread Reader is an agent skill from tokenbender/agent-guides. Use when the user provides an X/Twitter status URL and needs the full thread, context beyond the first post, comparison, summary, intent analysis, title extraction, or reliable post text.

When should I use X Thread Reader?

X Thread Reader fits situations like: the user provides an X/Twitter status URL and needs the full thread; context beyond the first post; intent analysis; title extraction.

How do I install X Thread Reader in Claude Code?

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

How do I install X Thread Reader in Codex?

Run `npx skills add tokenbender/agent-guides --skill x-thread-reader -a codex`. Or copy the skill folder (claude-skills/x-thread-reader in tokenbender/agent-guides) into .agents/skills/x-thread-reader in your project. Codex loads it when a task matches its description.

Can I use X Thread Reader 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 tokenbender/agent-guides --skill x-thread-reader -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-thread-reader, .gemini/skills/x-thread-reader, .github/skills/x-thread-reader and .opencode/skills/x-thread-reader in your project.

What does X Thread Reader need to run?

SKILL.md names no scripts, command-line tools or credentials: X Thread Reader is instructions for the agent only.

Does X Thread Reader access the network?

SKILL.md names 2 domains. In commands or code: twitter-thread.com and x.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is X Thread Reader 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 Thread Reader use?

X Thread Reader is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does X Thread Reader use?

About 506 tokens (SKILL.md is roughly 2k 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 Thread Reader?

Skills that share tags, products or a category with X Thread Reader: 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 Thread Reader?

tokenbender (a GitHub user) maintains it in tokenbender/agent-guides, which has 367 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on July 23, 2026.

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