# Timeline

> Read home timeline, mentions, and user posts on X through Shift's Skill Router.

- Skill: `tryshift-sh/timeline` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tryshift-sh/timeline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tryshift-sh/timeline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tryshift-sh (https://skillmd.com/u/tryshift-sh)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tryshift-sh/timeline

---


# X Timeline

Use this managed skill for reading X timelines and mentions through Shift.

## When to use
- The user wants to read their home timeline
- The user wants to read a user's tweets
- The user wants to read mentions

## How to invoke
Send a `POST` request to `${SHIFT_LOCAL_GATEWAY}/skill-router/invoke`.

Home timeline:

```json
{
  "skillProvider": "x",
  "skill": "timeline",
  "action": "home",
  "input": {
    "userId": "123"
  }
}
```

User tweets:

```json
{
  "skillProvider": "x",
  "skill": "timeline",
  "action": "user-tweets",
  "input": {
    "userId": "123"
  }
}
```

Mentions:

```json
{
  "skillProvider": "x",
  "skill": "timeline",
  "action": "mentions",
  "input": {
    "userId": "123"
  }
}
```

## Notes
- This skill requires X to be connected in Shift.
- Do not ask the user to paste raw credentials into chat.