Post to X (Twitter)
Post content, images, videos, and long-form articles to X using real Chrome browser (bypasses anti-bot detection).
Script Directory
Important: All scripts are located in the scripts/ subdirectory of this skill.
Agent Execution Instructions:
- Determine this SKILL.md file's directory path as
SKILL_DIR - Script path =
${SKILL_DIR}/scripts/<script-name>.ts - Replace all
${SKILL_DIR}in this document with the actual path
Script Reference:
| Script | Purpose |
|---|---|
scripts/x-browser.ts | Regular posts (text + images) |
scripts/x-video.ts | Video posts (text + video) |
scripts/x-article.ts | Long-form article publishing (Markdown) |
scripts/md-to-html.ts | Markdown → HTML conversion |
scripts/copy-to-clipboard.ts | Copy content to clipboard |
scripts/paste-from-clipboard.ts | Send real paste keystroke |
Prerequisites
- Google Chrome or Chromium installed
buninstalled (for running scripts)- First run: log in to X in the opened browser window
References
- Regular Posts: See
references/regular-posts.mdfor manual workflow, troubleshooting, and technical details - X Articles: See
references/articles.mdfor long-form article publishing guide
Regular Posts
Text + up to 4 images.
# Preview mode (doesn't post)
npx -y bun ${SKILL_DIR}/scripts/x-browser.ts "Hello from Claude!" --image ./screenshot.png
# Actually post
npx -y bun ${SKILL_DIR}/scripts/x-browser.ts "Hello!" --image ./photo.png --submit
Note:
${SKILL_DIR}represents this skill's installation directory. Agent replaces with actual path at runtime.
Parameters:
| Parameter | Description |
|---|---|
<text> | Post content (positional argument) |
--image <path> | Image file path (can be repeated, max 4) |
--submit | Actually post (default: preview only) |
--profile <dir> | Custom Chrome profile directory |
Video Posts
Text + video file (MP4, MOV, WebM).
# Preview mode (doesn't post)
npx -y bun ${SKILL_DIR}/scripts/x-video.ts "Check out this video!" --video ./clip.mp4
# Actually post
npx -y bun ${SKILL_DIR}/scripts/x-video.ts "Amazing content" --video ./demo.mp4 --submit
Parameters:
| Parameter | Description |
|---|---|
<text> | Post content (positional argument) |
--video <path> | Video file path (required) |
--submit | Actually post (default: preview only) |
--profile <dir> | Custom Chrome profile directory |
Video Limits:
- Regular accounts: 140 seconds max
- X Premium: up to 60 minutes
- Supported formats: MP4, MOV, WebM
- Processing time: 30-60 seconds depending on file size
X Articles
Long-form Markdown articles (requires X Premium).
# Preview mode
npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md
# With cover image
npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md --cover ./cover.jpg
# Publish
npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md --submit
Parameters:
| Parameter | Description |
|---|---|
<markdown> | Markdown file path (positional argument) |
--cover <path> | Cover image path |
--title <text> | Override article title |
--submit | Actually publish (default: preview only) |
Frontmatter (optional):
---
title: My Article Title
cover_image: /path/to/cover.jpg
---
Notes
- First run requires manual login (session is saved)
- Always preview before using
--submit - Browser closes automatically after operation
- Supports macOS, Linux, and Windows
Extension Support
Custom configurations via EXTEND.md.
Check paths (priority order):
.baoyu-skills/baoyu-post-to-x/EXTEND.md(project)~/.baoyu-skills/baoyu-post-to-x/EXTEND.md(user)
If found, load before workflow. Extension content overrides defaults.