Agent skill

Xiaohei Chinese Article Illustrations

by helloianneo in helloianneo/ian-xiaohei-illustrations

Plans and generates 16:9 hand-drawn illustrations for Chinese articles on a white background, with a recurring black character and a few red, orange and blue handwritten notes.

MITAuto-check: warningsMedia & Creative

SKILL.md written in Chinese; this summary is our English description.

Install Xiaohei Chinese Article Illustrations

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add helloianneo/ian-xiaohei-illustrations --skill ian-xiaohei-illustrations -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install helloianneo/ian-xiaohei-illustrations ian-xiaohei-illustrations --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/helloianneo/ian-xiaohei-illustrations.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ian-xiaohei-illustrations .claude/skills/ian-xiaohei-illustrations && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ian-xiaohei-illustrations
GitHub stars
12k
Used in
3 other repos
Token cost
~470 tokens
SKILL.md length
100 words
Files
21 (incl. references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Plans and generates 16:9 hand-drawn illustrations for Chinese articles on a white background, with a recurring black character and a few red, orange and blue handwritten notes.

  • Works in 5 steps: 消化正文 → 先出配图策略 → 单张生成 → …
  • Adding hand-drawn illustrations to a Chinese article or blog post
  • SKILL.md covers 核心定位, 先读这些参考, 工作流 and 输出口径
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This skill designs and generates widescreen illustrations that sit inside Chinese articles, posts, blog entries and Notion or workflow documents. The aim is not commercial illustration, slide-style infographics or cute cartoons but a clean, quirky hand-drawn diagram that turns one key judgment, process, structure, state or metaphor from the text into a single picture. Images use a pure white background, black line art, plenty of empty space and a few handwritten Chinese annotations.

A recurring mascot called Xiaohei, a solid black figure with white dot eyes and thin legs, has to take part in the central action of every image. The workflow reads the article, picks the points that deserve a picture, such as core judgments, breakpoints, loops and before-and-after contrasts, and writes a shot list saying where each image goes and what it shows. It plans four to eight images by default and generates each one separately with the built-in image tool, without waiting for confirmation once you ask for generation. Each result is checked against a QA list, redone if it looks like a slide or has typos, and saved under an assets folder with numbered names.

The folder includes reference files for style, the mascot, composition patterns, a prompt template and the QA checklist, an agent configuration file for OpenAI, and a set of example images used only to calibrate the look, which the agent is told not to copy.

When your agent uses it

  • Adding hand-drawn illustrations to a Chinese article or blog post
  • Deciding which sections of a long piece need a picture at all
  • Turning a method, workflow or metaphor in a document into one explanatory image
  • Redoing images that came out too crowded or too much like slides

Example prompts

  • “Suggest where illustrations should go in my Chinese article about content workflows, with a shot list.”
  • “Generate the illustrations for this Notion article about team onboarding, one image per key idea.”
  • “Redo the third image without a title in the top-left corner and with less clutter.”

Requirements

  • An image generation tool the agent can call, such as image_gen

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 消化正文
  2. 先出配图策略
  3. 单张生成
  4. 检查与迭代
  5. 保存交付

What it can do on your machine

Read from SKILL.md and the folder at commit 4102eb8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Xiaohei Chinese Article Illustrations loads about 470 tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 100 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~470
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • WarningTells the agent its actions are pre-authorized / not to stop for confirmationSKILL.md:54
    如果用户明确要求“生成 / 输出 / 做图 / 帮我生成”,不要停下来等确认;用内置 `image_gen` 每张单独生成。不要把多张图拼在一张里。

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from helloianneo/ian-xiaohei-illustrations at commit 4102eb8, republished under its MIT licence (© helloianneo). 100 words, ~470 tokens.

Download SKILL.mdSave it as .claude/skills/ian-xiaohei-illustrations/SKILL.md (or your agent's skills folder). This skill also uses 20 other files; get the full folder from GitHub.
name
ian-xiaohei-illustrations
description
生成 Ian 风格的中文正文配图。用于用户要求为中文文章、帖子、博客、Notion 文档、工作流文档、方法论、流程、结构、状态、隐喻或观点生成“怪诞”“小黑”“手绘”“正文配图”“文章插图”“配图建议”“shot list”“去标题/改图”等任务;默认使用小黑 IP、纯白手绘、少量红橙蓝批注、简洁清爽但天马行空的视觉风格。

Ian 小黑怪诞正文配图

核心定位

为中文文章设计和生成 16:9 横版正文配图。目标不是做商业插画、PPT 信息图或可爱卡通,而是把文章里的关键判断、流程、结构、状态或隐喻,变成一张清爽、怪诞、有创意、可读但不说明书的手绘解释图。

默认视觉 IP 是“小黑”:黑色实心、白点眼、细腿、空表情,认真做一件荒诞但成立的事。小黑必须参与画面的核心动作,不能只是站在旁边当装饰。

先读这些参考

按任务需要读取,不要一次塞满上下文:

  • references/style-dna.md:风格 DNA、颜色、文字、禁忌。
  • references/xiaohei-ip.md:小黑 IP 的形象、性格、动作库和禁忌。
  • references/composition-patterns.md:结构类型、原创隐喻方法和反复刻规则。
  • references/prompt-template.md:单张生图提示词模板。
  • references/qa-checklist.md:生成后检查和迭代规则。
  • assets/examples/:只作低频视觉校准,不进入默认生成路径。不要照抄这些案例的构图、物件或标注。

工作流

1. 消化正文

先读用户给的正文、链接、Notion 页面、Markdown 文件或截图内容。提炼:

  • 核心观点是什么
  • 哪些段落承担认知转折
  • 哪些内容适合用图解释
  • 哪些地方只适合文字,不需要图

不要平均配图。优先选择“认知锚点”,例如:核心判断、两个断点、输入输出闭环、分流、前后对比、一鱼多吃、承接路径、常见坑、角色状态变化。

2. 先出配图策略

如果用户只是说“分析怎么配图 / 思考哪些地方需要配图”,先给 shot list。每张图写清楚:

  • 放在哪个段落后
  • 图的主题
  • 核心意思
  • 结构类型
  • 小黑在图里做什么
  • 建议元素
  • 建议中文标注词

默认 4-8 张。文章很短时 1-3 张;长文也不要轻易超过 9 张。够用就好,避免把正文做成画册。

3. 单张生成

如果用户明确要求“生成 / 输出 / 做图 / 帮我生成”,不要停下来等确认;用内置 image_gen 每张单独生成。不要把多张图拼在一张里。

每张图只讲一个核心结构。提示词必须包含:

  • 16:9 横版中文正文配图
  • 纯白背景
  • 黑色手绘线稿
  • 少量红色/橙色/蓝色中文手写批注
  • 大量留白
  • 小黑作为核心动作主体
  • 禁止 PPT、商业插画、幼稚可爱、复杂架构、左上角类型标题

不要复刻过往案例。案例只提供风格密度和小黑参与方式,不能直接复用“传送带断点 / 小黑拉线 / 素材鱼 / 盖章工具箱 / 常见坑路径”等已有构图,除非用户明确要求复刻某张图。每次都要从当前文章重新发明一个奇怪但成立的隐喻。

4. 检查与迭代

生成后检查 references/qa-checklist.md。如果出现以下问题,优先重生成或局部编辑:

  • 小黑只是装饰
  • 画面太满
  • 太像流程图/PPT
  • 中文太多或错字严重
  • 左上角出现“常见坑/流程图/系统架构图”等标题
  • 画风太可爱、幼稚、死板
  • 背景不是干净白底
5. 保存交付

如果用户在 workspace 内工作,把最终图复制到:

text
assets/<article-slug>-illustrations/

按顺序命名:

text
01-topic-name.png
02-topic-name.png

保留原始生成文件,不要覆盖已有资产,除非用户明确要求替换。

输出口径

生成前的策略输出要短而准。生成后的交付要包含:

  • 生成了几张
  • 每张图的用途
  • 保存路径
  • 哪些图最稳,哪些图是可选

不要长篇解释风格理论;让图自己说话。

© helloianneo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 20 other files (references, assets) in ian-xiaohei-illustrations of helloianneo/ian-xiaohei-illustrations.

  • SKILL.md
  • agents/openai.yaml
  • assets/examples/01-two-breakpoints.png
  • assets/examples/02-minimum-loop.png
  • assets/examples/03-sort-by-purpose.png
  • assets/examples/04-one-fish-many-uses.png
  • assets/examples/05-handoff-path.png
  • assets/examples/06-three-sources.png
  • assets/examples/07-three-content-jobs.png
  • assets/examples/08-handoff-copy-toolbox.png
  • assets/examples/09-common-pits-no-title.png
  • assets/examples/10-information-well.png
  • assets/examples/11-idea-press.png
  • assets/examples/12-content-fermentation.png
  • assets/examples/13-system-bearing.png
  • assets/examples/14-trust-bridge.png
  • references/composition-patterns.md
  • … and 4 more

Open the folder on GitHubat commit 4102eb8

Used in 3 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in helloianneo/ian-xiaohei-illustrations, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Xiaohei Chinese Article Illustrations next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Xiaohei Chinese Article Illustrations compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xiaohei Chinese Article Illustrations this skillhelloianneo/ian-xiaohei-illustrations12k3 repos~470Automated safety check: WarnMIT
Xhs Visual Directorziguishian/xhs-visual-director-skill1.4k—~2.2kAutomated safety check: PassMIT
Zy Cinematic Realismpopopo-99/zy-cinematic-realism570—~4.6kAutomated safety check: PassCC-BY-NC-4.0
Article IllustratorJimLiu/baoyu-skills27k3 repos~4.2kAutomated safety check: PassMIT
Novel Artsuihe1/short-drama-production181—~1.3kAutomated safety check: NotesApache-2.0
Image DirectorJamailar/Beav1.8k—~3.6kAutomated safety check: PassCustom licence

Similar skills

  • Xhs Visual Director

    ziguishian/xhs-visual-director-skill

    A skill your agent uses when planning, redesigning, or reviewing Xiaohongshu carousel visuals, covers, 3:4 image posts, page-by-page visual direction, image-generation prompts, style selection…

    1.4k GitHub stars~2.2k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Zy Cinematic Realism

    popopo-99/zy-cinematic-realism

    Develop supplied scripts, short stories, or synopses into scene understanding, director-facing art concepts, and motivated narrative keyframes; compile scene ideas, visual references, or existing…

    570 GitHub stars~4.6k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Article Illustrator

    JimLiu/baoyu-skills

    Reads an article, picks the spots that need visuals, and generates illustrations using a type, style and palette combination for a consistent look.

    27k GitHub starsUsed in 3 repos~4.2k tokens
    Media & CreativeAuto-check passed
  • Novel Art

    suihe1/short-drama-production

    为 AI 短剧设计场景和叙事道具母本、光照与状态变体,产出 art.json、Markdown、评审报告和可选设定图。用于美术设定、场景与道具一致性;不代替导演调度或成片人流设计。

    181 GitHub stars~1.3k tokensUpdated 25 days ago
    Media & CreativeAuto-check: notes
  • Image Director

    Jamailar/Beav

    A skill your agent uses when the user wants to做一整套图片、组图、卡片图、轮播图、配图包或电商套图.

    1.8k GitHub stars~3.6k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Draws chart images such as flowcharts, architecture diagrams, ER diagrams and SWOT boards for WeChat official account articles, in one of six visual styles.

    1.6k GitHub stars~1.7k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed

Works with

Questions about Xiaohei Chinese Article Illustrations

What does Xiaohei Chinese Article Illustrations do?

Plans and generates 16:9 hand-drawn illustrations for Chinese articles on a white background, with a recurring black character and a few red, orange and blue handwritten notes. This skill designs and generates widescreen illustrations that sit inside Chinese articles, posts, blog entries and Notion or workflow documents. The aim is not commercial illustration, slide-style infographics or cute cartoons but a clean, quirky hand-drawn diagram that turns one key judgment, process, structure, state or metaphor from the text into a single picture.

When should I use Xiaohei Chinese Article Illustrations?

Xiaohei Chinese Article Illustrations fits situations like: adding hand-drawn illustrations to a Chinese article or blog post; deciding which sections of a long piece need a picture at all; turning a method, workflow or metaphor in a document into one explanatory image; redoing images that came out too crowded or too much like slides.

How do I install Xiaohei Chinese Article Illustrations in Claude Code?

Run `npx skills add helloianneo/ian-xiaohei-illustrations --skill ian-xiaohei-illustrations -a claude-code`. Or copy the skill folder (ian-xiaohei-illustrations in helloianneo/ian-xiaohei-illustrations) into .claude/skills/ian-xiaohei-illustrations in your project. Claude Code loads it when a task matches its description.

How do I install Xiaohei Chinese Article Illustrations in Codex?

Run `npx skills add helloianneo/ian-xiaohei-illustrations --skill ian-xiaohei-illustrations -a codex`. Or copy the skill folder (ian-xiaohei-illustrations in helloianneo/ian-xiaohei-illustrations) into .agents/skills/ian-xiaohei-illustrations in your project. Codex loads it when a task matches its description.

Can I use Xiaohei Chinese Article Illustrations in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add helloianneo/ian-xiaohei-illustrations --skill ian-xiaohei-illustrations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ian-xiaohei-illustrations, .gemini/skills/ian-xiaohei-illustrations, .github/skills/ian-xiaohei-illustrations and .opencode/skills/ian-xiaohei-illustrations in your project.

What does Xiaohei Chinese Article Illustrations need to run?

SKILL.md names no scripts, command-line tools or credentials: Xiaohei Chinese Article Illustrations is instructions for the agent only. Our summary lists: An image generation tool the agent can call, such as image_gen.

Does Xiaohei Chinese Article Illustrations access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Xiaohei Chinese Article Illustrations safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Xiaohei Chinese Article Illustrations use?

Xiaohei Chinese Article Illustrations is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Xiaohei Chinese Article Illustrations use?

About 470 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Xiaohei Chinese Article Illustrations?

Skills that share tags, products or a category with Xiaohei Chinese Article Illustrations: Xhs Visual Director (ziguishian/xhs-visual-director-skill, 1.4k stars), Zy Cinematic Realism (popopo-99/zy-cinematic-realism, 570 stars), Article Illustrator (JimLiu/baoyu-skills, 27k stars) and Novel Art (suihe1/short-drama-production, 181 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xiaohei Chinese Article Illustrations?

helloianneo (a GitHub user) maintains it in helloianneo/ian-xiaohei-illustrations, which has 12,479 GitHub stars. The repository was last updated on September 24, 2026.

Source: helloianneo/ian-xiaohei-illustrations on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.