New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Draft a single tweet or short auto-thread for X using a 2026

X post writer

by sergebulaev · MIT license · ★ 95 on GitHub · updated Sep 17

X post writer cover

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, reposts, likes, bookmarks). Respects the…

---
name: x-post-writer
description: "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, reposts, likes, bookmarks). Respects the 280-char limit (25,000 on Premium), runs the humanizer pass, and publishes via Publora on approval. Use to write a tweet from notes. Not for long threads (use x-thread-builder) or auditing a draft (use x-humanizer --mode audit)."
---

# X Post Writer

Ship a single tweet, or a tight 2-3 tweet micro-thread, using hook shapes that
actually travel on X in 2026. Single-tweet formulas land a complete punch in
the first line, because X has no "see more" fold.

## When to use

- User says "write me a tweet about X"
- User has a topic or a rough one-liner and wants a sharper hook
- User wants to pick a proven single-tweet shape and fill in their voice
- User wants a quick draft that auto-publishes on approval

Overview

Ship a single tweet, or a tight 2-3 tweet micro-thread, using hook shapes that actually travel on X in 2026. Single-tweet formulas land a complete punch in the first line, because X has no "see more" fold.

Manual install (npx, ZIP)
Claude Codenpx skills add sergebulaev/x-skills --skill x-post-writer -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/sergebulaev/x-skills/tar.gz/061109fdcb0b \ | tar -xz -C ~/.claude/skills --strip-components=4 x-skills-061109fdcb0b/.codex-marketplace/x-skills/skills/x-post-writer
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/4e557d7c042559e5931f/x-post-writer.zip" -OutFile "$env:TEMP\x-post-writer.zip"; Expand-Archive "$env:TEMP\x-post-writer.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md6.5 KB
  • references/1 file · 2.5 KB
Read the files here
sergebulaev/061109f2 files
Shared references4SKILL.md reads these from elsewhere in the repo. Not in the ZIP.Get them on GitHub ↗
SKILL.md
Show the full text123 lines

X Post Writer

Ship a single tweet, or a tight 2-3 tweet micro-thread, using hook shapes that actually travel on X in 2026. Single-tweet formulas land a complete punch in the first line, because X has no "see more" fold.

When to use

  • User says "write me a tweet about X"
  • User has a topic or a rough one-liner and wants a sharper hook
  • User wants to pick a proven single-tweet shape and fill in their voice
  • User wants a quick draft that auto-publishes on approval

Formulas this skill uses (single-tweet shapes)

Code Formula Primary goal Best for
X1 One-Liner Contrarian reposts a sharp, defensible against-the-grain take
X2 Data-Point Hook bookmarks one odd-precision number that reframes a thing
X3 Build-in-Public Confession replies a real metric from your own work, ugly ones included
X4 Quote-Tweet Dunk-with-Value reposts adding a layer to someone else's take (quote tweet)
X5 Mini-List Tweet bookmarks a scannable list that fits in one tweet
X6 Relatable Cold-Open likes a specific shared moment, no setup
X11 Third-Person Case-Study Flex reposts someone else's absurd, specific result as anyone-could-copy bait

Full skeletons in ../../references/hook-formulas.md. For long-form tweetstorms (X7-X10), use x-thread-builder. X11 was validated as the top-recurring winning shape in a ~450-tweet corpus (July 2026); prefer it over a first-person "How I" when the result you are citing is someone else's.

Pick by goal first
Goal Reach for
Replies X3, X1
Reposts X1, X4, X11
Likes X6
Bookmarks X2, X5, X11

Steps

