baoyu-post-to-weibo

Documentation Community v1.117.3

Repo stars 0
Author updated Jul 4, 2026, 09:22 AM
Author repo baoyu-skills

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: Posts text, images, videos, and long-form articles to Weibo via real Chrome browser (bypasses anti-bot detection). | Script | Pu…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Script Directory”, “Preferences (EXTEND.md)”, “Prerequisites”, “Regular Posts”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name baoyu-post-to-weibo directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Script Directory / Preferences (EXTEND.md) / Prerequisites” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read / write / shell-exec; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

Post to Weibo

Posts text, images, videos, and long-form articles to Weibo via 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 {baseDir}
Script path = {baseDir}/scripts/<script-name>.ts
Replace all {baseDir} in this document with the actual path
Resolve ${BUN_X} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun

Script Reference:

Script	Purpose
`scripts/weibo-post.ts`	Regular posts (text + images)
`scripts/weibo-article.ts`	Headline article publishing (Markdown)
`scripts/copy-to-clipboard.ts`	Copy content to clipboard
`scripts/paste-from-clipboard.ts`	Send real paste keystroke

Preferences (EXTEND.md)

Check EXTEND.md in priority order — the first one found wins:

Priority	Path	Scope
1	`.baoyu-skills/baoyu-post-to-weibo/EXTEND.md`	Project
2	`${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-weibo/EXTEND.md`	XDG
3	`$HOME/.baoyu-skills/baoyu-post-to-weibo/EXTEND.md`	User home

If none found, use defaults.

EXTEND.md supports: Default Chrome profile

Prerequisites

Google Chrome or Chromium
bun runtime
First run: log in to Weibo manually (session saved)

Regular Posts

Text + images/videos (max 18 files total). Posted on Weibo homepage.

${BUN_X} {baseDir}/scripts/weibo-post.ts "Hello Weibo!" --image ./photo.png
${BUN_X} {baseDir}/scripts/weibo-post.ts "Watch this" --video ./clip.mp4

Parameters:

Parameter	Description
`<text>`	Post content (positional)
`--image <path>`	Image file (repeatable)
`--video <path>`	Video file (repeatable)
`--profile <dir>`	Custom Chrome profile

Note: Script opens browser with content filled in. User reviews and publishes manually.

Headline Articles (头条文章)

Long-form Markdown articles published at https://card.weibo.com/article/v3/editor.

${BUN_X} {baseDir}/scripts/weibo-article.ts article.md
${BUN_X} {baseDir}/scripts/weibo-article.ts article.md --cover ./cover.jpg

Parameters:

Parameter	Description
`<markdown>`	Markdown file (positional)
`--cover <path>`	Cover image
`--title <text>`	Override title (max 32 chars, truncated if longer)
`--summary <text>`	Override summary (max 44 chars, auto-regenerated if longer)
`--profile <dir>`	Custom Chrome profile

Frontmatter: title, summary, cover_image supported in YAML front matter.

Character Limits:

Title: 32 characters max (truncated with warning if longer)
Summary/导语: 44 characters max (auto-regenerated from content if longer)

Markdown-to-HTML: Do NOT pass any --theme parameter when converting markdown to HTML. Use the default theme (no theme argument).

Article Workflow:

Opens https://card.weibo.com/article/v3/editor
Clicks "写文章" button, waits for editor to become editable
Fills title (validated for 32-char limit)
Fills summary/导语 (validated for 44-char limit)
Inserts HTML content into ProseMirror editor via paste
Replaces image placeholders one by one (copy image → select placeholder → paste)

Post-Composition Check: The script automatically verifies after all images are inserted:

Remaining WBIMGPH_ placeholders in editor content
Expected vs actual image count

If the check fails (warnings in output), alert the user with the specific issues before they publish.

Post Type Selection

Unless the user explicitly specifies the post type:

Markdown file (.md) → Headline Article (头条文章)
Plain text / text with images → Regular Post

Troubleshooting

Chrome debug port not ready

If a script fails with Chrome debug port not ready or Unable to connect, kill only the CDP Chrome instances (those with --remote-debugging-port AND the baoyu-skills profile), then retry:

pkill -f "remote-debugging-port.*baoyu-skills/chrome-profile" 2>/dev/null; sleep 2

CRITICAL: Never kill all Chrome processes (pkill -f "Google Chrome"). Only kill Chrome instances launched by CDP with the baoyu-skills profile directory. The user may have regular Chrome windows open.

Important: This should be done automatically -- when encountering this error, kill the CDP Chrome instances and retry the command without asking the user.

Notes

First run: manual login required (session persists)
All scripts only fill content into the browser, user must review and publish manually
Cross-platform: macOS, Linux, Windows

Extension Support

Custom configurations via EXTEND.md. See Preferences section for paths and supported options.

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Documentation
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 92 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @JimLiu · v1.117.3 · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Guided setup
External API key: No requirement detected
Detected OS requirements: macOS · Linux · Windows
Runtime requirements: Bun
Detected file/system behavior: Read-only
Write / modify
Shell exec
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview baoyu-post-to-weibo.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# Post to Weibo

Posts text, images, videos, and long-form articles to Weibo via 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 `{baseDir}`
2. Script path = `{baseDir}/scripts/<script-name>.ts`
3. Replace all `{baseDir}` in this document with the actual path
4. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

**Script Reference**:
| Script | Purpose |
|--------|---------|
| `scripts/weibo-post.ts` | Regular posts (text + images) |
| `scripts/weibo-article.ts` | Headline article publishing (Markdown) |
| `scripts/copy-to-clipboard.ts` | Copy content to clipboard |
| `scripts/paste-from-clipboard.ts` | Send real paste keystroke |

## Preferences (EXTEND.md)

Check EXTEND.md in priority order — the first one found wins:

| Priority | Path | Scope |
|----------|------|-------|
| 1 | `.baoyu-skills/baoyu-post-to-weibo/EXTEND.md` | Project |
| 2 | `${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-weibo/EXTEND.md` | XDG |
| 3 | `$HOME/.baoyu-skills/baoyu-post-to-weibo/EXTEND.md` | User home |

If none found, use defaults.

**EXTEND.md supports**: Default Chrome profile

## Prerequisites

- Google Chrome or Chromium
- `bun` runtime
- First run: log in to Weibo manually (session saved)

---

## Regular Posts

Text + images/videos (max 18 files total). Posted on Weibo homepage.

```bash
${BUN_X} {baseDir}/scripts/weibo-post.ts "Hello Weibo!" --image ./photo.png
${BUN_X} {baseDir}/scripts/weibo-post.ts "Watch this" --video ./clip.mp4
```

**Parameters**:
| Parameter | Description |

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Script Directory → Preferences (EXTEND.md) → Prerequisites → Regular Posts → Headline Articles (头条文章) → Post Type Selection
terms    -> Important · Agent Execution Instructions · Script Reference · EXTEND.md supports · Parameters · Note · Frontmatter · Character Limits
files/cmd -> scripts/ · {baseDir} · {baseDir}/scripts/<script-name>.ts · ${BUNX} · bun · npx · npx -y bun · scripts/weibo-post.ts
body sha256 -> da0954a8cfcf