Xhs Note Creator
Turn briefs and source material into Xiaohongshu-style notes, rendered cover and card images, and optional publish steps for the Chinese red-note channel.
Overview
XHS Note Creator is an agent skill most often used in Launch (also Grow content) that drafts Xiaohongshu notes, renders themed image cards, and can publish to the platform.
Install
npx skills add https://github.com/comeonzhj/auto-redbook-skills --skill xhs-note-creatorWhat is this skill?
- Four-step workflow: copy, render-ready Markdown, image cards, optional XHS publish
- Eight layout themes including sketch, neo-brutalism, botanical, and terminal
- Four pagination modes: separator, auto-fit, auto-split, and dynamic
- Generates cover.png plus numbered card_N.png assets from Python render_xhs.py
- Titles ≤20 characters and 5–10 SEO hashtags baked into Xiaohongshu-style body rules
- 8 layout themes for image cards
- 4 smart pagination modes (separator, auto-fit, auto-split, dynamic)
- Title limit ≤20 characters; cover title/subtitle ≤15 characters each
Adoption & trust: 947 installs on skills.sh; 1.9k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have raw notes or briefs but no fast pipeline for Xiaohongshu-native copy, card visuals, and optional publish-ready assets.
Who is it for?
Solo builders and micro-teams distributing educational or product content on Xiaohongshu with agent-driven copy and automated card rendering.
Skip if: Builders focused only on English-language SEO blogs, brands with no Xiaohongshu presence, or teams unwilling to run Python render scripts locally.
When should I use this skill?
User needs to create Xiaohongshu note materials—copy, rendered cards, or publish—from provided briefs or source documents.
What do I get? / Deliverables
You get titled copy, cover and card PNGs from render_xhs.py, and optionally a published note when env credentials are configured.
- Xiaohongshu title and body with SEO tags
- cover.png and card_N.png image set
- Optional published Xiaohongshu note
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Launch/distribution is the canonical shelf because the skill’s end goal is publishing formatted notes and visuals to Xiaohongshu for audience reach. Distribution captures the four-step workflow from copywriting through image cards to optional platform publish, not just offline drafting.
Where it fits
Ship a product explainer note with sketch-theme cards and platform hashtags on launch day.
Batch-render weekly tutorial notes using auto-split when section lengths vary.
Test two cover titles in neo-brutalism theme before committing ad spend on Xiaohongshu.
How it compares
End-to-end Xiaohongshu content workflow skill—not a generic Canva template pack or Western social scheduler.
Common Questions / FAQ
Who is xhs-note-creator for?
Indie operators and marketers who publish on Xiaohongshu and want an agent-guided path from brief to image cards and optional posting.
When should I use xhs-note-creator?
At Launch when rolling out channel-specific posts; at Grow/content when scaling note batches; at Validate/landing when testing messaging with red-note formatted creatives before wider spend.
Is xhs-note-creator safe to install?
Publishing requires API or account secrets in .env—treat credentials carefully and review the Security Audits panel on this Prism page; validate rendered copy and hashtags before going live.
SKILL.md
READMESKILL.md - Xhs Note Creator
# 小红书笔记创作技能 根据用户提供的资料或需求，创作小红书笔记内容、生成精美图片卡片，并可选择发布到小红书。 > 详细参数文档见 `references/params.md` --- ## 工作流程 ### 第一步：撰写小红书笔记内容 根据用户需求和资料，创作符合小红书风格的内容： **标题**：不超过 20 字，吸引眼球，可用数字/疑问句/感叹号增强吸引力。 **正文**：段落清晰，点缀少量 Emoji（每段 1-2 个），短句短段，结尾附 5-10 个 SEO 标签。 --- ### 第二步：生成渲染用 Markdown 文档 **注意：此 Markdown 专为图片渲染设计，禁止直接使用上一步的笔记正文。** 文档结构： ```markdown --- emoji: "🚀" title: "封面大标题（≤15字）" subtitle: "封面副标题（≤15字）" --- # 正文内容... --- # 第二张卡片内容...（使用 --- 手动分隔时） ``` 分页策略选择： - 内容需精确切分 → 用 `---` 手动分隔，配合 `-m separator` - 内容长短不稳定 → 生成普通 Markdown，使用 `-m auto-split` --- ### 第三步：渲染图片卡片 ```bash python scripts/render_xhs.py <markdown_file> [options] ``` **默认主题**：`sketch`（手绘素描风格） **默认分页**：`separator`（按 `---` 分隔） 常用示例： ```bash # 默认（sketch 主题 + 手动分页） python scripts/render_xhs.py content.md # 自动分页（推荐内容长短不定时） python scripts/render_xhs.py content.md -m auto-split # 切换主题 python scripts/render_xhs.py content.md -t playful-geometric -m auto-split # 固定尺寸自动缩放 python scripts/render_xhs.py content.md -m auto-fit ``` 生成结果：`cover.png`（封面）+ `card_1.png`、`card_2.png`...（正文卡片） **可用主题**（`-t`）：`sketch`、`default`、`playful-geometric`、`neo-brutalism`、`botanical`、`professional`、`retro`、`terminal` **分页模式**（`-m`）：`separator`、`auto-fit`、`auto-split`、`dynamic` > 完整参数说明见 `references/params.md` --- ### 第四步：发布小红书笔记（可选） **前置条件**：配置好 `.env` 文件中的 `XHS_COOKIE`（详见 `references/params.md`） ```bash # 默认仅自己可见（推荐先预览确认） python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述" \ --images cover.png card_1.png card_2.png # 确认无误后公开发布 python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述" \ --images cover.png card_1.png card_2.png --public ``` > **默认以「仅自己可见」发布**，加 `--public` 参数才会公开。 --- ## 技能资源 ### 脚本 - `scripts/render_xhs.py` — 渲染脚本（主推，8 主题 + 4 分页模式） - `scripts/render_xhs_v2.py` — 渲染脚本 V2（备用，7 种渐变色彩风格） - `scripts/publish_xhs.py` — 发布脚本 ### 模板与样式 - `assets/cover.html` — 封面 HTML 模板 - `assets/card.html` — 正文卡片 HTML 模板 - `assets/styles.css` — 公共容器样式 - `assets/themes/` — 各主题 CSS 文件 ### 参考文档 - `references/params.md` — 完整参数参考（主题/模式/发布参数） ## 📕 Auto-Redbook-Skills（已重构版） ### ⚠️ 使用此工具前情确保已悉知官方 3 月 10 日发布的公告 公告地址：[关于打击AI托管运营账号的治理公告](http://xhslink.com/o/7WxTddvbmTu) ### 方式一：Claude Code Plugin 安装（推荐） ```bash # 添加本仓库为 marketplace /plugin marketplace add comeonzhj/Auto-Redbook-Skills # 安装插件 /plugin install auto-redbook-skills@comeonzhj-Auto-Redbook-Skills ``` 安装后运行 `/reload-plugins` 即可使用。 ### 方式二：一句话安装 跟你的 Agent 说： > 拉取下面的项目，安装其中的技能：https://github.com/comeonzhj/Auto-Redbook-Skills ### 方式三：手动安装 详见下方[使用方式总览](#-使用方式总览)。 --- > 自动撰写小红书笔记、生成多主题卡片、可选自动发布的 Skills > 当前版本对渲染脚本和样式系统做了**一次完整重构**，感谢 Cursor 的辅助开发 🙌 --- ## ✨ 本次重构亮点 - **🎨 8 套主题皮肤**：默认简约灰 + Playful Geometric / Neo-Brutalism / Botanical / Professional / Retro / Terminal / Sketch - **📐 4 种分页模式**： - `separator`：按 `---` 分隔手动分页 - `auto-fit`：固定尺寸，自动整体缩放内容，避免溢出/大面积留白 - `auto-split`：根据渲染后高度自动拆分为多张卡片 - `dynamic`：根据内容动态调整图片高度 - **🧱 统一卡片结构**：外层浅灰背景（`card-container`）+ 内层主题背景（`card-inner`）+ 纯排版层（`card-content`） - **🧠 封面与正文一体化**：封面背景、标题渐变和正文卡片背景都按主题自动匹配 --- ## 🖼 主题效果示例 > 所有示例均为 1080×1440px，小红书推荐 3:4 比例 > 更多示例去 [demo](/demos) 中查看 ||| |---|---| ||| ||| ### Auto-fit 模式示例（自动缩放）  --- ## 🚀 使用方式总览 ### 1. 克隆项目 ```bash git clone https://github.com/comeonzhj/Auto-Redbook-Skills.git cd Auto-Redbook-Skills ``` 可以将本项目放到支持 Skills 的客户端目录，例如： - Claude：`~/.claude/skills/` - Alma：`~/.config/Alma/skills/` - TRAE：`/your-path/.trae/skills/` ### 2. 安装依赖 **Python：** ```bash pip install -r requirements.txt playwright install chromium ``` **Node.js：** ```bash npm install npx playwright install chromium ``` --- ## 🎨 渲染图片（Python） 核心脚本：`scripts/ren