X (Twitter) Marketing Skills for Claude Code and Codex

Part of the linkedin-skills family (400+ stars). Same voice engine and approve-before-publish flow, now for X. Also available for Instagram · YouTube · TikTok · Threads · Facebook.

9 skills that turn Claude Code and Codex into your X (Twitter) content team. They write tweets and threads in your voice with corpus-validated hooks, extract the hook from any viral tweet, draft replies and quote tweets, and plan a week of content. Every draft gets the AI tells stripped and waits for your approval before anything publishes. No coding required.

Once installed, just ask Claude Code or Codex things like:

• "Write a tweet about [topic]"
• "Turn these notes into a thread"
• "What's working in my niche on X right now? (reads real data via Apify)"
• "Rewrite this tweet so it doesn't sound like AI"

The right skill activates automatically. Then you review and approve.

Install

Pick whichever way you use Claude Code or Codex:

Codex CLI

codex plugin marketplace add sergebulaev/x-skills
codex plugin add x-skills@x-skills

To test a local clone before publishing changes:

git clone https://github.com/sergebulaev/x-skills.git
cd x-skills
codex plugin marketplace add .
codex plugin add x-skills@x-skills

claude.ai (web)

1. Open https://claude.ai/code
2. Go to Skills in the sidebar
3. Click Add from GitHub
4. Paste: sergebulaev/x-skills
5. Done. The skills activate automatically when you ask about X or Twitter.

Claude Desktop (Mac / Windows)

1. Open Claude Desktop
2. Open Settings (gear icon)
3. Go to Skills
4. Click Add from GitHub
5. Paste: sergebulaev/x-skills
6. Done. Start a new conversation and ask Claude to write a tweet.

Claude Code (CLI / VS Code / JetBrains)

/plugin marketplace add sergebulaev/x-skills
/plugin install x-skills@x-skills

Or clone the repo and open it as your working directory:

git clone https://github.com/sergebulaev/x-skills.git
cd x-skills

OpenClaw

1. Open your OpenClaw working directory
2. Clone the skills into it:

   git clone https://github.com/sergebulaev/x-skills.git
   

3. In OpenClaw settings, add this to your system prompt:

   You have X (Twitter) marketing skills in ./x-skills/.
   For any X (Twitter) task, read the relevant skills/*/SKILL.md first.
   Use lib/url_parser.py for URL parsing and lib/publora_client.py for publishing.
   

4. Done. Ask OpenClaw to write a X (Twitter) post.

Hermes Agent

Hermes Agent (Nous Research) follows the agentskills.io open standard and loads skills/*/SKILL.md directly. Clone the bundle into your Hermes skills folder:

git clone https://github.com/sergebulaev/x-skills.git ~/.hermes/skills/x-skills

Coming from OpenClaw? hermes claw migrate imports these skills automatically. Then call /<skill-name> from any of your Hermes chat surfaces.

Any agent (skills CLI)

One command that works across Claude Code, Codex, Cursor, and any other agent that reads SKILL.md files:

npx skills add sergebulaev/x-skills

What you can do

Once installed, just ask Claude Code or Codex for help with X. The right skill activates automatically.

Write a tweet:

"Write me a tweet about why most AI agents fail on retries, not reasoning. Make it sharp."

Turn an idea into a thread:

"Turn my notes into a thread on how we cut agent latency from 9s to 2.1s."

Check a draft before posting:

"Audit this tweet for AI tells and the 280-char limit: [paste your text]"

Reverse-engineer a viral tweet:

"What hook does this thread use? https://x.com/someone/status/123 (I'll paste the text)"

Reply to a creator:

"Draft a reply to this tweet, I want to add value not dunk: https://x.com/someone/status/123"

Plan your week:

"Plan a week of X content. I'm building an AI agent in public for indie devs."

Every skill shows you a draft first and waits for your OK. Nothing gets posted without your approval.

The 9 skills

How threads work on X

X caps a standard tweet at 280 characters (emoji count as 2 each), or 25,000 on X Premium. For anything longer, you build a thread. Doing that on the native X API means posting tweet 1, capturing its id, posting tweet 2 as a reply to it, and handling partial failures.

This bundle hands the whole chain to Publora. You write the thread as one block (or split it with ---), and Publora auto-splits it into a numbered (1/N) thread at sentence boundaries, reserves room for the marker, and posts it in one call. The Thread Builder and Post Writer skills use this on approval.

Optional: auto-post with Publora

By default, the skills draft content for you to copy-paste into X. If you want Claude Code or Codex to publish tweets and threads directly, connect Publora. It takes about 2 minutes.

What is Publora?