Voice profile first (all drafts). If ../../references/voice-profile.md has filled: yes, load it and match the user's voice fingerprint, hard rules, and CTA/link style throughout. If it is not filled, mention once that x-humanizer --mode profile can learn their voice from a few posts, then proceed with the generic voice rules.

  1. Gather inputs. Topic, angle, any rough draft, target audience (builders / founders / a niche), and the goal (replies / reposts / likes / bookmarks).
  2. Pick the container. If the idea is one claim, one number, or one moment, it is a single tweet. If it is a scannable one-line-per-item list, still a single tweet (X5). If items need teaching or the idea has a build, hand off to x-thread-builder.
  3. Pick the formula. Use the goal table to shortlist, then suggest 2-3 that also fit the topic and let the user choose.
  4. Draft the tweet. Fill the skeleton in the user's voice. Respect the 2026 X rules:
    • First line carries the whole load (no fold).
    • Under 280 chars on a standard account (emoji count as 2 chars). Confirm the user's tier; only go long if they are on Premium and the length earns it.
    • One idea per tweet. Line breaks as beats.
    • 0-1 hashtag at the end, 0-1 emoji, none on a serious take.
    • No external link in the tweet (offer to put it in a reply).
  5. Humanizer pass. Scrub 2026 AI vocab by density, cap em dashes (at most one per tweet, never swap one for a period), break stacked triads, generic openers and reveal bridges. Leave a single tweet's rhythm alone (uniform rhythm wins on short posts; never insert a fragment for punch). Add an odd-precision number with a named referent or a named entity where the claim allows it. Canonical rules: x-humanizer V3.
  6. Optional audit. Invoke x-humanizer --mode audit for a pass-fail check.
  7. Approval card. Show: formula used, full draft, char count (note if emoji push it over 280), suggested posting window, primary goal.
  8. On approval. Call lib.publish(kind="post", draft_text=<approved>, target_url="https://x.com/compose/tweet", platforms=[<X_PLATFORM_ID>], scheduled_time=<iso_or_None>). The wrapper handles Publora / manual / diy routing. If the content runs long, Publora auto-splits it into a numbered thread.

Hard rules

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

  • The first line must stop the scroll on its own. Rewrite any opener that needs line 2 to make sense.
  • Keep a standard-account tweet inside 280 chars. If it does not fit, tighten it or escalate to a thread, never ship a truncated thought.
  • One specific number where the claim allows it. 2.4x beats "way better".
  • Do not hard-sell the user's product. One natural mention max.

Anti-patterns (skill will refuse)

  • ALL CAPS first line for intensity. Carry intensity with word choice.
  • Em dashes above the cap (more than one in a tweet), or an em dash swapped for a period.
  • "Here's what / here's how" or "Stop X, start Y" as the opener; "The result?" as a reveal.
  • Announced candor ("Let me be honest", "not gonna lie") with no dated fact behind it.
  • "Unpopular opinion:" on a take that is actually popular.
  • Padding a one-line idea with filler to look substantial.
  • Rule-of-three lists without specifics.
  • "leverage", "fundamentally", "game-changer", "deep dive".
  • External link in the tweet body.
  • Engagement bait ("RT if you agree", "reply YES").

Resources

  • ../../references/hook-formulas.md - all 11 X formula skeletons (X1-X6 and X11 are single-tweet)
  • ../../references/algorithm-heuristics.md - 2026 X ranking rules (signals, timing, limits)
  • references/single-tweet-checklist.md - the per-tweet scrub and fit list

Optional illustration

Offer a generated image when a visual would lift reach. Draft a prompt and call lib.illustrate(prompt, kind="wide"), pulling brand handle/color from Voice & Brand Profile section 6 for a pixel-exact overlay. Show the returned url + cost, then attach on publish via media_urls=[url]. Full workflow (incl. quote-cards): ../x-humanizer/sub-skills/illustration.md. No Pixfaro key -> it drafts the prompt for you to generate manually.

  • x-thread-builder - when the idea needs more than a tweet
  • x-humanizer - aggressive AI-tell scrubber, plus --mode audit for review
  • x-hook-extractor - reverse-engineer a hook from a tweet you admire
