Post to X (Twitter)
Posts text, images, videos, and long-form articles to X via real Chrome browser (bypasses anti-bot detection).
Script Directory
Important: All scripts are located in the
subdirectory of this skill.
Agent Execution Instructions:
- Determine this SKILL.md file's directory path as
- Script path =
${SKILL_DIR}/scripts/<script-name>.ts
- Replace all in this document with the actual path
Script Reference:
| Script | Purpose |
|---|
| Regular posts (text + images) |
| Video posts (text + video) |
| Quote tweet with comment |
| Long-form article publishing (Markdown) |
| Markdown → HTML conversion |
scripts/copy-to-clipboard.ts
| Copy content to clipboard |
scripts/paste-from-clipboard.ts
| Send real paste keystroke |
Preferences (EXTEND.md)
Use Bash to check EXTEND.md existence (priority order):
bash
# Check project-level first
test -f .baoyu-skills/baoyu-post-to-x/EXTEND.md && echo "project"
# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md" && echo "user"
┌──────────────────────────────────────────────────┬───────────────────┐
│ Path │ Location │
├──────────────────────────────────────────────────┼───────────────────┤
│ .baoyu-skills/baoyu-post-to-x/EXTEND.md │ Project directory │
├──────────────────────────────────────────────────┼───────────────────┤
│ $HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md │ User home │
└──────────────────────────────────────────────────┴───────────────────┘
┌───────────┬───────────────────────────────────────────────────────────────────────────┐
│ Result │ Action │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ Found │ Read, parse, apply settings │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ Not found │ Use defaults │
└───────────┴───────────────────────────────────────────────────────────────────────────┘
EXTEND.md Supports: Default Chrome profile | Auto-submit preference
Prerequisites
- Google Chrome or Chromium
- runtime
- First run: log in to X manually (session saved)
References
- Regular Posts: See
references/regular-posts.md
- X Articles: See for long-form article publishing guide
Regular Posts
Text + up to 4 images.
bash
npx -y bun ${SKILL_DIR}/scripts/x-browser.ts "Hello!" --image ./photo.png # Preview
npx -y bun ${SKILL_DIR}/scripts/x-browser.ts "Hello!" --image ./photo.png --submit # Post
Parameters:
| Parameter | Description |
|---|
| Post content (positional) |
| Image file (repeatable, max 4) |
| Post (default: preview) |
| Custom Chrome profile |
Video Posts
Text + video file.
bash
npx -y bun ${SKILL_DIR}/scripts/x-video.ts "Check this out!" --video ./clip.mp4 # Preview
npx -y bun ${SKILL_DIR}/scripts/x-video.ts "Amazing content" --video ./demo.mp4 --submit # Post
Parameters:
| Parameter | Description |
|---|
| Post content (positional) |
| Video file (MP4, MOV, WebM) |
| Post (default: preview) |
| Custom Chrome profile |
Limits: Regular 140s max, Premium 60min. Processing: 30-60s.
Quote Tweets
Quote an existing tweet with comment.
bash
npx -y bun ${SKILL_DIR}/scripts/x-quote.ts https://x.com/user/status/123 "Great insight!" # Preview
npx -y bun ${SKILL_DIR}/scripts/x-quote.ts https://x.com/user/status/123 "I agree!" --submit # Post
Parameters:
| Parameter | Description |
|---|
| URL to quote (positional) |
| Comment text (positional, optional) |
| Post (default: preview) |
| Custom Chrome profile |
X Articles
Long-form Markdown articles (requires X Premium).
bash
npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md # Preview
npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md --cover ./cover.jpg # With cover
npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md --submit # Publish
Parameters:
| Parameter | Description |
|---|
| Markdown file (positional) |
| Cover image |
| Override title |
| Publish (default: preview) |
Frontmatter:
,
supported in YAML front matter.
Notes
- First run: manual login required (session persists)
- Always preview before
- Cross-platform: macOS, Linux, Windows
Extension Support
Custom configurations via EXTEND.md. See Preferences section for paths and supported options.