xgo-manage-lists

What problem does it solve?

Managing Twitter/X lists through the web UI or multiple API calls is time-consuming and error-prone; this Skill centralizes list management operations so users can quickly view, create, update, and maintain membership at scale.

Core Features & Use Cases

• List Discovery & Overview: Retrieve all lists owned by the API key user and present concise summaries including ID, description, member count, and privacy.
• Create & Edit Lists: Create new lists or update existing ones (name, description, privacy) and receive the new or updated list ID.
• Member Management: Add or remove members using user IDs, with guidance for resolving usernames to IDs and enforcement of membership limits per plan.
• Operational Safety: Validates X-API-KEY presence, checks response.success rather than relying solely on HTTP status, and surfaces common xgo error codes (rate limits, quota limits, ownership errors).
• Use Case: A social media manager organizes KOLs into thematic lists, bulk-adds members, and audits list sizes against PLUS/PRO limits.

Quick Start

Add @elonmusk (user id 44196397) to my "AI Researchers" list by calling the XGo list/addMember endpoint with XGO_API_KEY set in the environment.