# xiaohongshu-images

Turns Markdown, HTML, or text into a styled page and a sequence of 3:4 images for Xiaohongshu. Use it to prepare article content for posting.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2000 installs · ★ 7
- Author: iamzifei
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/iamzifei/xiaohongshu-images-skill/tree/HEAD/SKILL.md
- Updated: 2026-08-12
- HTML: https://affpapa.org/en/nevibecode/skills/xiaohongshu-images

## What it does

Give the skill Markdown, HTML, or plain text. It uses `/baoyu-cover-image` for a cover, builds an HTML page from `prompts/default.md`, then captures the page as consecutive 3:4 images. The capture flow is intended to keep text from being cut off.

The output goes into an article folder under `~/Dev/obsidian/`. The account folder is chosen from `--account`, the source file path, or a template mapping. The workflow checks Xiaohongshu requirements for both the cover and page content. The cover step depends on `/baoyu-cover-image`, so that skill needs to be available for the documented flow to work.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add iamzifei/xiaohongshu-images-skill --skill xiaohongshu-images -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/xiaohongshu-images/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/xiaohongshu-images/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add iamzifei/xiaohongshu-images-skill --skill xiaohongshu-images -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/xiaohongshu-images/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add iamzifei/xiaohongshu-images-skill --skill xiaohongshu-images -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/xiaohongshu-images/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install iamzifei/xiaohongshu-images-skill xiaohongshu-images
```

2. **Manually: put the files in place**
- File: `.github/skills/xiaohongshu-images/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add iamzifei/xiaohongshu-images-skill --skill xiaohongshu-images -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/iamzifei/xiaohongshu-images-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/xiaohongshu-images/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add iamzifei/xiaohongshu-images-skill --skill xiaohongshu-images -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/iamzifei/xiaohongshu-images-skill/tree/HEAD/SKILL.md

## When to use it
- turn a Markdown article into a styled HTML page
- create a cover for a Xiaohongshu post
- capture a long page as 3:4 images
- save article assets under the selected account folder

## Example prompts
- Create Xiaohongshu images from `article.md` with `/xiaohongshu-images article.md`.
- Prepare this article for the `james-en` account: `/xiaohongshu-images <article> --account james-en`.
- Turn `page.html` into a sequence of images for Xiaohongshu: `/xiaohongshu-images page.html`.

## Similar
- [xiaohongshu-cover-generator](https://affpapa.org/en/nevibecode/skills/xiaohongshu-cover-generator.md) — skill · 1800 installs
- [xiaohongshu-cli](https://affpapa.org/en/nevibecode/skills/xiaohongshu-cli.md) — skill · 1400 installs
- [baoyu-xhs-images](https://affpapa.org/en/nevibecode/skills/baoyu-xhs-images.md) — skill · 31300 installs
- [prompt-images](https://affpapa.org/en/nevibecode/skills/prompt-images.md) — skill · 2600 installs
- [openrouter-images](https://affpapa.org/en/nevibecode/skills/openrouter-images.md) — skill · 471 installs
- [generating-images](https://affpapa.org/en/nevibecode/skills/spencerpauly-generating-images.md) — skill · 388 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md