x-api

Publish tweets and threads to the X API with credential and content validation.

415|44|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/notque/vexjoy-agent --skill x-api-notque
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-api
Source: https://github.com/notque/vexjoy-agent/tree/main/skills/content/x-api
Command: npx skills add https://github.com/notque/vexjoy-agent --skill x-api-notque

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents accidental or failed public posting to X by adding credential validation, content length checks, and a mandatory explicit confirmation gate before any write operation.

Core Features & Use Cases

  • OAuth-authenticated posting orchestration: Runs deterministic X API interactions via a backing script while selecting read vs write auth modes automatically.
  • Thread-safe publishing: Supports single tweets and multi-tweet threads with dry-run validation and character-limit enforcement.
  • Rate-limit and error visibility: Surfaces rate-limit warnings immediately and stops on any error output for reliable outcomes.
  • Media upload with guardrails: Enforces media size/format constraints and performs uploads safely in a two-step process without leaving orphaned media.

Quick Start

Ask the agent to post a tweet to X after you review the content preview and type a clear yes/approve response in the approval turn.

Frequently Asked Questions about x-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely post a tweet to X without risking failed API calls?

To safely post a tweet to X, this Skill validates OAuth credentials and enforces 280-character limits via a dry-run gate before executing any write operation. It blocks public publishing until you provide explicit approval during the confirmation turn.

How does thread posting work with the X API?

Thread posting with the X API is handled by chaining multiple tweets together after validating content length and credentials. The process performs dry-run validation for each tweet in the thread and stops immediately on any error output or rate-limit warning.

Do I need OAuth tokens configured to use this X API posting tool?

Yes, you need OAuth tokens configured in your environment variables to use this X API posting tool. The Skill automatically selects read versus write authentication modes based on the required operation and validates these credentials before attempting any media upload or tweet posting.

What is the best way to handle media uploads and tweet posting together?

The best way to handle media uploads and tweet posting is using a two-step process with enforced size and format constraints. This approach safely uploads media first, preventing orphaned files, and then publishes the tweet after passing the explicit confirmation gate.

Why does my tweet posting stop before publishing to the timeline?

Your tweet posting stops before publishing to the timeline because the Skill enforces a mandatory confirmation gate that blocks write operations without explicit approval. It also halts immediately if dry-run validation detects character limit exceedances or rate-limit warnings.

Can I check rate limits and content validation before an X API write operation?

Yes, you can check rate limits and content validation before an X API write operation through the built-in dry-run gate. The Skill surfaces rate-limit warnings immediately and enforces 280-character limits, stopping the process on any error output before public publishing occurs.