Xhs Note logo

Xhs Note

CommunityPopular
mateaix
xhs_note

小红书图文创作 / 笔记 / 种草文案 (xiaohongshu / red note) — 端到端:成文→配图(≥3 张竖版)→去AI化→在线预览打包交付。以图为主、文字辅助:标题四件套 + 碎句正文 + 话题标签,配 3:4 竖版卡片,最少 3 张图。honors user persona & style memory.

Overview

Publishermateaix
Repositorymateclaw
Skill namexhs_note
Stars
1.1K
Forks
337
Bundled files
4
LicenseApache-2.0
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 4 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by mateaix on GitHub. Read the source before you install it.

Installation

Install the Xhs Note AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/mateaix/mateclaw/tree/dev/mateclaw-server/src/main/resources/skills/xhs_note
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/mateaix/mateclaw.git /tmp/mateclaw
mkdir -p .claude/skills
cp -r /tmp/mateclaw/mateclaw-server/src/main/resources/skills/xhs_note .claude/skills/xhs_note
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Xhs Note in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Xhs Note on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Xhs Note is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

小红书图文创作

把一个主题做成可直接发布的小红书笔记:文案 + 竖版图文卡片。

🖼️ 小红书是「以图为主、文字辅助」的平台。读者先滑图、再看字——首图(封面)决定点不点进来,图不够好、不够多,文案再好也没人看。

硬性要求:每篇笔记至少 3 张竖版图(1 封面 + ≥2 张内容图/照片)。xhs_package 会强制校验,不足 3 张直接拒绝打包。图要成组、风格统一、信息落在图上(大标题/清单/对比都做进图里),正文只作补充。

开工前:读取共享人设记忆

先用 recall_structured 取回并全程遵守:

  • content_persona — 人设 / 口吻
  • writing_style_xhs — 小红书文风
  • topic_interests — 选题方向
  • banned_words — 禁用 / 敏感词
  • signature_blocks — 固定开场 / 结尾段

取不到就用中性默认,不要编造。

SOP

1. 成文(小红书文案公式)

标题(≤20 字,四件套任选组合)

  • 数字:「30天」「省了800块」「3个动作」
  • 悬念:「原来一直做错了……」
  • 情绪:😭 😮‍💨 🤯 直给情绪
  • 对比 / 反转:「从烂脸到裸妆出门」

正文

  • 碎句、一句一断,用 emoji 分段。
  • 开头痛点共鸣,戳中读者才往下看。
  • 中段干货清单:可操作、具体、有数字。
  • 全程 writing_style_xhs + content_persona,大量第一人称和"姐妹们 / 你"。

话题标签(3–8 个)

大词 + 中词 + 长尾组合,例:#护肤 #敏感肌护肤 #学生党平价护肤。

2. 配图(以图为主,≥3 张竖版)

这是小红书的重头戏。至少出 3 张 3:4 竖版图,一组风格统一:

  1. 封面(第 1 张,必出) — 大标题 + 一句钩子,缩略图上就能读懂、想点进来。
  2. 内容图(≥2 张) — 把干货做进图里:清单卡、步骤卡、对比卡、金句卡,或用 image_generate(aspectRatio=portrait)出实拍风照片/场景图。一条要点一张,别把所有字堆一张。
  3. 结尾图(可选) — 关注 / 互动引导卡。

两种出图方式,按需混用,凑够 ≥3 张:

  • HTML 卡片 → 图:用下面的模板库填文案后 render_html_image 渲染。
  • AI 生成照片/背景:image_generate(action=generate, aspectRatio=portrait)(3:4 竖版),做封面底图或实拍风内容图。

卡片模板库(竖版 3:4,挑选组合或据用户口味自创):

  • references/xhs_card_cover.html — 封面 / 大标题。
  • references/xhs_card_content.html — 干货清单。
  • references/xhs_card_end.html — 关注 CTA。
  • references/xhs_card_quote.html — 金句 / 大字引用卡。

想要别的视觉风格时,直接生成一份新的自包含 HTML 卡片(可参考现有模板结构),不必局限于现成几款。render_html_image 渲染出的 PNG 本身就是预览——先把图给用户看,满意再进入第 4 步打包。

填充占位符:每个模板里有 {{TITLE}} {{SUBTITLE}} {{POINTS}} {{CTA}} 等占位 token。把第 1 步的文案填进去——{{POINTS}} 是清单,按模板注释里的格式(每条一个 <li>)注入。

