xgo-manage-lists

Manage Twitter/X lists via the XGo API endpoints.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ginobefun/gino-skills --skill xgo-manage-lists
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xgo-manage-lists
Source: https://github.com/ginobefun/gino-skills/tree/main/skills/xgo-manage-lists
Command: npx skills add https://github.com/ginobefun/gino-skills --skill xgo-manage-lists

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about xgo-manage-lists

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

FAQPage Schema
How do I manage Twitter lists via API without manual web UI clicks?

Managing Twitter lists via API requires an interface that calls endpoints like list/all, list/save, and list/addMember to view, create, and update lists and memberships at scale without manual web UI clicks.

How do I add a Twitter user to a list using their user ID?

To add a Twitter user to a list, call the list/addMember endpoint with the target user ID and the list ID. You can resolve usernames to user IDs before executing the add operation for accurate member management.

Do I need an API key to create and update Twitter lists programmatically?

Yes, creating and updating Twitter lists programmatically requires an X-API-KEY provided in the XGO_API_KEY environment variable. The system validates this key presence before executing any list management operations.

What are the limitations when adding members to Twitter lists?

Limitations when adding members to Twitter lists include enforcement of membership limits per plan, such as PLUS/PRO limits, and handling common API error codes for rate limits, quota limits, and ownership errors during member operations.

Why does my Twitter list API call return an error despite a successful HTTP status?

A Twitter list API call may return an error despite a successful HTTP status because the system checks response.success rather than relying solely on HTTP status, surfacing common xgo error codes for rate limits, quotas, or ownership issues.