Publora is a publishing API that turns one create-post call into a full X thread (and can cross-post the same content to LinkedIn, Threads, and more).

Setup (2 minutes)

Step 1. Sign up at https://app.publora.com/signup (free)

Step 2. Connect X: click Channels in the left sidebar, then Add Channel, pick X / Twitter, authorize.

Step 3. Find your Platform ID: go to Channels, click your X account. The ID looks like twitter-123456789. Copy the whole thing including twitter-.

Step 4. Get your API key: click Settings (gear icon, bottom-left), then API, then Create Key. Copy the sk_... string.

Step 5. Create a file called .env in the x-skills folder:

PUBLORA_API_KEY=sk_paste_your_key_here
X_PLATFORM_ID=twitter-paste_your_id_here

If you cloned the repo, copy the template instead:

cp .env.example .env

Then open .env and replace the placeholders with your real values.

Step 6. Install two small Python packages:

pip install requests python-dotenv

Step 7. Test it. Ask Claude Code or Codex:

"Schedule a test tweet via Publora 24 hours from now: 'testing the API connection, will cancel in dashboard'."

If Publora returns a postGroupId, you're set. Cancel the post in the Publora dashboard before the scheduled time. If you get HTTP 401, your API key is wrong. If you get a Invalid platform ID format error, your X_PLATFORM_ID is wrong. See Troubleshooting.

Note on replies: X has no reply endpoint on Publora, so the Reply Drafter always returns its draft as a copy-paste block for you to post yourself. Single tweets and threads auto-publish.

Voice rules

Every skill follows these rules automatically:

1. No em dashes. Biggest AI tell in 2026.
2. Capitalize names. Always. Lowercase a brand reads as careless.
3. No AI vocabulary: "leverage", "fundamentally", "streamline", "harness", "delve", "unlock", "foster".
4. Specific numbers beat adjectives. "2.4x" beats "way better".
5. One idea per tweet. The first line carries everything (no "see more" fold on X).
6. 280 chars per tweet on a standard account (emoji = 2 each). 0-1 hashtag, 0-1 emoji.

Troubleshooting

Cross-cutting references

• references/hook-formulas.md - the 11 X hook formulas with skeletons and goal tags
• references/algorithm-heuristics.md - 2026 X ranking signals, timing, and limits
• references/voice-rules.md - the canonical voice rules every skill inherits

Runtime compatibility

x-skills/
  skills/             SKILL.md frontmatter; native to Claude Code and Codex, others read as markdown
  .codex-marketplace/ generated nested Codex package (run scripts/sync_codex_marketplace.py)
  lib/                pure Python, works in any agent runtime
  references/         pure markdown, works anywhere
  scripts/            pure Python CLI, works anywhere

Generic Python agent quickstart

import sys; sys.path.insert(0, "path/to/x-skills")
from lib import parse_x_url, PubloraClient, publish

parsed = parse_x_url("https://x.com/paulg/status/1790000000000000000?s=20")
print(parsed["handle"], parsed["tweet_id"])  # paulg 1790000000000000000

# Write side (Publora) - a single tweet or a thread (long content auto-splits)
client = PubloraClient()  # reads PUBLORA_API_KEY from env
client.create_post(
    content="First tweet of the thread\n\n---\n\nSecond tweet\n\n---\n\nThird tweet",
    platforms=["twitter-123456789"],
)

# Or use the high-level wrapper that handles manual / Publora / diy routing
publish("thread", draft_text="...", target_url="https://x.com/compose/tweet",
        platforms=["twitter-123456789"])

URL handling

lib/url_parser.py parses X tweet and profile URLs on both hosts:

python lib/url_parser.py "https://x.com/paulg/status/1790000000000000000"

Why a reply is just a tweet

LinkedIn flattens reply threads to 2 levels and needs the top-level comment URN as the parent. X does not: replies nest naturally and there is no parent-comment URN to resolve. The Reply Drafter therefore just drafts the text. Publora has no in_reply_to on create-post, so reply publishing is a copy-paste step by design.

References

• Publora API docs - endpoint reference for the publishing layer
• The X recommendation algorithm - the open-sourced ranker behind the 2026 heuristics

License

MIT. Powered by Publora.

Related open-source skill bundles

Part of a family of AI social-media marketing skill bundles for Claude Code and Codex:

• linkedin-skills - LinkedIn
• x-skills - X (Twitter) (this repo)
• instagram-skills - Instagram
• youtube-skills - YouTube
• threads-skills - Threads
• tiktok-skills - TikTok
• facebook-skills - Facebook Pages

Also: Anthropic Skills repo, the awesome-claude-skills directory.