JimLiu

baoyu-post-to-x

@JimLiu/baoyu-post-to-x
JimLiu
603
61 forks
Updated 1/18/2026
View on GitHub

Post content and articles to X (Twitter). Supports regular posts with images and X Articles (long-form Markdown). Uses real Chrome with CDP to bypass anti-automation.

Installation

$skills install @JimLiu/baoyu-post-to-x
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Pathskills/baoyu-post-to-x/SKILL.md
Branchmain
Scoped Name@JimLiu/baoyu-post-to-x

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions


name: baoyu-post-to-x description: Post content and articles to X (Twitter). Supports regular posts with images and X Articles (long-form Markdown). Uses real Chrome with CDP to bypass anti-automation.

Post to X (Twitter)

Post content, images, 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:

  1. Determine this SKILL.md file's directory path as SKILL_DIR
  2. Script path = ${SKILL_DIR}/scripts/<script-name>.ts
  3. Replace all ${SKILL_DIR} in this document with the actual path

Script Reference:

ScriptPurpose
scripts/x-browser.tsRegular posts (text + images)
scripts/x-article.tsLong-form article publishing (Markdown)
scripts/md-to-html.tsMarkdown → HTML conversion
scripts/copy-to-clipboard.tsCopy content to clipboard
scripts/paste-from-clipboard.tsSend real paste keystroke

Prerequisites

  • Google Chrome or Chromium installed
  • bun installed (for running scripts)
  • First run: log in to X in the opened browser window

References

  • Regular Posts: See references/regular-posts.md for manual workflow, troubleshooting, and technical details
  • X Articles: See references/articles.md for 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:

ParameterDescription
<text>Post content (positional argument)
--image <path>Image file path (can be repeated, max 4)
--submitActually post (default: preview only)
--profile <dir>Custom Chrome profile directory

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:

ParameterDescription
<markdown>Markdown file path (positional argument)
--cover <path>Cover image path
--title <text>Override article title
--submitActually 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):

  1. .baoyu-skills/baoyu-post-to-x/EXTEND.md (project)
  2. ~/.baoyu-skills/baoyu-post-to-x/EXTEND.md (user)

If found, load before workflow. Extension content overrides defaults.