Thread writer
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.From its SKILL.md
npx -y skills add social-media-skills/skills --skill thread-writerAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 26 days oldThe repository was created 26 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
6.2 KB, ~1.4k tokens by cl100k_base, as published. Nobody here has run it
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:
- 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.
- 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.
- 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.
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-repurposingfor 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.
Related skills
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.
What ships with it: 5 files
15.0 KB alongside SKILL.md
evals/
- evals.json3.3 KB
references/
- architecture.md3.1 KB
- examples.md3.4 KB
- platform-and-when.md2.5 KB
- post-craft.md2.7 KB