A numbered library of 331 hand-drawn illustration styles, 167 layouts and 36 solid color themes that turns picks into bilingual prompts for AI image generators.
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
Clone the repository
git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git - 2
Enter the project folder
cd ian-xiaohei-illustrations - 3
Copy the skill into your Codex skills directory
cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/" - 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
An AI agent skill that turns an article into a 3:4 vertical cover image prompt for WeChat Official Accounts and Xiaohongshu, with optional face consistency.
A Codex and Claude Code skill that turns a topic, article or story into a narrated hand-drawn explainer video, with stroke-by-stroke drawing and Chinese handwriting.
A Codex Skill that turns Chinese explainer scripts or SRT files into hand-drawn videos with stroke-by-stroke drawing, plus program-driven animation.
A Claude Code-style skill that turns a travel request into a verified, single-file HTML itinerary, using live web research and cross-checked sources.
An agent skill that makes AI coding agents report task results in controlled Simplified Chinese, based on ASD-STE100 principles.