Skill: twitter-agent

Skill: twitter-agent

Build and run one or more Twitter/X agents, each with a distinct personality, storyline, and post-image library.

Twitter Agent Skill

This skill provides a framework for creating, managing, and automating Twitter/X agents with persistent personalities and voices. It supports running multiple agents side-by-side, each with its own files and (optionally) its own X account.

Prerequisites

X Account Setup (REQUIRED — Do This First, Per Agent)

Every agent's X account MUST be marked as an automated account before it posts a single tweet. X requires this disclosure; skipping it is the fastest way to get suspended.

Exact path:

1. Log in as the agent account on x.com.
2. Go to Settings and privacy → Your account → Account information.
3. Scroll to Automation and tap it.
4. Enter the password when prompted.
5. Set Managing account to the human/handle responsible for the bot and save.

Direct link (while logged in as the agent account): https://x.com/settings/account/automation

This adds the "Automated by @…" label to the profile and replies. Non-negotiable — do this once per agent account.

Environment Variables (Default + Per-Agent Override)

This skill supports a single default credential set (for the primary / only agent) AND per-agent overrides (when running multiple agents with distinct X accounts).

Default credentials (used by the primary agent or any agent that does not have overrides):

• X_API_KEY
• X_API_KEY_SECRET
• X_ACCESS_TOKEN
• X_ACCESS_TOKEN_SECRET

Per-agent overrides (optional; only required when a second+ agent uses a different X account):

• X_API_KEY_{SLUG_UPPER}
• X_API_KEY_SECRET_{SLUG_UPPER}
• X_ACCESS_TOKEN_{SLUG_UPPER}
• X_ACCESS_TOKEN_SECRET_{SLUG_UPPER}