mcpField
X
xiaohongshu-card-notes

xiaohongshu-card-notes

github.com/postplusaiMarketing & growth27139 installsUpdated 1d ago
Repository

About xiaohongshu-card-notes

A skill for turning source material into Xiaohongshu card-note plans, for creators preparing carousel-style posts. It structures content page by page while keeping the source’s claims and visual references in view.

Key features

  1. 01Distinguishes content conversion from layout-only tasks
  2. 02Plans page order and roles
  3. 03Drafts headlines and body copy per page
  4. 04Adapts HTML, scripts, and mixed sources
  5. 05Provides card layout and visual notes

Use cases

  1. 01Turn a landing page into Xiaohongshu cards
  2. 02Condense a spoken script into page-by-page points
  3. 03Plan cards for existing copy

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/postplusai/postplus-skills --skill xiaohongshu-card-notes

After installing, type/xiaohongshu-card-notesin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

_postplus_shared/00-core/shared-runtime/scripts/
download_videos_from_manifest_with_ytdlp.mjs
_postplus_shared/00-core/shared-runtime/scripts/lib/
execution_approval.mjs
hosted_billing_summary.mjs
hosted_execution_protocol.mjs
hosted_media_generation_bridge.mjs
local_skill_cli.mjs
network_runtime.mjs
postplus_cli_config.mjs
postplus_cloud_client.mjs
skill_runtime.mjs
references/
card-layout-spec.md
source-adaptation-workflow.md
scripts/
build_xhs_card_notes_package.mjs

Details

From the project README

Xiaohongshu Card Notes

Follow shared public skill rules in:

  • postplus-shared public skill rules

Use this skill when the user wants to turn existing material into a Xiaohongshu card-style note.

Typical source inputs:

  • an HTML landing page
  • a spoken script
  • a markdown memo
  • a result table or dashboard
  • a case study page
  • a workflow explanation that should become carousel cards

This skill is for card-style image notes, not for generic captions or long prose posts.

Default Goal

Produce a Xiaohongshu card note that is:

  • easy to scan on mobile
  • visually structured
  • page-by-page clear
  • information-dense without losing scanability
  • faithful to the source material

The target is not "rewrite beautifully."

The target is:

  • extract the strongest message from the source
  • map it into a small number of strong cards
  • keep each page readable even when density is high
  • make the output directly usable for design

First Decision

Decide what the user actually needs:

1. content-to-cards

Use when the user has source material and wants a full Xiaohongshu card note structure.

Return:

  • page plan
  • cover title
  • per-page headline
  • per-page body copy
2. layout-only

Use when the user already has the page copy and wants packaging only.

Do not rewrite the substance unless asked.

3. html-adaptation

Use when the source is an HTML page or landing page.

Inspect:

  • section hierarchy
  • proof/data modules
  • title system
  • visual rhythm

Then convert it into Xiaohongshu pages rather than mirroring the full web layout.

4. script-adaptation

Use when the source is a spoken script.

Do not preserve spoken redundancy. Compress the script into card-ready statements.

5. hybrid-source

Use when the user provides both an HTML page and a script.

Default behavior:

  • take structure from the HTML if it is strong
  • take judgment and phrasing from the script if it is stronger
  • merge them into one card sequence

Layout Rules

Read references/card-layout-spec.md whenever the user asks for design-ready card output.

Non-negotiable defaults:

  • aspect ratio: 3:4
  • canvas size: 1242 x 1656
  • do not assume every page must be sparse
  • some pages should be image-led
  • some pages should be dense memo pages
  • left alignment is the default
  • use only a small number of emphasis treatments
  • when a repo already contains a strong HTML or landing page reference, inherit its color system, card language, corner radius, and visual rhythm instead of inventing a new style
  • when the user provides a strong HTML or landing page reference, treat that file as the visual source of truth for card rendering
  • use the landing page's dark floating pill, luminous blue gradient blocks, pale blue surfaces, large radius cards, and black headlines on light backgrounds
  • older black memo-card constraints are deprecated in the current release style and should be overridden when they conflict with the landing page reference

