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
| Name | Type | Description |
|---|---|---|
X_ACCESS_TOKEN | secret | X API v2 bearer token |
Connect your X account in Settings > Connectors on the vm0 platform. The token is automatically injected at runtime.
Configuration
version: "1.0"
agents:
my-agent:
framework: claude-code
skills:
- https://github.com/vm0-ai/vm0-skills/tree/main/xRun
Store your secret on the platform (recommended, one-time setup):
vm0 secret set X_ACCESS_TOKEN your-x-access-tokenThen 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
# 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# 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