XHS Publish Handoff
Use this only after the post content and image assets are approved.
Prerequisites
This skill handles the publishing handoff. It does not design image cards. For
Figma card creation, use xhs-figma-cards with a working Figma automation
adapter. The workflow was tested with
qoli/figma-mcp-go, but other Figma MCP
or automation adapters can work if they expose equivalent read/write operations.
Without a working Figma adapter, the upstream card-design workflow cannot
inspect or update Figma.
Browser filling requires an existing CDP-enabled browser session, such as Arc or
Chrome at http://localhost:9222.
Workflow
- Confirm the inputs: title/body or draft file, image directory, image order, target account, and whether this is immediate or scheduled publishing.
- Validate the package with
scripts/xhs_prepare_publish.py before opening the browser.
- Review warnings with the user, especially URL-like text, App Store/download wording, private-contact wording, title length, body length, hashtag count, image count, and image dimensions.
- Use the existing Arc CDP browser session for Xiaohongshu creator work. Do not create a separate account state unless the user asks.
- Prefer the image composer URL (
target=image). If Xiaohongshu opens the home page or video tab, switch to 发布笔记 -> 上传图文 before filling.
- With approval, open the creator composer. With a separate approval, fill images/title/body and wait until the uploaded image count and editor fields are visible.
- After filling, verify the browser state: account, image count, title, body length, recognized
[话题] hashtags, suggested extra hashtags, and visible publish controls.
- Stop before the final publish click unless the user explicitly delegates that live action in this publishing step.
- After publishing, record the public URL if available, or creator-manager evidence if the public URL is not available yet.
Script
Resolve scripts/xhs_prepare_publish.py relative to this skill directory.
Validation only:
python3 skills/xhs-publish-handoff/scripts/xhs_prepare_publish.py \
--draft <approved-post.md> \
--images <image-directory> \
--expected-count <image-count> \
--expected-width <width> \
--expected-height <height>
Open creator page:
python3 skills/xhs-publish-handoff/scripts/xhs_prepare_publish.py \
--draft <approved-post.md> \
--images <image-directory> \
--expected-count <image-count> \
--open-browser
Fill composer after approval:
python3 skills/xhs-publish-handoff/scripts/xhs_prepare_publish.py \
--draft <approved-post.md> \
--images <image-directory> \
--expected-count <image-count> \
--fill-browser
The script defaults to natural sorting for *.png files, so Figma exports like
01-cover.png, 02-method.png, and 07-closing.png can be used directly.
Use --image-manifest <file> when order cannot be inferred from file names.
Use --strict-card-names only when the package must follow the old
card-01.png sequence.
Use --expected-count, --expected-width, --expected-height, --title,
--body, or --body-file when the package differs from the defaults. Use
--expected-hashtags "#A #B #C" when the final browser verification must confirm
specific Xiaohongshu [话题] recognition.
Browser fill behavior:
- Opens the image composer URL by default:
https://creator.xiaohongshu.com/publish/publish?from=menu&target=image
- Uploads images through the current Arc CDP session.
- Waits for the uploaded count and editor fields before filling copy.
- Fills title/body and then reports recognized topics, extra suggested topics,
image count, and publish controls.
- Never clicks final
发布 by itself.
Boundaries
- Do not design or revise the image cards here; use the Figma image-card workflow first.
- Do not run unattended account operations, mass posting, mass commenting, mass liking, mass collecting, or follow automation.
- Do not store cookies, QR codes, tokens, browser profiles, or session exports in a project repo.
- Do not treat validation warnings as blockers automatically; report them and let the user decide.
- Do not click final publish/save without explicit live approval.
1---2name: xhs-publish-handoff3description: Use when preparing, validating, filling, or recording a Xiaohongshu/XHS post after the user has approved the content and images. This skill handles the publishing handoff: validate title, body, hashtags, image order, and image dimensions; optionally open the Xiaohongshu creator composer through the user's existing Arc CDP session; optionally upload images and fill title/body; stop before the final publish click unless the user explicitly delegates that live action.4---56# XHS Publish Handoff78Use this only after the post content and image assets are approved.910## Prerequisites1112This skill handles the publishing handoff. It does not design image cards. For13Figma card creation, use `xhs-figma-cards` with a working Figma automation14adapter. The workflow was tested with15[qoli/figma-mcp-go](https://github.com/qoli/figma-mcp-go), but other Figma MCP16or automation adapters can work if they expose equivalent read/write operations.17Without a working Figma adapter, the upstream card-design workflow cannot18inspect or update Figma.1920Browser filling requires an existing CDP-enabled browser session, such as Arc or21Chrome at `http://localhost:9222`.2223## Workflow24251. Confirm the inputs: title/body or draft file, image directory, image order, target account, and whether this is immediate or scheduled publishing.262. Validate the package with `scripts/xhs_prepare_publish.py` before opening the browser.273. Review warnings with the user, especially URL-like text, App Store/download wording, private-contact wording, title length, body length, hashtag count, image count, and image dimensions.284. Use the existing Arc CDP browser session for Xiaohongshu creator work. Do not create a separate account state unless the user asks.295. Prefer the image composer URL (`target=image`). If Xiaohongshu opens the home page or video tab, switch to `发布笔记` -> `上传图文` before filling.306. With approval, open the creator composer. With a separate approval, fill images/title/body and wait until the uploaded image count and editor fields are visible.317. After filling, verify the browser state: account, image count, title, body length, recognized `[话题]` hashtags, suggested extra hashtags, and visible publish controls.328. Stop before the final publish click unless the user explicitly delegates that live action in this publishing step.339. After publishing, record the public URL if available, or creator-manager evidence if the public URL is not available yet.3435## Script3637Resolve `scripts/xhs_prepare_publish.py` relative to this skill directory.3839Validation only:4041```sh42python3 skills/xhs-publish-handoff/scripts/xhs_prepare_publish.py \43 --draft <approved-post.md> \44 --images <image-directory> \45 --expected-count <image-count> \46 --expected-width <width> \47 --expected-height <height>48```4950Open creator page:5152```sh53python3 skills/xhs-publish-handoff/scripts/xhs_prepare_publish.py \54 --draft <approved-post.md> \55 --images <image-directory> \56 --expected-count <image-count> \57 --open-browser58```5960Fill composer after approval:6162```sh63python3 skills/xhs-publish-handoff/scripts/xhs_prepare_publish.py \64 --draft <approved-post.md> \65 --images <image-directory> \66 --expected-count <image-count> \67 --fill-browser68```6970The script defaults to natural sorting for `*.png` files, so Figma exports like71`01-cover.png`, `02-method.png`, and `07-closing.png` can be used directly.72Use `--image-manifest <file>` when order cannot be inferred from file names.73Use `--strict-card-names` only when the package must follow the old74`card-01.png` sequence.7576Use `--expected-count`, `--expected-width`, `--expected-height`, `--title`,77`--body`, or `--body-file` when the package differs from the defaults. Use78`--expected-hashtags "#A #B #C"` when the final browser verification must confirm79specific Xiaohongshu `[话题]` recognition.8081Browser fill behavior:8283- Opens the image composer URL by default:84 `https://creator.xiaohongshu.com/publish/publish?from=menu&target=image`85- Uploads images through the current Arc CDP session.86- Waits for the uploaded count and editor fields before filling copy.87- Fills title/body and then reports recognized topics, extra suggested topics,88 image count, and publish controls.89- Never clicks final `发布` by itself.9091## Boundaries9293- Do not design or revise the image cards here; use the Figma image-card workflow first.94- Do not run unattended account operations, mass posting, mass commenting, mass liking, mass collecting, or follow automation.95- Do not store cookies, QR codes, tokens, browser profiles, or session exports in a project repo.96- Do not treat validation warnings as blockers automatically; report them and let the user decide.97- Do not click final publish/save without explicit live approval.
qoli