Source profileQuality 64/100Review permissions

sonichi/sutando/skills/x-twitter/SKILL.md

x-twitter

Post tweets, search, read mentions, and check engagement on X (Twitter) via API v2.

Source repository stars
359
Declared platforms
0
Static risk flags
1
Last source update
2026-07-28
Source checked
2026-07-28

Decision brief

What it does—and where it fits

Post, search, read, and monitor X from the command line.

Best for

    Not for

    • Tasks that require unconfirmed production actions or broad system permissions.
    • Environments where the pinned source and install steps cannot be inspected.

    Compatibility matrix

    Platform support, with evidence labels

    PlatformStatusEvidenceWhat to check
    CodexNot declaredNo explicit evidencePortability before use
    Claude CodeNot declaredNo explicit evidencePortability before use
    CursorNot declaredNo explicit evidencePortability before use
    Gemini CLINot declaredNo explicit evidencePortability before use
    Open the compatibility checker

    Installation

    Inspect first. Install second.

    The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

    Source-detected install commandSource
    npx skills add https://github.com/sonichi/sutando --skill "skills/x-twitter"
    Safe inspection promptEditorial

    Inspect the Agent Skill "x-twitter" from https://github.com/sonichi/sutando/blob/6a8f0fccd32e5aa620a3572c8885544f144bb6fe/skills/x-twitter/SKILL.md at commit 6a8f0fccd32e5aa620a3572c8885544f144bb6fe. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

    Workflow

    What the source asks the agent to do

    1. 01

      Usage

      Review the “Usage” section in the pinned source before continuing.

      Review and apply the “Usage” source section.
    2. 02

      Setup

      1. Install Python dependencies (one-time):

      Install Python dependencies (one-time):Go to https://developer.x.com and sign inCreate a Project + App
    3. 03

      Post

      python3 skills/x-twitter/x-post.py post "Your tweet text" python3 skills/x-twitter/x-post.py post "With video" --media /path/to/video.mp4 python3 skills/x-twitter/x-post.py post --reply-to 123456789 "Reply text"

      python3 skills/x-twitter/x-post.py post "Your tweet text" python3 skills/x-twitter/x-post.py post "With video" --media /path/to/video.mp4 python3 skills/x-twitter/x-post.py post --reply-to 123456789 "Reply text"
    4. 04

      Search

      python3 skills/x-twitter/x-post.py search "sutando agent" python3 skills/x-twitter/x-post.py search "from:ChiWang" --limit 5

      python3 skills/x-twitter/x-post.py search "sutando agent" python3 skills/x-twitter/x-post.py search "from:ChiWang" --limit 5

    Permission review

    Static risk signals and limitations

    Runs scripts

    medium · line 9

    The documentation asks the agent to run terminal commands or scripts.

    python3 skills/x-twitter/x-post.py post "Your tweet text"

    Runs scripts

    medium · line 10

    The documentation asks the agent to run terminal commands or scripts.

    python3 skills/x-twitter/x-post.py post "With video" --media /path/to/video.mp4

    Evidence record

    Why each signal appears

    EvidenceSourceComputedTestedEditorial
    SignalValueEvidence typeMeaning
    Quality score64/100ComputedDocumentation, specificity, maintenance, and trust rules
    Repository stars359SourceRepository attention, not individual Skill quality
    Compatibility0 platformsSourceDeclared in the catalog source record
    Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

    Pinned source

    Provenance and original SKILL.md

    Repository
    sonichi/sutando
    Skill path
    skills/x-twitter/SKILL.md
    Commit
    6a8f0fccd32e5aa620a3572c8885544f144bb6fe
    License
    MIT
    Collected
    2026-07-28
    Default branch
    main
    View the original SKILL.md

    X (Twitter)

    Post, search, read, and monitor X from the command line.

    Usage

    # Post
    python3 skills/x-twitter/x-post.py post "Your tweet text"
    python3 skills/x-twitter/x-post.py post "With video" --media /path/to/video.mp4
    python3 skills/x-twitter/x-post.py post --reply-to 123456789 "Reply text"
    
    # Search
    python3 skills/x-twitter/x-post.py search "sutando agent"
    python3 skills/x-twitter/x-post.py search "from:Chi_Wang_" --limit 5
    
    # Read a tweet
    python3 skills/x-twitter/x-post.py read 2040817066199195818
    
    # Mentions & timeline
    python3 skills/x-twitter/x-post.py mentions
    python3 skills/x-twitter/x-post.py timeline
    
    # Engagement (likes, retweets, views)
    python3 skills/x-twitter/x-post.py engagement 2040817066199195818
    

    Setup

    1. Install Python dependencies (one-time):
      pip3 install requests requests-oauthlib
      
    2. Go to https://developer.x.com and sign in
    3. Create a Project + App
    4. Generate keys and add to .env:
      X_API_KEY=...
      X_API_SECRET=...
      X_ACCESS_TOKEN=...
      X_ACCESS_TOKEN_SECRET=...
      

    Notes

    • Free tier: 500 posts/month, search recent tweets (7 days)
    • Video upload uses chunked upload (supports 4K)
    • Always confirm post content with user before publishing

    Alternatives

    Compare before choosing