explaingit

helloianneo/ian-xiaohei-scenes

Analysis updated 2026-05-18

82Audience · writerComplexity · 2/5LicenseSetup · easy

TLDR

A Codex AI skill that turns a Chinese-language article into a matching illustration, showing a character named Xiaohei acting out the article's real-world situation.

Mindmap

mindmap
  root((Xiaohei Scenes))
    What it does
      Reads a Chinese article
      Extracts core situation
      Generates matching image
    Tech stack
      Codex Skill
      Prompt templates
    Use cases
      Illustrate blog posts
      Depict workplace stress
      Long scroll story image
    Audience
      Writers
      Content creators

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 a matching illustration for a Chinese-language article about a workplace situation.

USE CASE 2

Turn a personal or project timeline into a long-scroll story image.

USE CASE 3

Get a shot list of illustration ideas for an article before generating images.

USE CASE 4

Produce a consistent character-driven visual style across multiple articles.

What is it built with?

Codex SkillPrompt Templates

How does it compare?

helloianneo/ian-xiaohei-scenes2latemc/justanothermusicclientaqua5230/usage
Stars828282
LanguageTypeScriptPython
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencewritergeneraldeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

This repository is a skill for the Codex AI agent tool, designed to help people who write Chinese-language articles generate matching illustration images. The core idea is to take something described in an article, such as a stressful situation at work or a turning point in a project, and convert it into a small visual scene featuring a character called Xiaohei alongside a real physical object, a physical action, and short Chinese text labels. The goal is to produce an image where a reader immediately recognizes their own experience. The README is written in Chinese. The skill is called Xiaohei Scenes 2.0, and it differs from an earlier version (Xiaohei Illustrations 1.0) in that it focuses on depicting realistic situations and emotions rather than diagrams or process breakdowns. Where the previous version was suited to explaining methods and structures, this version is suited to capturing workplace pressure, AI-era anxieties, product journeys, and personal experiences. There are two modes. The standard mode produces a 16:9 landscape image with a plain white background, one main physical object, one physical action performed by Xiaohei, and two to four short Chinese label tags with minimal color accents. The easter egg long-scroll mode produces an extra-wide horizontal story image for tracing a timeline of personal or project history, with a hand-drawn curved path, five to eight object nodes, and Xiaohei participating in each node. Installing the skill means cloning the repository and copying the inner subfolder into the Codex skills directory. Once installed, you invoke it inside Codex by referencing the skill name and describing your article or situation. The skill guides the AI through reading the content, identifying the core conflict or situation, selecting a reference template image from seven provided examples, choosing a real object and action, generating the image, and then checking it against a quality checklist. The repository includes seven example images, prompt templates, and reference documents covering the character design, object selection patterns, story extraction process, and quality criteria.

Copy-paste prompts

Prompt 1
Use this skill to generate 4 illustration images for the article I paste in.
Prompt 2
Use this skill's easter-egg long-scroll mode to turn my project retrospective into one story image.
Prompt 3
Analyze my article and suggest a shot list of scenes suited to this skill's style, without generating images yet.
Prompt 4
Explain the difference between this skill and the earlier Xiaohei Illustrations 1.0 version.

Frequently asked questions

What is ian-xiaohei-scenes?

A Codex AI skill that turns a Chinese-language article into a matching illustration, showing a character named Xiaohei acting out the article's real-world situation.

What license does ian-xiaohei-scenes use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

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

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

Who is ian-xiaohei-scenes for?

Mainly writer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.