1---
2name: x-post-writer
3description: "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, reposts, likes, bookmarks). Respects the 280-char limit (25,000 on Premium), runs the humanizer pass, and publishes via Publora on approval. Use to write a tweet from notes. Not for long threads (use x-thread-builder) or auditing a draft (use x-humanizer --mode audit)."
4---
5 
6# X Post Writer
7 
8Ship a single tweet, or a tight 2-3 tweet micro-thread, using hook shapes that
9actually travel on X in 2026. Single-tweet formulas land a complete punch in
10the first line, because X has no "see more" fold.
11 
12## When to use
13 
14- User says "write me a tweet about X"
15- User has a topic or a rough one-liner and wants a sharper hook
16- User wants to pick a proven single-tweet shape and fill in their voice
17- User wants a quick draft that auto-publishes on approval
18 
19## Formulas this skill uses (single-tweet shapes)
20 
21| Code | Formula | Primary goal | Best for |
22|---|---|---|---|
23| X1 | One-Liner Contrarian | reposts | a sharp, defensible against-the-grain take |
24| X2 | Data-Point Hook | bookmarks | one odd-precision number that reframes a thing |
25| X3 | Build-in-Public Confession | replies | a real metric from your own work, ugly ones included |
26| X4 | Quote-Tweet Dunk-with-Value | reposts | adding a layer to someone else's take (quote tweet) |
27| X5 | Mini-List Tweet | bookmarks | a scannable list that fits in one tweet |
28| X6 | Relatable Cold-Open | likes | a specific shared moment, no setup |
29| X11 | Third-Person Case-Study Flex | reposts | someone else's absurd, specific result as anyone-could-copy bait |
30 
31Full skeletons in `../../references/hook-formulas.md`. For long-form tweetstorms
32(X7-X10), use `x-thread-builder`. X11 was validated as the top-recurring winning
33shape in a ~450-tweet corpus (July 2026); prefer it over a first-person "How I"
34when the result you are citing is someone else's.
35 
36### Pick by goal first
37 
38| Goal | Reach for |
39|---|---|
40| Replies | X3, X1 |
41| Reposts | X1, X4, X11 |
42| Likes | X6 |
43| Bookmarks | X2, X5, X11 |
44 
45## Steps
46 
47**Voice profile first (all drafts).** If `../../references/voice-profile.md` has `filled: yes`, load it and match the user's voice fingerprint, hard rules, and CTA/link style throughout. If it is not filled, mention once that `x-humanizer --mode profile` can learn their voice from a few posts, then proceed with the generic voice rules.
48 
491. **Gather inputs.** Topic, angle, any rough draft, target audience (builders /
50 founders / a niche), and the goal (replies / reposts / likes / bookmarks).
512. **Pick the container.** If the idea is one claim, one number, or one moment,
52 it is a single tweet. If it is a scannable one-line-per-item list, still a
53 single tweet (X5). If items need teaching or the idea has a build, hand off
54 to `x-thread-builder`.
553. **Pick the formula.** Use the goal table to shortlist, then suggest 2-3 that
56 also fit the topic and let the user choose.
574. **Draft the tweet.** Fill the skeleton in the user's voice. Respect the 2026
58 X rules:
59 - First line carries the whole load (no fold).
60 - Under 280 chars on a standard account (emoji count as 2 chars). Confirm the
61 user's tier; only go long if they are on Premium and the length earns it.
62 - One idea per tweet. Line breaks as beats.
63 - 0-1 hashtag at the end, 0-1 emoji, none on a serious take.
64 - No external link in the tweet (offer to put it in a reply).
655. **Humanizer pass.** Scrub 2026 AI vocab by density, cap em dashes (at
66 most one per tweet, never swap one for a period), break stacked triads,
67 generic openers and reveal bridges. Leave a single tweet's rhythm alone
68 (uniform rhythm wins on short posts; never insert a fragment for punch).
69 Add an odd-precision number with a named referent or a named entity where
70 the claim allows it. Canonical rules: `x-humanizer` V3.
716. **Optional audit.** Invoke `x-humanizer --mode audit` for a pass-fail check.
727. **Approval card.** Show: formula used, full draft, char count (note if emoji
73 push it over 280), suggested posting window, primary goal.
748. **On approval.** Call `lib.publish(kind="post", draft_text=<approved>,
75 target_url="https://x.com/compose/tweet", platforms=[<X_PLATFORM_ID>],
76 scheduled_time=<iso_or_None>)`. The wrapper handles Publora / manual / diy
77 routing. If the content runs long, Publora auto-splits it into a numbered
78 thread.
79 
80## Hard rules
81 
82Global voice rules: see root `SKILL.md` Voice rules. Additional skill-specific
83rules:
84 
85- The first line must stop the scroll on its own. Rewrite any opener that needs
86 line 2 to make sense.
87- Keep a standard-account tweet inside 280 chars. If it does not fit, tighten it
88 or escalate to a thread, never ship a truncated thought.
89- One specific number where the claim allows it. 2.4x beats "way better".
90- Do not hard-sell the user's product. One natural mention max.
91 
92## Anti-patterns (skill will refuse)
93 
94- ALL CAPS first line for intensity. Carry intensity with word choice.
95- Em dashes above the cap (more than one in a tweet), or an em dash swapped for a period.
96- "Here's what / here's how" or "Stop X, start Y" as the opener; "The result?" as a reveal.
97- Announced candor ("Let me be honest", "not gonna lie") with no dated fact behind it.
98- "Unpopular opinion:" on a take that is actually popular.
99- Padding a one-line idea with filler to look substantial.
100- Rule-of-three lists without specifics.
101- "leverage", "fundamentally", "game-changer", "deep dive".
102- External link in the tweet body.
103- Engagement bait ("RT if you agree", "reply YES").
104 
105## Resources
106 
107- `../../references/hook-formulas.md` - all 11 X formula skeletons (X1-X6 and X11 are single-tweet)
108- `../../references/algorithm-heuristics.md` - 2026 X ranking rules (signals, timing, limits)
109- `references/single-tweet-checklist.md` - the per-tweet scrub and fit list
110 
111## Optional illustration
112 
113Offer a generated image when a visual would lift reach. Draft a prompt and call
114`lib.illustrate(prompt, kind="wide")`, pulling brand handle/color from Voice &
115Brand Profile section 6 for a pixel-exact overlay. Show the returned `url` + `cost`,
116then attach on publish via `media_urls=[url]`. Full workflow (incl. quote-cards):
117`../x-humanizer/sub-skills/illustration.md`. No Pixfaro key -> it drafts the prompt for you to generate manually.
118## Related skills
119 
120- `x-thread-builder` - when the idea needs more than a tweet
121- `x-humanizer` - aggressive AI-tell scrubber, plus `--mode audit` for review
122- `x-hook-extractor` - reverse-engineer a hook from a tweet you admire
123 
View all files on GitHub →

