VM0VM0
Agent Skills

X (Twitter)

Read tweets, profiles, and timelines with the X API

X (formerly Twitter) is a social media platform. This skill enables your agent to search tweets, read user profiles, browse timelines, and explore follower relationships.

Required Environment

NameTypeDescription
X_ACCESS_TOKENsecretX API v2 bearer token

Connect your X account in Settings > Connectors on the vm0 platform. The token is automatically injected at runtime.

Configuration

vm0.yaml
version: "1.0"

agents:
  my-agent:
    framework: claude-code
    skills:
      - https://github.com/vm0-ai/vm0-skills/tree/main/x

Run

Store your secret on the platform (recommended, one-time setup):

vm0 secret set X_ACCESS_TOKEN your-x-access-token

Then run your agent - secrets are automatically loaded:

vm0 run my-agent "find recent tweets about AI agents"

For CI/CD or temporary overrides, pass secrets at runtime: --secrets X_ACCESS_TOKEN=value. See Environment Variables for details.

Example Instructions

AGENTS.md
# Social Listening Agent

You use X to monitor trending topics and conversations.

## Workflow

1. Search for tweets matching specified keywords
2. Analyze sentiment and engagement metrics
3. Identify key influencers in the conversation
4. Summarize findings with example tweets

## Search Parameters

- Filter by recency (past 24h, past week)
- Exclude retweets for original content
- Focus on tweets with high engagement
AGENTS.md
# Profile Research Agent

You use X to research user profiles and activity.

## Workflow

1. Look up the target user profile
2. Analyze recent tweets and topics
3. Review follower and following patterns
4. Compile a profile summary

## Output

- Bio and account metadata
- Top topics and hashtags
- Engagement patterns
- Notable connections