Source Adaptation Workflow

Read references/source-adaptation-workflow.md when adapting from HTML, scripts, or mixed sources.

The working order is:

  1. identify the core claim
  2. decide the card sequence
  3. compress each page to one job
  4. assign a page role
  5. write card copy that fits the page role

Page Roles

Common page roles:

  • cover
  • image-led cover
  • problem
  • hidden truth
  • framework
  • dense memo explanation
  • proof / data
  • case result
  • workflow snapshot
  • table screenshot page
  • closing judgment

Not every note needs all of them.

Choose the smallest set that makes the story clear.

Copy Rules

For each page:

  • one page = one main takeaway
  • do not flatten everything into short slogans
  • prefer short declarative lines
  • keep keywords strong and sparse
  • preserve the user's judgment and operator tone
  • avoid not X, but Y by default
  • avoid in other words by default
  • prefer direct statements over rhetorical contrast templates

For dense memo pages:

  • allow 3-6 short paragraphs when needed
  • each paragraph should push one sub-point
  • paragraph spacing matters more than bullet count
  • the page should still feel screenshot-worthy on its own

For image-led pages:

  • let the image carry pause, mood, or proof
  • keep the copy compact but sharp
  • use these pages to create rhythm between dense pages

If adapting from a spoken script:

  • remove repeated setup
  • remove oral filler
  • keep the strongest lines
  • convert explanation into page headlines and short supporting text

If adapting from HTML:

  • do not reproduce navbar, footer, or web-only scaffolding
  • keep hero claim, proof blocks, workflow blocks, and result table logic only if they help the card sequence
  • web sections often need to be split into multiple cards

Do not force every section into a sparse card. If the source contains strong reasoning, preserve it as a dense memo page.

Output Shapes

Return the smallest useful output for the ask.

Common shapes:

  • image-post structure
  • cover title options
  • page-by-page copy
  • design notes
  • image-post brief

For full card generation, default to this format:

cover

  • title
  • subtitle or tag

page 2

  • headline
  • body
  • optional design note

Repeat page by page.

Design Notes

Only include design notes when they help execution.

Useful design notes:

  • text hierarchy
  • suggested emphasis word
  • suggested chart / table / screenshot use
  • whether the page should be mostly text or mostly visual
  • which parts of the reference HTML visual language should be inherited
  • which card should use hero-gradient treatment
  • which card should use white proof-table treatment
  • which card should use pale-blue supporting surfaces instead of dark memo panels

Avoid vague notes like "make it aesthetic."

Density Preference

This workspace now prefers a denser Xiaohongshu note style than generic carousel cards.

Default preference:

  • mix sparse and dense pages
  • let some pages read like high-value memo screenshots
  • allow stronger paragraph density when the reasoning matters
  • use images or screenshots to create breathing room between dense pages

Do not use 3 lines max as a universal rule. That only applies to light pages, not to memo pages.

Anti-Patterns

Do not:

  • dump the whole script onto cards unchanged
  • mirror a webpage section-for-section without compression
  • overload each page with too many bullets
  • use too many highlight colors
  • make every page equally loud
  • add generic Xiaohongshu fluff that weakens trust

Default Input Shape

A common input shape is:

  • professional scripts
  • structured HTML pages
  • result tables
  • proof-heavy workflow explanations

Default preference:

  • preserve the strongest judgments from the source
  • convert proof into visible card pages
  • turn tables or dashboards into one or more dedicated proof cards
  • mix high-density memo pages with visual proof pages
  • make the final output feel like a professional Xiaohongshu carousel, not a repackaged web page

Public Skill Execution Contract

  • keep page plans, source extracts, and intermediate layout notes under <work-folder>/.postplus/xiaohongshu-card-notes/
  • keep only final user-facing card copy or design briefs outside .postplus/
  • start with a bounded first pass on one source document and a small card set
  • fail fast if the required source material is missing or under-specified instead of inventing missing proof or using customer-specific fallback assumptions

Comments

Markdown supported