AI Skill

Claude X (Twitter) Skill

A specialized AI skill that turns Claude/ChatGPT/Cursor into an X (Twitter) automation expert. Covers X API v2 chunked video upload, reply controls (following / mentioned / everyone), alt text for accessibility, BYOK setup with X Basic ($100/mo) or Pro for dedicated rate limits, and the difference between standard 280-char posts and 25K-char posts on Premium accounts.

X (Twitter)

Best for:Developers and AI workflows that need reliable X posting at scale, Premium account holders posting long-form content, agencies with X Basic+ for BYOK.

What this skill teaches the LLM

The skill is a markdown file the LLM reads when activating. Below is the focused context this skill bakes in — so Claude/ChatGPT/Cursor doesn't have to learn from API errors.

  • X API v2 (not v1.1) — chunked video upload handled by CodivUpload
  • Text length: 280 chars on standard accounts, 25,000 chars on X Premium (auto-detected by X via same API)
  • Image attachments: up to 4 per post, JPEG/PNG/GIF/WebP, max 5 MB each
  • Video format: MP4 H.264, max 512 MB, max 2 min 20 sec, any aspect ratio (16:9 recommended)
  • Reply settings: x_reply_settings='following' or 'mentionedUsers' (omit for everyone)
  • X free dev tier: NO write access — must use CodivUpload's shared OAuth or upgrade to X Basic ($100/mo) for BYOK
  • BYOK setup: X Developer App at developer.x.com → Project + App → OAuth 2.0 → paste credentials in CodivUpload Profiles
  • Rate limits: 200 writes/15min on X Basic, 1500 writes/15min on X Pro ($5K/mo)

Example prompts

These are real prompts you can give an AI client with this skill installed. The skill provides the LLM with the right tool calls, parameter names, and platform-specific quirks so the response is correct on the first try.

1

Schedule a 3-tweet thread about API design for tomorrow at 9am.

What the LLM does

Claude composes 3 separate create_post calls with text fields, links them via reply chain (X has no native thread API for scheduled posts — Claude handles via parent post + replies).

2

Post a 2-minute video to X with alt text for accessibility.

What the LLM does

Claude calls create_post with post_type=video, media_urls=[mp4_url], x_alt_text describing the video for screen readers.

3

Why is my X automation returning 403?

What the LLM does

Claude diagnoses: X free dev tier doesn't include write permissions. Recommends upgrading to X Basic ($100/mo) or using CodivUpload's shared OAuth flow.

Install in 2 steps

The skill itself is a markdown file. The MCP server is the runtime. Install both for the full experience.

  1. 1Configure MCP server in your AI client

    Paste this configuration into Claude Desktop / Cursor / Zed's MCP config file. Replace cdv_your_api_key with your real key from pricing.

    {
      "mcpServers": {
        "codivupload": {
          "command": "npx",
          "args": ["-y", "codivupload-mcp"],
          "env": {
            "CODIVUPLOAD_API_KEY": "cdv_your_api_key"
          }
        }
      }
    }
  2. 2Add the skill markdown

    Download npmjs/skills/x/SKILL.md from the GitHub repo and place it under ~/.claude/skills/codivupload-x/SKILL.md (Claude Desktop) or your project's .claude/skills/ directory.

    For ChatGPT: paste the SKILL.md content into a Custom GPT's Instructions field at gpts.openai.com/editor.

    github.com/Codivion

Frequently asked

Can I post 25,000-char tweets via the API?+

Yes — X Premium accounts can post up to 25,000 chars via the same API. The skill teaches Claude to not artificially truncate when the user has Premium.

Does the skill help with BYOK setup?+

Yes — full walkthrough of X Developer Account creation, OAuth 2.0 configuration, redirect URI, paste credentials in CodivUpload Dashboard. Explains X Basic ($100/mo) requirement for write permissions on the free dev tier.

What about X threads?+

X's API doesn't have a native thread endpoint for scheduled posts. The skill handles this by composing a parent post + reply chain, posted as a single logical thread by the LLM.

Ready to give your AI agent posting tools?

Free CodivUpload plan covers 30 posts/month. Skills are MIT licensed.

Get an API key