渲染成图:用 render_html_image 把填好的 HTML 渲染成 PNG。两种传法:

  • 写入临时文件后传 filePath:
    render_html_image(filePath="<填好的卡片.html>", filename="xhs_cover",
                      width=1080, height=1440, fullPage=false)
  • 或直接内联传 html="<填好的完整HTML字符串>",其余参数同上。

竖版 3:4 用 width=1080 height=1440。fullPage=false 保证输出严格 3:4,不因内容溢出而拉长。

可选封面底图:想要更精致的封面,可先用 image_generate(aspectRatio=portrait)生成一张背景图,再把其链接填进封面模板的背景占位处。

3. 去 AI 化

load_skill deai_humanize,对正文跑"打分→改写→复检"循环,platform=xhs,目标 score ≤ 55。小红书口吻要碎、要有情绪,别写成公众号。

4. 打包交付(xhs_package —— 在线预览 + 素材下载)

默认用 xhs_package 交付。它产出小红书风的在线预览(手机版:图在上、可左右滑动,标题/正文/标签在下辅助)+ 素材 zip(按 01、02… 编号的卡片图 + 文案.txt),并附手动上传步骤:

xhs_package(title="<标题>", body="<正文,含 emoji 与换行>",
            tags="标签1,标签2,标签3",
            images="<封面图链接>,<内容图1链接>,<内容图2链接>[,更多]")

images 按展示顺序传每张图的 render_html_image / image_generate 返回链接(首图即封面)。

⚠️ xhs_package 强制 ≥3 张图:解析到的图不足 3 张会被直接拒绝,并提示去补图。所以第 2 步务必先把 ≥3 张竖版图都出好,再来打包。

把返回的在线预览链接发给用户看;满意后由用户下载素材 zip,到创作平台手动上传。小红书没有官方发布 API:不自动上传、不绕过任何风控/人机验证。发布属于对外动作,必须用户明确同意。

(旧的 xhs_publish 只出 zip、无在线预览,xhs_package 已覆盖并更完整;仅在用户只要发布包、不需要预览时才用它。)

打包前对照 banned_words 扫一遍正文和标题,命中即标注替换。

定时 / 批量场景:内容日历 + 合规

长期投产(每日定时)时:

  • 选题前查重(成文前):content_item(action="check_recent", platform="xhs", topic="<选题>"),命中就换角度。只计已打包/已发布。
  • 交付即扫即记(自动):xhs_package 交付时会自动跑合规扫描并自动记入内容日历——你只需在 xhs_package 里传上 topic="<选题>"(与 title 区分)。个人 / 品牌禁用词可另调 compliance_scan(text, extraBannedWords="<recall 到的 banned_words>")。
  • 上传后:用户手动发布后 content_item(action="mark_published", id),就能知道哪些已发、哪些还在待办。

保存自定义卡片模板 / 对话升级技能

用户满意某个自创卡片、想复用时,用 skill_manage 存成自定义技能(builtin=false 才能写):

  • skill_manage(action="create", name="my_xhs_cards", content="<一份 SKILL.md>")(首次)。
  • skill_manage(action="write_file", name="my_xhs_cards", filePath="references/<卡片名>.html", content="<HTML>")。

本技能 xhs_note 是内置技能、不能被直接编辑;自定义卡片一律存到用户自己的自定义技能里。写入都会过安全扫描。

参考

  • references/xhs_card_cover.html — 封面大标题卡(bold hero)。
  • references/xhs_card_content.html — 干货清单卡(clean list)。
  • references/xhs_card_end.html — 关注引导卡(follow CTA)。
  • references/xhs_card_quote.html — 金句 / 大字引用卡。

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Xhs Note AI skill do?

小红书图文创作 / 笔记 / 种草文案 (xiaohongshu / red note) — 端到端:成文→配图(≥3 张竖版)→去AI化→在线预览打包交付。以图为主、文字辅助:标题四件套 + 碎句正文 + 话题标签,配 3:4 竖版卡片,最少 3 张图。honors user persona & style memory.

Why use Xhs Note on TypingMind?

Because you install it once and use it with any model. Xhs Note is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Xhs Note in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/mateaix/mateclaw/tree/dev/mateclaw-server/src/main/resources/skills/xhs_note. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Xhs Note?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Xhs Note?

As many as you like. As long as a model supports skills, you can use Xhs Note with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Xhs Note AI skill free?

Yes. It is published on GitHub by mateaix under the Apache-2.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