Agent-Skills.md

Agent Skills: X User Timeline

Get recent tweets from an X/Twitter user. Use when user asks "what has @username posted", "recent tweets from", "user's X posts", "show timeline for", "what is @user saying". Requires X_BEARER_TOKEN.

UncategorizedID: b-open-io/prompts/x-user-timeline

Repository

b-open-io/prompts
b-open-io
114

Install this agent skill to your local

pnpm dlx add-skill https://github.com/b-open-io/prompts/tree/HEAD/modules/research/skills/x-user-timeline

Skill Files

Browse the full folder contents for x-user-timeline.

Download Skill

Loading file tree…

modules/research/skills/x-user-timeline/SKILL.md

Skill Metadata

Name
x-user-timeline
Description
Get recent tweets from an X/Twitter user. Use when user asks "what has @username posted", "recent tweets from", "user's X posts", "show timeline for", "what is @user saying". Requires X_BEARER_TOKEN.

X User Timeline

Get recent tweets from a specific user.

Setup

export X_BEARER_TOKEN="your-token"  # https://developer.x.com/en/portal/dashboard

Usage

${CLAUDE_SKILL_DIR}/scripts/timeline.sh <username> [max_results]

Examples

# Get 10 recent tweets (default)
${CLAUDE_SKILL_DIR}/scripts/timeline.sh kurtwuckertjr

# Get 25 tweets
${CLAUDE_SKILL_DIR}/scripts/timeline.sh kurtwuckertjr 25

Response Fields

  • text - Tweet content
  • created_at - Post timestamp
  • public_metrics - Likes, retweets, replies, views
  • author - User info (expanded)

Pricing and Rate Limits

X API access is pay-per-use. Read the endpoint's rate-limit response headers and consult the current X API pricing and rate-limit documentation instead of assuming a fixed free-tier quota.

References

  • https://docs.x.com/llms.txt
  • https://developer.x.com/en/docs/x-api/tweets/timelines