Repolode
Submit
helloianneo

helloianneo/ian-xhs-carousel

A Claude Code Skill that turns an article, case study or note into a 3:4 Xiaohongshu-style carousel of 1080×1440 PNG pages, with 20 layout templates.

View on GitHubWebsite
Stars
92
Forks
7
Open issues
0
Last commit
8 hours ago

What is it?

Ian XHS Carousel is an AI Skill for Claude Code that converts written content into a set of Xiaohongshu (RedNote) image posts in a clean, product-interface style. You supply the content, and it first produces a storyboard that you confirm, then lays out and renders the pages.

The output includes a storyboard table, one 1080×1440 PNG per page, an overview image showing all pages together, and editable HTML source files. Light and dark variants share the same layouts. The project provides 20 templates grouped by purpose, covering covers, step lists, before-and-after comparisons, screenshot showcases, data metrics, code and prompt display, and closing slides. Post titles, body text and hashtags are written separately by the user.

Rendering uses Python with Playwright and Pillow, with Chromium installed through Playwright. It is intended for users of Claude, and the project notes it is not suited to hand-drawn, illustrated or large-color-block poster styles.

Key features

  • 01Generates a storyboard for confirmation before rendering pages.
  • 02Outputs 1080×1440 PNG pages plus an overview image.
  • 03Provides 20 templates in light and dark themes.
  • 04Exports editable HTML source for manual text or image changes.
  • 05Installs as a Claude Code skill folder.

Use cases

  • Turning a blog post or case study into a multi-page Xiaohongshu image post.
  • Showing screenshots, steps or before-and-after comparisons in a consistent visual style.
  • Producing tech or product content with code or prompt snippets as carousel slides.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/helloianneo/ian-xhs-carousel.git
  2. 2

    Create the Claude Code skills folder

    mkdir -p ~/.claude/skills
  3. 3

    Copy the skill folder into Claude Code

    cp -R ./ian-xhs-carousel/ian-xhs-carousel ~/.claude/skills/
  4. 4

    Install the rendering tools (then run playwright install chromium)

    pip install playwright pillow

Things to know

  • Designed to run best with Claude, and it is a Claude Code Skill rather than a standalone app.
  • Rendering downloads English and code fonts online, so it needs a network connection.
  • It only suits a clean product-interface style, not hand-drawn, illustrated, or poster-style designs.

Topics

#claude-code#claude-skill#xiaohongshu#carousel#design#content-creation#html-to-image#ai-agent#chinese

FAQ

What is ian-xhs-carousel?
A Claude Code Skill that turns an article, case study or note into a 3:4 Xiaohongshu-style carousel of 1080×1440 PNG pages, with 20 layout templates. Ian XHS Carousel is an AI Skill for Claude Code that converts written content into a set of Xiaohongshu (RedNote) image posts in a clean, product-interface style. You supply the content, and it first produces a storyboard that you confirm, then lays out and renders the pages.
Is ian-xhs-carousel free to use? What license does it have?
ian-xhs-carousel is open source under the MIT license. Check the license terms before using it in commercial products.
Is ian-xhs-carousel still maintained?
Actively maintained. The last commit to ian-xhs-carousel was on Oct 21, 2026.
What can I use ian-xhs-carousel for?
Turning a blog post or case study into a multi-page Xiaohongshu image post. Showing screenshots, steps or before-and-after comparisons in a consistent visual style. Producing tech or product content with code or prompt snippets as carousel slides.
How do I install ian-xhs-carousel?
Clone the repository: git clone https://github.com/helloianneo/ian-xhs-carousel.git Create the Claude Code skills folder: mkdir -p ~/.claude/skills Copy the skill folder into Claude Code: cp -R ./ian-xhs-carousel/ian-xhs-carousel ~/.claude/skills/ Install the rendering tools (then run playwright install chromium): pip install playwright pillow
Where can I get ian-xhs-carousel?
The source code and installation instructions are on GitHub: https://github.com/helloianneo/ian-xhs-carousel

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects