# Xiaohei Illustrations

Generate Ian-style Xiaohei illustrations for articles, posts, blogs, Notion documents...

- Repository: https://github.com/dzhng/skills (1394 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add dzhng/skills --skill xiaohei-illustrations -g -a claude-code -y`
Codex: `npx skills add dzhng/skills --skill xiaohei-illustrations -g -a codex -y`
Cursor: `npx skills add dzhng/skills --skill xiaohei-illustrations -g -a cursor -y`
Gemini CLI: `npx skills add dzhng/skills --skill xiaohei-illustrations -g -a gemini-cli -y`

## Description

Generate Ian-style Xiaohei illustrations for articles, posts, blogs, Notion documents, workflows, methods, processes, structures, states, metaphors, and opinions. Use when the user asks for weird, hand-drawn, Xiaohei, article, editorial, body illustrations, illustration ideas, shot lists, title removal, image edits, or image regeneration. By default, all image text and annotations are English, even when the source article is Chinese; only use another language when the user explicitly asks.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Xiaohei Illustrations

## Purpose

Create 16:9 horizontal illustrations for article body sections and blog headers. The goal is not commercial illustration, a slide, or a cute cartoon. Turn the article's key judgment, process, structure, state, or metaphor into a clean, weird, creative, readable-but-not-instructional hand-drawn explanation.

The default visual IP is Xiaohei: a solid-black creature with white dot eyes, thin legs, and a blank expression, seriously doing something absurd but meaningful. Xiaohei must participate in the central action, not stand beside it as decoration.

## Default language rule

All visible image text must be English by default. This includes labels, notes, signs, fictional UI text, and tiny annotations. Do not mix in Chinese or other languages unless the user explicitly requests another language.

Keep English labels short, natural, and correctly spelled. Prefer 2, 5 words per label.

## Read these references as needed

Do not load every reference unless the task needs it:

- `references/style-dna.md`: visual style, color rules, text rules, and prohibitions.
- `references/xiaohei-ip.md`: Xiaohei's appearance, personality, action library, and prohibitions.
- `references/composition-patterns.md`: composition types, original-metaphor method, and anti-copying rules.
- `references/prompt-template.md`: the single-image generation prompt template.
- `references/qa-checklist.md`: post-generation checks and iteration rules.
- `assets/examples/`: low-frequency visual calibration only. Do not copy the compositions, objects, or annotations from these examples.

## Workflow

### 1. Understand the article

Read the user's article, link, Notion page, Markdown file, screenshot, or stated idea. Identify:

- The core argument.
- Which paragraphs carry a cognitive turn.
- Which ideas benefit from an image.
- Which parts should remain text-only.

The rest: https://github.com/dzhng/skills/blob/HEAD/skills/graphics/xiaohei-illustrations/SKILL.md
