New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Thread Writer

by social-media-skills in social-media-skills/skills

A skill your agent uses to write a thread — a connected sequence of posts on X/Twitter or Threads that tells one story or makes one argument across multiple posts.

MITAuto-check passedWriting & Content

Install Thread Writer

skills CLI
$ npx skills add social-media-skills/skills --skill thread-writer -a claude-code

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

GitHub CLI
$ gh skill install social-media-skills/skills thread-writer --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/social-media-skills/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/thread-writer .claude/skills/thread-writer && 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
thread-writer
GitHub stars
134
Token cost
~1.6k tokens
SKILL.md length
811 words
Files
6 (incl. references)
Skills in repo
106
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses to write a thread — a connected sequence of posts on X/Twitter or Threads that tells one story or makes one argument across multiple posts.

  • Works in 7 steps: Read the foundation first → Lock one idea, the payoff, and check it… → Write the opener (hook + promise) → …
  • Write a thread — a connected sequence of posts on X/Twitter
  • SKILL.md covers Step 0 — Read the foundation…, Step 1 — Lock one idea, the…, Step 2 — Write the opener… and Step 3 — Architect the thread, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Thread Writer is an agent skill from social-media-skills/skills. Use to write a thread — a connected sequence of posts on X/Twitter or Threads that tells one story or makes one argument across multiple posts. Run when the user says "write a thread," "turn this into a thread," "X thread," "Twitter thread," "thread about X," or has a multi-beat idea that won't fit one post. Reads brand-profile and voice first, uses hook-writer for the opening post (which must hook AND promise the payoff), builds one cohesive idea where every post earns the next, and lands a close with one CTA…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `evals/evals.json`, `references/architecture.md` and `references/examples.md`).

It sits in Writing & Content, covering Social media posts. It works with X (Twitter). The repository describes itself as: 106 social media skills for AI agents - strategy, writing, video, design, platform growth, publishing, and analytics. Works with Claude, Cursor, OpenClaw, Hermes & 40+ agents. The licence is MIT.

When your agent uses it

  • Write a thread — a connected sequence of posts on X/Twitter
  • Threads that tells one story
  • Makes one argument across multiple posts
  • Says write a thread

Example prompts

  • “write a thread,”
  • “turn this into a thread,”
  • “X thread,”
  • “/thread-writer”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Read the foundation first
  2. Lock one idea, the payoff, and check it should be a thread
  3. Write the opener (hook + promise)
  4. Architect the thread
  5. Write the body posts
  6. Land the close and one CTA
  7. Format for the platform

What it can do on your machine

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

    No URLs in SKILL.md.

    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

Thread Writer loads about 1.6k tokens when it runs, and up to ~4.6k if it reads all its reference files. Until then it costs about 202 tokens; SKILL.md has 811 words of instructions outside code blocks.

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

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 social-media-skills/skills at commit 6e30eeb, republished under its MIT licence (© social-media-skills). 811 words, ~1,573 tokens.

Download SKILL.mdSave it as .claude/skills/thread-writer/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
thread-writer
description
Use to write a thread — a connected sequence of posts on X/Twitter or Threads that tells one story or makes one argument across multiple posts. Run when the user says "write a thread," "turn this into a thread," "X thread," "Twitter thread," "thread about X," or has a multi-beat idea that won't fit one post. Reads brand-profile and voice first, uses hook-writer for the opening post (which must hook AND promise the payoff), builds one cohesive idea where every post earns the next, and lands a close with one CTA. Knows when a single post beats a thread. Naming trap: "write a thread" means this multi-post chain; "post on/to Threads" means a single post on Meta's Threads app — use threads-post for that. For a single caption use caption-writer; for just the opening hook use hook-writer.
metadata.version
1.0.0
license
MIT

Thread Writer

A thread is a retention machine in text: a sequence of posts where each one has to earn the next, or the reader drops off. Done well it's one of the best formats for depth, saves, and follower growth on X. Done lazily — a blog chopped into arbitrary chunks — it's worse than a single post.

