x-schedule-post

Files (1)

• SKILL.md

SKILL.md (first lines)

# X (Twitter) Schedule Post

Schedule a post on X via ai-chrome-pilot and verify it appears in the scheduled posts list.

Treat this as the schedule-focused variant of `x-compose-post`. If the user wants a normal post, reply, or quote post, use `x-compose-post` instead.

## Prerequisites

- ai-chrome-pilot server is running
- User is logged in to X (if not, run the `x-login` skill first)
- Prefer `HEADLESS=0` for real scheduling flows so the visible composer state can be inspected

## Required inputs

- **Post text**: The text to post
- **Scheduled date/time**: Year, month, day, hour, and minute
- **Image** (optional): An image to attach

Default resolution rules:

- Use `default` unless the user explicitly requested another profile
- If post text and the full scheduled date/time are already provided, execute directly without an extra confirmation step
- Ask follow-up questions only when required inputs are missing

## Steps

### 1. Verify server is running

```bash
curl -s http://127.0.0.1:3333/health
```

If not running, start it with the resolved profile:

```bash
HEADLESS=0 PROFILE_NAME=<profile_name> npx tsx src/index.ts &
sleep 3 && curl -s http://127.0.0.1:3333/health
```

### 2. Navigate to X home

```bash
curl -s -X POST http://127.0.0.1:3333/goto \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://x.com"}'
```

After `sleep 2`, take a screenshot to confirm the user is logged in.

### 3. Enter post text safely

Use `/snapshot` to find the post text box ref.

```bash
curl -s http://127.0.0.1:3333/snapshot
```

Look for `textbox "ポスト本文"` (Post text), click it, then treat `/act type` only as an initial convenience path.

```bash
curl -s -X POST http://127.0.0.1:3333/act \
  -H 'Content-Type: application/json' \
  -d '{"ref":"<textbox_ref>","action":"click"}'
```

For scheduling that will actually be submitted, prefer the same text-entry strategy as `x-compose-post`:

- connect to the existing Chrome instance with `Playwright over CDP`
- enter text with `page.keyboard.type()`
- verify `[data-testid="tweetTextarea_0"]` exactly matches the intended text before opening the schedule dialog

Do not rely on the visible composer alone. X can show an enabled action state while the actual composer DOM is still out of sync.

### 4. Open the schedule dialog

Click `button "ポストを予約"` (Schedule post).

```bash
curl -s -X POST http://127.0.0.1:3333/act \
  -H 'Content-Type: application/json' \
  -d '{"ref":"<schedule_button_ref>","action":"click"}'
```

After `sleep 1`, use `/snapshot` to inspect the schedule dialog elements.

### 5. Set the date and time

Use the `/act` `select` action on each combobox in the dialog. Add `sleep 1` between each operation.

```bash
# Month (e.g. "2月" for February)
curl -s -X POST http://127.0.0.1:3333/act \
  -H 'Content-Type: application/json' \
  -d '{"ref":"<month_combobox_ref>","action":"select","values":["<N>月"]}'

# Day (e.g. "28")
curl -s -X POST http://127.0.0.1:3333/act \
  -H 'Content-Type: application/json' \
  -d '{"ref":"<day_combobox_ref>","action":"select","values":["<DD>"]}'

# Year (e.g. "2026")
curl -s -X POST http://127.0.0.1:3333/act \
  -H 'Content-Type: application/json' \
  -d '{"ref":"<year_combobox_ref>","action":"select","values":["<YYYY>"]}'

# Hour in 24-hour format (e.g. "20")
curl -s -X POST http://127.0.0.1:3333/act \
  -H 'Content-Type: application/json' \
  -d '{"ref":"<hour_combobox_ref>","action":"select","values":["<HH>"]}'

# Minute (e.g. "00")
curl -s -X POST http://127.0.0.1:3333/act \
  -H 'Content-Type: application/json' \
  -d '{"ref":"<minute_combobox_ref>","action":"select","values":["<MM>"]}'
```

### 6. Confirm the date/time change

After setting the date and time, click the confirmation button at the top right of the dialog.

From shinshin86/ai-chrome-pilot, MIT.

More from shinshin86/ai-chrome-pilot