1---
2name: baoyu-post-to-x
3description: Posts content and articles to X (Twitter). Supports regular posts with images/videos and X Articles (long-form Markdown). Uses real Chrome with CDP to bypass anti-automation. Use when user asks to "post to X", "tweet", "publish to Twitter", or "share on X".
4version: 1.56.2
5metadata:
6  openclaw:
7    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-post-to-x
8    requires:
9      anyBins:
10        - bun
11        - npx
12---
13 
14# Post to X (Twitter)
15 
16Posts text, images, videos, and long-form articles to X via real Chrome browser (bypasses anti-bot detection).
17 
18## Script Directory
19 
20**Important**: All scripts are located in the `scripts/` subdirectory of this skill.
21 
22**Agent Execution Instructions**:
231. Determine this SKILL.md file's directory path as `{baseDir}`
242. Script path = `{baseDir}/scripts/<script-name>.ts`
253. Replace all `{baseDir}` in this document with the actual path
264. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun
27 
28**Script Reference**:
29| Script | Purpose |
30|--------|---------|
31| `scripts/x-browser.ts` | Regular posts (text + images) |
32| `scripts/x-video.ts` | Video posts (text + video) |
33| `scripts/x-quote.ts` | Quote tweet with comment |
34| `scripts/x-article.ts` | Long-form article publishing (Markdown) |
35| `scripts/md-to-html.ts` | Markdown → HTML conversion |
36| `scripts/copy-to-clipboard.ts` | Copy content to clipboard |
37| `scripts/paste-from-clipboard.ts` | Send real paste keystroke |
38| `scripts/check-paste-permissions.ts` | Verify environment & permissions |
39 
40## Preferences (EXTEND.md)
41 
42Check EXTEND.md in priority order — the first one found wins:
43 
44| Priority | Path | Scope |
45|----------|------|-------|
46| 1 | `.baoyu-skills/baoyu-post-to-x/EXTEND.md` | Project |
47| 2 | `${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-x/EXTEND.md` | XDG |
48| 3 | `$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md` | User home |
49 
50If none found, use defaults.
51 
52**EXTEND.md supports**: Default Chrome profile
53 
54## Prerequisites
55 
56- Google Chrome or Chromium
57- `bun` runtime
58- First run: log in to X manually (session saved)
59 
60## Pre-flight Check (Optional)
61 
62Before first use, suggest running the environment check. User can skip if they prefer.
63 
64```bash
65${BUN_X} {baseDir}/scripts/check-paste-permissions.ts
66```
67 
68Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystroke, Chrome conflicts.
69 
70**If any check fails**, provide fix guidance per item:
71 
72| Check | Fix |
73|-------|-----|
74| Chrome | Install Chrome or set `X_BROWSER_CHROME_PATH` env var |
75| Profile dir | Shared profile at `baoyu-skills/chrome-profile` (see CLAUDE.md Chrome Profile section) |
76| Bun runtime | `brew install oven-sh/bun/bun` (macOS) or `npm install -g bun` |
77| Accessibility (macOS) | System Settings → Privacy & Security → Accessibility → enable terminal app |
78| Clipboard copy | Ensure Swift/AppKit available (macOS Xcode CLI tools: `xcode-select --install`) |
79| Paste keystroke (macOS) | Same as Accessibility fix above |
80| Paste keystroke (Linux) | Install `xdotool` (X11) or `ydotool` (Wayland) |
81 
82## References
83 
84- **Regular Posts**: See `references/regular-posts.md` for manual workflow, troubleshooting, and technical details
85- **X Articles**: See `references/articles.md` for long-form article publishing guide
86 
87---
88 
89## Post Type Selection
90 
91Unless the user explicitly specifies the post type:
92- **Plain text** + within 10,000 characters → **Regular Post** (Premium members support up to 10,000 characters, non-Premium: 280)
93- **Markdown file** (.md) → **X Article**
94 
95## Regular Posts
96 
97```bash
98${BUN_X} {baseDir}/scripts/x-browser.ts "Hello!" --image ./photo.png
99```
100 
101**Parameters**:
102| Parameter | Description |
103|-----------|-------------|
104| `<text>` | Post content (positional) |
105| `--image <path>` | Image file (repeatable, max 4) |
106| `--profile <dir>` | Custom Chrome profile |
107 
108**Note**: Script opens browser with content filled in. User reviews and publishes manually.
109 
110---
111 
112## Video Posts
113 
114Text + video file.
115 
116```bash
117${BUN_X} {baseDir}/scripts/x-video.ts "Check this out!" --video ./clip.mp4
118```
119 
120**Parameters**:
121| Parameter | Description |
122|-----------|-------------|
123| `<text>` | Post content (positional) |
124| `--video <path>` | Video file (MP4, MOV, WebM) |
125| `--profile <dir>` | Custom Chrome profile |
126 
127**Note**: Script opens browser with content filled in. User reviews and publishes manually.
128 
129**Limits**: Regular 140s max, Premium 60min. Processing: 30-60s.
130 
131---
132 
133## Quote Tweets
134 
135Quote an existing tweet with comment.
136 
137```bash
138${BUN_X} {baseDir}/scripts/x-quote.ts https://x.com/user/status/123 "Great insight!"
139```
140 
141**Parameters**:
142| Parameter | Description |
143|-----------|-------------|
144| `<tweet-url>` | URL to quote (positional) |
145| `<comment>` | Comment text (positional, optional) |
146| `--profile <dir>` | Custom Chrome profile |
147 
148**Note**: Script opens browser with content filled in. User reviews and publishes manually.
149 
150---
151 
152## X Articles
153 
154Long-form Markdown articles (requires X Premium).
155 
156```bash
157${BUN_X} {baseDir}/scripts/x-article.ts article.md
158${BUN_X} {baseDir}/scripts/x-article.ts article.md --cover ./cover.jpg
159```
160 
161**Parameters**:
162| Parameter | Description |
163|-----------|-------------|
164| `<markdown>` | Markdown file (positional) |
165| `--cover <path>` | Cover image |
166| `--title <text>` | Override title |
167 
168**Frontmatter**: `title`, `cover_image` supported in YAML front matter.
169 
170**Note**: Script opens browser with article filled in. User reviews and publishes manually.
171 
172**Post-Composition Check**: The script automatically verifies after all images are inserted:
173- Remaining `XIMGPH_` placeholders in editor content
174- Expected vs actual image count
175 
176If the check fails (warnings in output), alert the user with the specific issues before they publish.
177 
178---
179 
180## Troubleshooting
181 
182### Chrome debug port not ready
183 
184If a script fails with `Chrome debug port not ready` or `Unable to connect`, kill existing Chrome CDP instances first, then retry:
185 
186```bash
187pkill -f "Chrome.*remote-debugging-port" 2>/dev/null; pkill -f "Chromium.*remote-debugging-port" 2>/dev/null; sleep 2
188```
189 
190**Important**: This should be done automatically — when encountering this error, kill Chrome CDP instances and retry the command without asking the user.
191 
192## Notes
193 
194- First run: manual login required (session persists)
195- All scripts only fill content into the browser, user must review and publish manually
196- Cross-platform: macOS, Linux, Windows
197 
198## Extension Support
199 
200Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.
201