Three principles run through it:

  1. The opener is the whole game. Post 1 must hook (stop the scroll) and promise the payoff (give a reason to read all the way down). It's also the post that gets reshared, so the thread's reach lives or dies here.
  2. One idea per thread, one idea per post. A thread makes a single cohesive point; each post advances it by exactly one beat. Cramming kills it.
  3. Every post earns the next. Momentum is the metric. A post that doesn't pull the reader forward — or doesn't deserve its place — gets cut.

Step 0 — Read the foundation first

Load brand-profile.md and voice.md. Voice carries across every post; the X/Threads register is usually more conversational (use the voice tone-map). Carry guardrails throughout.

Step 1 — Lock one idea, the payoff, and check it should be a thread

  • One idea — the single point or story. If there are several, pick one or plan separate threads.
  • The payoff — what the reader gets by the end (the lesson, the list, the result).
  • Thread or single post? Thread only if the idea genuinely needs multiple beats. If it fits one post, a single punchy post almost always beats a forced thread. See references/platform-and-when.md.

Step 2 — Write the opener (hook + promise)

Use hook-writer for post 1. It must do two jobs at once: hook with a real mechanism, and promise the payoff ("here's how we did it," "7 lessons," "the story of how it broke"). The opener must also stand alone as a strong post, since it's what gets reshared. No slow wind-up. See references/post-craft.md.

Step 3 — Architect the thread

Pick the structure that fits the idea — listicle, story, argument, how-to, or breakdown — and outline the spine: the opener's promise and the ordered posts that deliver it. The spine is what makes a thread cohesive instead of a chopped article. One idea per post. See references/architecture.md.

Step 4 — Write the body posts

Each post: front-load the point, deliver one beat, stay within the platform's limit, and pull forward to the next (a mini-hook, a numbered step, "but here's the thing"). Cut any post that's filler or throat-clearing. Keep every post in the brand voice. See references/post-craft.md.

Step 5 — Land the close and one CTA

The final post delivers/summarizes the payoff, then makes one ask — matched to the goal and in voice. On X, the native growth move is asking people to reshare the opener ("If this was useful, RT the first post") and/or follow. One CTA only; a link, if any, goes here or in a reply.

Show full SKILL.md (327 more words)Show less

Step 6 — Format for the platform

Apply X vs Threads mechanics (limits, numbering, links, hashtags) from references/platform-and-when.md. Number posts where it aids orientation; never split mid-thought awkwardly; use line breaks within posts for readability.

Quality bar — self-check

  • Does the opener hook AND promise, and stand alone as a reshareable post?
  • Is it one idea, with a clear spine — not a chopped article?
  • Does every post earn the next (momentum, no filler)?
  • Does each post front-load the point and respect the platform limit?
  • Does the close land the payoff with exactly one CTA?
  • Is it in the brand voice, at the right register?
  • Should this even be a thread — or is a single post stronger?

If any post doesn't pull the reader forward, cut or rewrite it before delivering.

Edge cases

  • Should be a single post → say so and write the strong single post instead of padding a thread.
  • Multiple ideas → one idea per thread; propose a series.
  • Chopped long-form (a blog "made into a thread" by splitting) → don't. Atomize the idea and rebuild it as a native thread (see cross-platform-repurposing for the source→thread flow).
  • Threads (Meta) vs X → adapt: Threads is more casual, less thread-culture, 500/post; X has strong thread culture and the reshare-opener mechanic. A single conversational Threads post → threads-post.
  • No genuine payoff → if the idea has no real takeaway, it's not a thread; sharpen the idea first.
  • Sensitive/regulated → carry compliance guardrails into every post; no overstated claims.
  • brand-profile, voice-builder — voice + register + guardrails.
  • hook-writer — the opener (and re-hooks).
  • caption-writer — single posts/captions; threads-post — a single Meta Threads post (not a chain); cross-platform-repurposing — turn long-form into a thread.
  • scheduling-and-queue — schedule via WoopSocial. Note: WoopSocial publishes single posts only (no native multi-post chain), so schedule the opener and post the chain natively/manually.

