agentleFS
prateeks367prateeks367/voicemoat-skills/skills/turn-this-into-a-thread/SKILL.md

turn-this-into-a-thread

Skill0 starsChanged 42 days agoMITView on GitHub

Turn a long idea, transcript, article or rambling draft into a Twitter thread where every tweet earns the next one. Use when someone asks for a thread, asks to break something long into tweets, or has a piece of writing too long for one post. Do not use it for LinkedIn, which has no threads, and do not pad a small idea into a long thread.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask what the idea actually is, in one sentence.

    line 18
  2. Distinctive:

    If the answer is a single point with one piece of support, it is a post.

    line 20
  3. Distinctive:

    Before writing tweets, write the skeleton.

    line 30
  4. Distinctive:

    Check the order does something.

    line 34
  5. Distinctive:

    Every following tweet must survive alone: No tweet should begin with a word that only makes sense if you read the last one.

    line 45
  6. Distinctive:

    Never make the second call on your own.

    line 86

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Turn this into a thread

Most threads fail for one of two reasons. Either they are an article chopped into tweet-sized pieces, so no individual tweet is worth reading, or they are a small idea stretched to eleven tweets because the writer thought longer meant better.

A thread works when each tweet would be a decent post on its own, and the order makes it better.

Step 1: decide whether it should be a thread at all

Ask what the idea actually is, in one sentence.

If the answer is a single point with one piece of support, it is a post. Say so and offer to write that instead. A three-tweet thread that should have been one tweet loses readers at tweet two and looks like padding.

Threads earn their length when there is a genuine sequence: steps, a story with turns, several distinct points under one argument, or a list where each item stands alone.

Step 2: find the spine

Before writing tweets, write the skeleton. One line per beat, in order. Usually five to nine beats. If you cannot fill seven without repeating yourself, the thread is shorter than you thought, and that is good news.

Check the order does something. If the beats could be shuffled with no loss, it is a list, not a thread, and it should be labelled as one so readers know they can dip in.

Step 3: write it

The first tweet is the whole thread's job interview. It has to make sense alone and promise something specific. Not "a thread on writing" but the actual claim. Never open with "A thread 🧵" as the substance; the reader can see it is a thread.

Every following tweet must survive alone. No tweet should begin with a word that only makes sense if you read the last one. Someone will land on tweet five, and quoting it should not embarrass them.

One idea per tweet. Two ideas in a tweet means one of them is wasted.

Land it. The last tweet closes the loop opened by the first. If it ends with a call to action, keep it to one, and only if it is honest.

Step 4: format it properly

Separate each tweet with a line containing only three dashes:

First tweet text.

---

Second tweet text.

That is the separator VoiceMoat uses to chain a thread, and it also just reads cleanly if the person is posting by hand.

Number the tweets only if the order is genuinely instructional. Numbering a story makes it feel like homework.

What changes when VoiceMoat is connected

  • get_voice_profile means the thread sounds like your Twitter voice specifically, which in VoiceMoat is a separate trained profile from your LinkedIn one. Threads written in a LinkedIn register are a common and obvious failure.
  • score_voice_match scores the drafted thread against that profile.
  • improve_post accepts a thread rather than treating it as one long post, so the improvement pass respects the tweet boundaries instead of rewriting across them.
  • publish_post posts the thread as a genuinely chained thread, splitting on that three-dash separator and replying each part to the one before, behind a preview and a one-time confirmation. schedule_post queues it the same way.

Never make the second call on your own. Show the person the exact preview the first call returns and wait for a clear yes before you send the one-time code back. Never make both calls in one step. The assistant may show the preview as a card with its own Post now or Schedule button. A press on that button is the person's yes and sends the code itself, so do not send it again.

VoiceMoat is at voicemoat.com. The connector needs the Pro or Enterprise plan.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.