whatisgithub

What is ian-xiaohei-illustrations?

helloianneo/ian-xiaohei-illustrations — explained in plain English

Analysis updated 2026-05-18

1,224Audience · writerComplexity · 1/5LicenseSetup · easy

In one sentence

A Codex skill that generates white-background, hand-drawn illustrations starring a character named Xiaohei to visualize key ideas in Chinese articles.

Mindmap

mindmap
  root((xiaohei-illustrations))
    What it does
      Generates article illustrations
      Xiaohei character
      White background line art
      Chinese annotations
    Tech stack
      Codex Skill
      Image generation model
    Use cases
      Article shot list planning
      Concept metaphor illustration
      Blog and Notion content
    Audience
      Chinese content writers
      Codex skill users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate 4 to 8 illustration images for a Chinese article that visualize its key ideas or metaphors.

USE CASE 2

Plan a shot list of illustration moments for an article without generating images yet.

USE CASE 3

Create a single standalone illustration for one specific concept or metaphor.

USE CASE 4

Edit an existing generated illustration, such as removing an unwanted title or label.

What is it built with?

Codex SkillMarkdown

How does it compare?

helloianneo/ian-xiaohei-illustrationsclaudiodrews/memory-osduongductrong/snapzy
Stars1,2241,2221,212
LanguagePythonSwift
Last pushed2026-06-10
MaintenanceMaintained
Setup difficultyeasymoderateeasy
Complexity1/54/52/5
Audiencewriterdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Copy the ian-xiaohei-illustrations subfolder into the Codex skills directory, README and workflow are entirely in Chinese.

MIT License: free to use, modify, and distribute, including commercially, as long as the license notice is kept.

So what is it?

This project is a skill for AI coding tools, specifically Codex, that generates hand-drawn illustration images to accompany Chinese articles and blog posts. The goal is not to decorate a page with a generic image, but to identify a key idea, process, or metaphor within the article and draw it as a standalone visual that makes that idea more concrete and memorable. Every illustration follows the same visual style: a pure white background, black hand-drawn line art with thin slightly uneven strokes, generous empty space around the main subject, and a small amount of Chinese handwritten annotations in red, orange, or blue. The central character in most images is called Xiaohei, a simple black solid figure with white dot eyes and thin legs. Xiaohei is meant to be an active participant in whatever the diagram depicts, not a decoration standing to the side. The README describes the aesthetic as strange but clean, and explicitly rules out cute, childish, or cartoon-style results. The typical workflow starts by reading the article and identifying four to eight moments worth illustrating. For each one the agent produces a shot list entry describing where in the article it belongs, what the core idea is, and what Xiaohei should be doing. Then it calls an image generation model once per image, checks the result against a quality checklist covering white background, correct proportions, readable Chinese text, and Xiaohei's involvement in the action, and saves the final PNGs to a folder named after the article. The README notes that Chinese text inside generated images should be kept very short for reliability, and that AI image models may occasionally produce typos, misplaced labels, or style drift that requires a manual check before publishing. The skill is installed by copying a subfolder into the directory where Codex looks for skills. The README is written in Chinese.

Copy-paste prompts

Prompt 1
Use ian-xiaohei-illustrations to generate 4 hand-drawn illustrations for this Chinese article with white background and red-orange-blue annotations.
Prompt 2
Use ian-xiaohei-illustrations to plan a shot list of 5 illustration moments for this article without generating images yet.
Prompt 3
Use ian-xiaohei-illustrations to create one illustration for the metaphor that trust is built evidence by evidence.
Prompt 4
Use ian-xiaohei-illustrations to edit this generated image and remove the top-left title text.

Frequently asked questions

What is ian-xiaohei-illustrations?

A Codex skill that generates white-background, hand-drawn illustrations starring a character named Xiaohei to visualize key ideas in Chinese articles.

What license does ian-xiaohei-illustrations use?

MIT License: free to use, modify, and distribute, including commercially, as long as the license notice is kept.

How hard is ian-xiaohei-illustrations to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ian-xiaohei-illustrations for?

Mainly writer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.