References

  • references/architecture.md — thread structures, the spine, one-idea-per-post, length.
  • references/post-craft.md — the opener formula, post-as-unit, transitions, the close + CTA.
  • references/platform-and-when.md — X vs Threads mechanics, and when NOT to thread.
  • references/examples.md — full worked threads (listicle and story), on-voice.

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

Files

SKILL.md and 5 other files (references) in skills/thread-writer of social-media-skills/skills.

  • SKILL.md
  • evals/evals.json
  • references/architecture.md
  • references/examples.md
  • references/platform-and-when.md
  • references/post-craft.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Thread Writer 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.

Thread Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Thread Writer this skillsocial-media-skills/skills134—~1.6kAutomated 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
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 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 26 days ago
    Writing & ContentAuto-check passed

More from social-media-skills/skills

All 106 skills in this repo

  • AI Image Editing

    social-media-skills/skills

    The AI image-editing router — inpainting/object removal, background removal, upscaling, outpainting, old-photo restoration, and retouch, routed task-first to the right engine.

    134 GitHub stars~2.1k tokensUpdated 10 days ago
    Auto-check passed

  • AI Music And Sound

    social-media-skills/skills

    The AI music + sound-design skill for social -- original/licensed audio beds and sound design for Reels/TikToks/Shorts/videos.

    134 GitHub stars~1.9k tokensUpdated 10 days ago
    Auto-check passed

  • AI Search Optimization

    social-media-skills/skills

    A skill your agent uses to get a brand and its content CITED and RECOMMENDED by AI answer engines — the GEO (Generative Engine Optimization) / AI-search-visibility skill.

    134 GitHub stars~2k tokensUpdated 10 days ago
    Auto-check passed

  • AI Video

    social-media-skills/skills

    The model-agnostic AI-video router and brief — the counterpart to image-prompt.

    134 GitHub stars~1.3k tokensUpdated 10 days ago
    Auto-check passed

  • AI Voiceover

    social-media-skills/skills

    The AI narration / voiceover mini-skill (ElevenLabs-led). An agent skill from social-media-skills/skills.

    134 GitHub stars~1.1k tokensUpdated 10 days ago
    Auto-check passed

  • Analytics And Reporting

    social-media-skills/skills

    Social media analytics and reporting — read native platform data honestly and turn it into next actions.

    134 GitHub stars~1.4k tokensUpdated 10 days ago
    Auto-check passed

Works with

Categories

Questions about Thread Writer

What does Thread Writer do?

A skill your agent uses to write a thread — a connected sequence of posts on X/Twitter or Threads that tells one story or makes one argument across multiple posts. Thread Writer is an agent skill from social-media-skills/skills. Use to write a thread — a connected sequence of posts on X/Twitter or Threads that tells one story or makes one argument across multiple posts.

When should I use Thread Writer?

Thread Writer fits situations like: write a thread — a connected sequence of posts on X/Twitter; threads that tells one story; makes one argument across multiple posts; says write a thread.

How do I install Thread Writer in Claude Code?

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

How do I install Thread Writer in Codex?

Run `npx skills add social-media-skills/skills --skill thread-writer -a codex`. Or copy the skill folder (skills/thread-writer in social-media-skills/skills) into .agents/skills/thread-writer in your project. Codex loads it when a task matches its description.

Can I use Thread Writer 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 social-media-skills/skills --skill thread-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/thread-writer, .gemini/skills/thread-writer, .github/skills/thread-writer and .opencode/skills/thread-writer in your project.

What does Thread Writer need to run?

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

Does Thread Writer 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 Thread Writer 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 Thread Writer use?

Thread Writer is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Thread Writer use?

About 1.6k tokens (SKILL.md is roughly 6.3k 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 3k tokens, read only when the agent opens those files.

What are the alternatives to Thread Writer?

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

social-media-skills (a GitHub organization) maintains it in social-media-skills/skills, which has 134 GitHub stars. The repository holds 106 skills in this directory. The repository was last updated on October 1, 2026.

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