lists-management
Creates, populates, and exports X/Twitter lists from the browser console. Supports creating public or private lists, bulk-adding members by username, and exporting list members as JSON. Use when users want to create lists, add members to lists, or export list data on X.
Best use case
lists-management is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Creates, populates, and exports X/Twitter lists from the browser console. Supports creating public or private lists, bulk-adding members by username, and exporting list members as JSON. Use when users want to create lists, add members to lists, or export list data on X.
Teams using lists-management should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/lists-management/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How lists-management Compares
| Feature / Agent | lists-management | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Creates, populates, and exports X/Twitter lists from the browser console. Supports creating public or private lists, bulk-adding members by username, and exporting list members as JSON. Use when users want to create lists, add members to lists, or export list data on X.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Lists Management
Browser console script for creating and managing X/Twitter lists.
## Script Selection
| Goal | File | Navigate to |
|------|------|-------------|
| Create a new list | `src/listManager.js` | `x.com/USERNAME/lists` |
| Add users to a list | `src/listManager.js` | List page |
| Export list members | `src/listManager.js` | List members page |
## List Manager
**File:** `src/listManager.js`
Browser console script that creates lists, adds members by username, and exports member data.
### How to Use
1. Navigate to `x.com/YOUR_USERNAME/lists` (or an existing list page)
2. Open DevTools (F12) → Console
3. Edit the CONFIG section to enable desired operations
4. Paste the script → Enter
### Configuration
```javascript
const CONFIG = {
createList: {
enabled: false,
name: 'My List',
description: 'Created by XActions',
isPrivate: true,
},
addUsers: {
enabled: true,
usernames: ['user1', 'user2'],
},
exportMembers: {
enabled: false,
maxMembers: 200,
},
actionDelay: 2000,
};
```
### Create List
Sets `createList.enabled: true` to create a new list. Fills in the name, description, and privacy toggle, then saves.
### Add Members
Sets `addUsers.enabled: true` with a list of usernames. Opens the add-member search, types each username, clicks the matching user cell, and repeats. Navigate to the target list page first.
### Export Members
Sets `exportMembers.enabled: true`. Scrolls through the list members page and exports all members (username, display name, bio) as a JSON download.
## DOM Selectors
| Element | Selector |
|---------|----------|
| Create list button | `[data-testid="createList"]` |
| List name input | `[data-testid="listNameInput"]` |
| List description | `[data-testid="listDescriptionInput"]` |
| Private toggle | `[data-testid="listPrivateToggle"]` |
| Save button | `[data-testid="listSaveButton"]` |
| Add members | `[data-testid="addMembers"]` |
| Search people | `[data-testid="searchPeople"]` |
| User cell | `[data-testid="UserCell"]` |
## Rate Limiting
- 2s delay between adding individual users
- 1.5s scroll delay when exporting members
- Up to 5 retries when no new members load during export scroll
## X List Limits
- Maximum 1,000 lists per account
- Maximum 5,000 members per list
- Lists can be public (visible to anyone) or private (only you)
## Troubleshooting
| Problem | Solution |
|---------|----------|
| Create button not found | Navigate to `x.com/USERNAME/lists` first |
| User not found when adding | Verify username spelling; user may have changed handle |
| Export stops early | Page may have finished scrolling; increase `maxMembers` if needed |
| Search input not found | Ensure you clicked "Add member" — script expects the search overlay |Related Skills
x-pro-management
Navigate to X Pro (TweetDeck), set up monitoring columns, and manage multi-column view. Use when users want to use X Pro / TweetDeck features or set up a multi-column dashboard.
topic-management
Browse, follow, and unfollow X Topics. Manage your followed topics list and discover new ones by keyword. Use when users want to follow or unfollow topics on X, or manage their topic feed.
teams-management
Create and manage teams in XActions — invite members, assign roles, and collaborate on automation tasks. Use when users want to set up multi-user access or team-based account management.
profile-management
Updates X/Twitter profile information including bio, avatar, header image, display name, location, website, and QR code sharing. Use when updating profile fields, optimizing profile for growth, or sharing profile via QR code.
notifications-management
Manages X/Twitter notifications including filtering by type, bulk management, notification scraping, and automated notification handling. Use when users want to manage, filter, scrape, or process X notifications in bulk.
crm-management
Manage a CRM (Contact Relationship Management) system for your X followers and contacts. Tag, segment, search, and sync follower data. Use when users want to manage relationships with their X audience at scale.
community-management
Manages X/Twitter community memberships. Bulk-leave all communities, join communities by topic, and manage community interactions. Use when leaving all communities, joining niche communities, or managing community presence.
bookmarks-management
Manages X/Twitter bookmarks — organize by category with auto-tagging, clear all bookmarks in bulk, and export/scrape bookmarks with full metadata. Supports keyword-based categorization, CSV and JSON export, keep-filters, and folder creation (Premium). Use when users want to export, organize, or clear their X bookmarks.
blocking-muting-management
Mass block, unblock, mute, unmute, and manage accounts on X/Twitter. Includes bot detection and blocking, keyword-based muting, muted word management, spam reporting, and follower removal via soft-block. Use when users want to block bots, mass block/unblock accounts, mute by keywords, manage muted words, or remove followers.
billing-management
Manage XActions subscriptions and billing — view plans, start a Stripe checkout, open the billing portal, or cancel a subscription. Use when users want to upgrade, downgrade, or manage their XActions subscription.
xactions-mcp-server
Free MCP server providing 68+ tools for AI agents to automate X/Twitter. Scrapes profiles, followers, tweets. Posts, follows, likes, retweets, downloads videos, analyzes sentiment, monitors brands, manages DMs, runs workflows, and more. Uses local Puppeteer -- no API keys or payments required. Compatible with Claude Desktop, Cursor, Windsurf, VS Code. Use when setting up or using AI agent Twitter automation via MCP.
xactions-cli
Command-line interface for scraping X/Twitter data, managing MCP server config, and running automation. Scrapes profiles, followers, tweets, search results, and more from terminal. Outputs text, JSON, or CSV. Uses Puppeteer stealth. Use when running Twitter operations from command line or automated pipelines.