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.