Details

Updated
Sep 17, 2026
License
MIT
Stars on the repo
★ 95
Checked
Source
sergebulaev/x-skills ↗
Creator
sergebulaev · 77 listings
View creator

Similar skills

See all →
SkillResearch what people actually say about any topicSTEP 0: STALE-CLONE SELF-CHECK — RUN BEFORE READING BELOWmvanhorn/last30days-skill · by mvanhornResearch what people actually say about any topic in the last 30 days. Pulls posts and engagement from Reddit, X, YouTube, TikTok, Hacker News, Polymarket, GitHub, and the web. Includes a doctor health check to diagnose broken or missing sources.★ 63.5k GitHub starsSkillScrapes social platforms, business dataApifydanielmiessler/LifeOS · by danielmiesslerScrapes social platforms, business data, and e-commerce via Apify actors — Instagram, LinkedIn, TikTok, YouTube, Facebook, Google Maps, Amazon, and web crawls — filtering in code. USE WHEN scrape Instagram, scrape LinkedIn, scrape TikTok, scrape YouTube, scrape Facebook, Google Maps leads, Amazon reviews, business intelligence, multi-platform social listening, competitive analysis, lead generation, social monitoring, Apify actors, web crawl, extract contacts. NOT FOR X/Twitter account operations like posting, threads, or bookmarks (those need a dedicated X API client), 4-tier progressive scraping with proxy escalation (use BrightData), or real-Chrome bot bypass and computer use (use Interceptor).★ 19.3k GitHub starsSkill微信公众号长文增长闭环 ——tsingyuai/growth-lab · by tsingyuai微信公众号长文增长闭环 —— 从读者问题与复刻锚选题、写出可验证的公众号长文、预览与合规检查、同步微信草稿、三重确认下受控发布,到回收阅读与转化数据并复盘。用户要求写公众号、把内容改成公众号、同步或发布微信草稿、查看公众号数据或复盘时使用。★ 2k GitHub starsSkillSearch and retrieve content from Twitter/XTwitter/X SkillReScienceLab/opc-skills · by ReScienceLabSearch and retrieve content from Twitter/X. Get user info, tweets, replies, followers, communities, spaces, and trends via twitterapi.io. Use when user mentions Twitter, X, or tweets.★ 1.8k GitHub starsSkillSays 'YouTube script', 'video script'🎬 YouTube Script: Writing retention-optimized video script...cwinvestments/memstack · by cwinvestmentsUse this skill when the user says 'YouTube script', 'video script', 'write script for YouTube', 'YouTube video outline', or is creating scripted content for a YouTube video with hooks, chapters, and CTAs. Do NOT use for TikTok/Reels short-form scripts or webinar presentations.★ 423 GitHub starsSkillAgent Reach — 互联网能力路由器Ootto-AI/claude-content-skills · by Ootto-AIMUST USE when user wants to 调研/research/搜索/search/查/找/look up anything on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X / 看看大家怎么评价 X / X 上有什么讨论 / research this topic。 Also MUST USE when user mentions any platform or shares any URL/链接: 小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili, Reddit, V2EX, LinkedIn/领英/招聘/求职/jobs, YouTube, GitHub code search, 小宇宙播客, 雪球/股票行情, RSS feeds, or any web URL. 13 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs). Zero config for 6 channels. Run `agent-reach doctor --json` to see which backend serves each platform right now. NOT for: 写报告/数据分析/翻译等内容加工(本 skill 只负责从互联网获取内容); 发帖/评论/点赞等写操作;已有专门 skill 的平台(先用专门 skill)。 【路由方式】SKILL.md 包含路由表和常用命令,复杂场景需按需阅读对应分类的 references/*.md。 分类:search / social (小红书/推特/B站/V2EX/Reddit) / career(LinkedIn) / dev(github) / web(网页/文章/RSS) / video(YouTube/B站/播客)。★ 139 GitHub stars

More from sergebulaev

SkillBy density per paragraph, not per wordAI Tells — Complete Blacklist (V3, 2026-09)sergebulaev/linkedin-skills · by sergebulaevScored the way readers read: by density per paragraph, not per word. One marker in a paragraph is English. Three is a signature. The…★ 3.1k GitHub starsSkillFifteen rules from the linkedin-humanizer packageAI-Tell Rules: Tier-Classified Referencesergebulaev/linkedin-skills · by sergebulaevFifteen rules from the linkedin-humanizer package, sorted by what kind of evidence each one actually represents.★ 3.1k GitHub starsSkillPattern data from MagicPost LinkedIn analysisEmoji Patterns — AI vs. Humansergebulaev/linkedin-skills · by sergebulaevPattern data from MagicPost LinkedIn analysis (Feb 2026, viral post with 220 engagement).★ 3.1k GitHub starsSkillRead your Instagram niche and profile from real dataInstagram Audience Insightssergebulaev/instagram-skills · by sergebulaevRead your Instagram niche and profile from real data via Apify, no login. Scan a hashtag for the posts traveling now (likes, comments, owner) to see the format and hook that works. Pull profile stats for any handle, yours or a competitor's: followers, posts, bio, category. Instagram hides who liked or commented on other accounts, so this is discovery plus profiles, not engagers. Triggers on "what works in my niche", "scan the hashtag", "competitor stats". Not for writing captions (use ig-caption-writer).★ 138 GitHub starsSkillDraft an Instagram caption with the hook in the first 125Instagram Caption Writersergebulaev/instagram-skills · by sergebulaevDraft an Instagram caption with the hook in the first 125 characters, a skimmable body, and one clear CTA, using a 2026 hook formula chosen by goal (saves, shares, comments, follows). Runs the humanizer pass and, on approval, publishes with the image or video you supply via the Publora media flow. Use to caption a single image or a Reel. Not for slide-by-slide carousels (use ig-carousel-planner) or auditing a draft (use ig-humanizer --mode audit).★ 138 GitHub starsSkillPlan an Instagram carousel slide by slide, up to 10 slidesInstagram Carousel Plannersergebulaev/instagram-skills · by sergebulaevPlan an Instagram carousel slide by slide, up to 10 slides, with a hook slide that opens a loop, value slides that front-load the payoff, and a payoff slide that earns the save and follow. Picks a 2026 carousel formula (listicle, before/after, myth-buster, framework) by goal (saves, shares, follows), drafts each slide's text plus the caption, then publishes the images you supply via Publora. Use to structure a multi-slide carousel. Not for single-image captions (use ig-caption-writer).★ 138 GitHub stars