X (Twitter) Marketing Skills for Claude Code and Codex

6 skills that help Claude Code and Codex write tweets, threads, and replies on X (Twitter) in your voice. They draft content, strip AI tells, and wait for your approval before anything gets published. No coding required.

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

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 6 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 10 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.