Repolode
helloianneo

helloianneo/ian-xiaohei-illustrations

A Codex Skill that guides AI agents to generate white-background, hand-drawn 16:9 illustrations for Chinese articles, featuring the Xiaohei character.

Stars
12,674
Forks
1,454
Open issues
20
Last commit
26 days ago

What is it?

This is a Codex Skill that instructs an AI agent to turn a Chinese article, blog post, or methodology text into a set of body illustrations. It first picks one key judgment, process, structure, or state from the text, then produces a 16:9 hand-drawn explanatory image on a plain white background with a small amount of red, orange, and blue Chinese annotations.

The default visual character is "Xiaohei", a solid black figure with white dot eyes and thin legs, who is meant to actively perform the core action in each image rather than serve as decoration. The skill is not a general illustration prompt and not a PPT-style infographic template.

The workflow outputs a 4-8 image shot list per article, with theme, structure type, character action, and annotation suggestions for each, then generates PNG files saved into a workspace assets folder. It does not produce editable PPTX, SVG, or HTML files.

Key features

  • 01Produces 16:9 hand-drawn images on a pure white background.
  • 02Plans a 4-8 image shot list per article before generating.
  • 03Assigns a structure type to each image, such as workflow, before/after, or metaphor.
  • 04Uses a recurring black character, Xiaohei, to carry the core action.
  • 05Keeps Chinese annotations short and limited to red, orange, and blue accents.

Use cases

  • Adding illustrations to a Chinese knowledge or methodology article.
  • Turning an abstract judgment or workflow into a single explanatory metaphor image.
  • Keeping a consistent visual style across a series of Chinese blog posts.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git
  2. 2

    Enter the project folder

    cd ian-xiaohei-illustrations
  3. 3

    Copy the skill into your Codex skills directory

    cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/"
  4. 4

    In Codex, invoke the skill with a prompt such as the README example

Things to know

  • Designed for Codex and requires an AI image generation model to produce the illustrations.
  • Output is flat PNG only, with no editable PPTX, SVG or HTML source files.
  • Chinese text in generated images can contain typos or hallucinated labels and needs manual checking.
  • The style is tailored to Chinese articles and a specific character, so it does not suit general or commercial illustration.

Topics

FAQ

What is ian-xiaohei-illustrations?
A Codex Skill that guides AI agents to generate white-background, hand-drawn 16:9 illustrations for Chinese articles, featuring the Xiaohei character. This is a Codex Skill that instructs an AI agent to turn a Chinese article, blog post, or methodology text into a set of body illustrations. It first picks one key judgment, process, structure, or state from the text, then produces a 16:9 hand-drawn explanatory image on a plain white background with a small amount of red, orange, and blue Chinese annotations.
Is ian-xiaohei-illustrations free to use? What license does it have?
ian-xiaohei-illustrations is open source under the MIT license. Check the license terms before using it in commercial products.
Is ian-xiaohei-illustrations still maintained?
Actively maintained. The last commit to ian-xiaohei-illustrations was on Sep 24, 2026.
What can I use ian-xiaohei-illustrations for?
Adding illustrations to a Chinese knowledge or methodology article. Turning an abstract judgment or workflow into a single explanatory metaphor image. Keeping a consistent visual style across a series of Chinese blog posts.
How do I install ian-xiaohei-illustrations?
Clone the repository: git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git Enter the project folder: cd ian-xiaohei-illustrations Copy the skill into your Codex skills directory: cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/" In Codex, invoke the skill with a prompt such as the README example
Where can I get ian-xiaohei-illustrations?
The source code and installation instructions are on GitHub: https://github.com/helloianneo/ian-xiaohei-illustrations

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

Related projects