XT

X (Twitter) Integration Manager

Comprehensive management of X/Twitter API operations with tier-based feature gating and monitoring.

Install

mkdir -p .claude/skills/x-twitter-integration-manager && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10750" && unzip -o skill.zip -d .claude/skills/x-twitter-integration-manager && rm skill.zip

Installs to .claude/skills/x-twitter-integration-manager

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Comprehensive X (Twitter) integration with tier detection (Free, Basic, Pro, Enterprise), posting, search, streaming, and analytics. Automatically detects API tier and adapts features with cost warnings.
203 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Detect the current X API tier (Free, Basic, Pro, Enterprise)
  • Post tweets programmatically
  • Search and monitor tweets and hashtags
  • Stream tweets in real-time (Pro+ tier)
  • Automate direct messages (Pro+ tier)
  • Access social media analytics and metrics (Pro+ tier)

How it works

The skill uses the X API to interact with the platform, automatically detecting the API tier to adapt available features and provide cost warnings.

Inputs & outputs

You give it
X API credentials, tweet content, search queries, user timelines
You get back
Posted tweets, search results, user timelines, API tier information

When to use X (Twitter) Integration Manager

  • Automating social posts
  • Monitoring hashtags
  • Analyzing engagement metrics

About this skill

X (Twitter) Integration Manager

Comprehensive X (Twitter) integration with intelligent API tier detection. Automatically adapts to your API access level and provides upgrade guidance with clear cost warnings.

Overview

  • 4-Tier API Detection: FREE → BASIC → PRO → ENTERPRISE
  • Automatic Tier Detection: Tests API capabilities to determine access level
  • Feature Gating: Shows only available features for current tier
  • Cost Warnings: Proactive warnings about tier costs (Pro: $5,000/month!)
  • Rate Limit Tracking: Monitors and enforces tier-specific limits
  • Comprehensive Features: Posting, search, streaming, DMs, analytics

When to Use

  • Posting tweets programmatically
  • Automating X content and engagement
  • Searching and monitoring tweets/hashtags
  • Real-time tweet streaming (Pro+)
  • Direct message automation (Pro+)
  • Social media analytics and metrics (Pro+)
  • Brand monitoring and sentiment analysis

Installation

cd .github/skills/ailey-soc-twitter
npm install

Quick Start

npm run twitter setup       # Show setup guide
cp .env.example .env        # Configure credentials
npm run twitter test        # Test connection
npm run twitter detect      # Detect tier
npm run tweet "Hello X!"    # Post tweet

API Tier Overview

TierCost/MonthRead LimitWrite LimitKey Features
Free$01,500/month50/monthTesting only
Basic$10010,000/month3,000/monthMedia, limited search
Pro$5,000 ⚠️1M/month100K/monthFull search, streaming, DMs
Enterprise~$42K+UnlimitedUnlimitedFirehose, historical data

⚠️ Cost Warning: Pro tier costs $5,000/month = $60,000/year!

Workflows

Workflow 1: Tier Detection

npm run twitter detect

Shows current tier, rate limits, available features, and upgrade options with cost warnings.

Workflow 2: Post Tweets

# Simple tweet
npm run tweet "Posted via X API!"

# Reply to tweet
npm run tweet "Thanks!" -- --reply 1234567890

# Quote tweet
npm run tweet "Great point!" -- --quote 1234567890

Workflow 3: Search (Basic+ Required)

npm run search "artificial intelligence"
npm run search "AI" -- --number 10

Workflow 4: User Timeline

npm run timeline              # Your timeline
npm run timeline username     # Another user's timeline

Resources


version: 1.0.0 updated: 2026-02-01 reviewed: 2026-02-01 score: 4.6

When not to use it

  • When only testing without API interaction
  • When not needing programmatic access to X features

Limitations

  • Features are gated by API tier access level
  • Pro tier has a significant monthly cost
  • Rate limits are enforced based on the API tier

How it compares

This skill provides a complete, tier-aware interface for X, automatically adjusting features and warning about costs, unlike direct API calls without such management.

Compared to similar skills

X (Twitter) Integration Manager side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
X (Twitter) Integration Manager (this skill)06moReviewIntermediate
tiktok-automation03moNo flagsIntermediate
instagram02moReviewIntermediate
x-api03moCautionIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry