Agent skill

Article Illustration Batch Generator

by SpaceZephyr in SpaceZephyr/design-buddy

Splits a Markdown article by heading, drafts an image prompt for each section, then generates diagrams with the Gemini API and embeds them in the note.

No licenceAuto-check passedMedia & Creative

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

Install Article Illustration Batch Generator

skills CLI
$ npx skills add SpaceZephyr/design-buddy --skill space-ai-article-illustration -a claude-code

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

GitHub CLI
$ gh skill install SpaceZephyr/design-buddy space-ai-article-illustration --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/SpaceZephyr/design-buddy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/space-ai-article-illustration .claude/skills/space-ai-article-illustration && 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
space-ai-article-illustration
GitHub stars
176
Token cost
~1k tokens
SKILL.md length
271 words
Files
5 (incl. scripts, references)
Skills in repo
16
Repo updated
First seen
Licence
None found

At a glance

Splits a Markdown article by heading, drafts an image prompt for each section, then generates diagrams with the Gemini API and embeds them in the note.

  • Works in 9 steps: 分析文章 → 生成提示词 → 生成图片 → 插入文档 → 文章结构分析 → …
  • Adding diagrams or concept art to every section of a long Markdown article
  • SKILL.md covers 工作流程, Phase 1 详细指引, Phase 2 详细指引 and API 配置, plus 2 more sections
  • Runs Python scripts from its folder; calls python3; reaches api.labnana.com and generativelanguage.googleapis.com; needs REMOVED_GEMINI_KEY and GEMINI_API_KEY

What it does

Written in Chinese, this skill reads a Markdown article, splits it at H2 and H3 headings, skips frontmatter, quotes and footnotes, and records each section's title, one-sentence main point and a few key concepts. It then builds a global style block from references/style-guide.md, defaulting to a minimal hand-drawn look with an architectural blueprint editorial style as the alternative, and writes one image prompt per section covering the diagram type, its content and short Chinese labels.

Nothing is generated until you confirm the prompt list. After approval the skill runs scripts/generate_image.py once per image, pauses a few seconds between calls to avoid rate limits, reports any failures at the end, and saves the files into a dated, topic-named folder inside an Obsidian vault's image directory. It finishes by inserting an Obsidian embed link under each section heading. Text inside the images defaults to Simplified Chinese, with technical terms such as AI and API allowed in English.

When your agent uses it

  • Adding diagrams or concept art to every section of a long Markdown article
  • Preparing illustrated notes in an Obsidian vault
  • Choosing between hand-drawn and blueprint styles for article visuals

Example prompts

  • “Generate illustrations for each section of my article in notes/ai-workflow.md.”
  • “Add blueprint-style images to the open article and show me the prompts first.”
  • “Illustrate this post in the minimal hand-drawn style and embed the images in the note.”

Requirements

  • Python 3 to run the image script
  • Gemini API access for image generation
  • An Obsidian vault with an image folder

Workflow steps

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

  1. 分析文章 → 生成提示词
  2. 生成图片 → 插入文档
  3. 文章结构分析
  4. 生成全局风格指令
  5. 为每个段落生成提示词
  6. 等待确认
  7. 调用 API 生成图片
  8. 保存路径规范
  9. 插入文档

What it can do on your machine

Read from SKILL.md and the folder at commit f1d835f. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.labnana.com
    • generativelanguage.googleapis.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • REMOVED_GEMINI_KEY
    • GEMINI_API_KEY

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

Context cost

Article Illustration Batch Generator loads about 1k tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 40 tokens; SKILL.md has 271 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 271 words (~1,034 tokens).

“分析 Markdown 文章结构,为每个段落/小节生成配图提示词,调用 Gemini API 批量生成图片并插入文档。”

— opening of SKILL.md by SpaceZephyr
name
space-ai-article-illustration

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (scripts, references) in space-ai-article-illustration of SpaceZephyr/design-buddy.

  • SKILL.md
  • .labnana.env.example
  • agents/openai.yaml
  • references/style-guide.md
  • scripts/generate_image.py

Open the folder on GitHubat commit f1d835f

Compare with similar skills

Article Illustration Batch Generator 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.

Article Illustration Batch Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Article Illustration Batch Generator this skillSpaceZephyr/design-buddy176—~1kAutomated safety check: PassNone
Nanobanana Skillfeiskyer/claude-code-settings1.7k—~1.1kAutomated safety check: PassMIT
Document ConverterBlackBeltTechnology/pi-agent-dashboard315—~999Automated safety check: PassMIT
Imagensanjay3290/ai-skills4326 repos~657Automated safety check: PassApache-2.0
Nano Bananakkoppenhaver/cc-nano-banana3781 repos~1.4kAutomated safety check: PassMIT
FigureMuuuun/luxas1.2k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Nanobanana Skill

    feiskyer/claude-code-settings

    Generate or edit images via Google Gemini (nanobanana). An agent skill from feiskyer/claude-code-settings.

    1.7k GitHub stars~1.1k tokensUpdated 13 days ago
    Media & CreativeAuto-check passed
  • Document Converter

    BlackBeltTechnology/pi-agent-dashboard

    Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC…

    315 GitHub stars~999 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Imagen

    sanjay3290/ai-skills

    Generate images using Google Gemini's image generation capabilities.

    432 GitHub starsUsed in 6 repos~657 tokens
    Media & CreativeAuto-check passed
  • Nano Banana

    kkoppenhaver/cc-nano-banana

    REQUIRED for all image generation requests. An agent skill from kkoppenhaver/cc-nano-banana.

    378 GitHub starsUsed in 1 repo~1.4k tokens
    Media & CreativeAuto-check passed
  • Figure

    Muuuun/luxas

    Hybrid figure pipeline (Nano Banana raster + rembg background removal + TikZ vector assembly).

    1.2k GitHub stars~1.2k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Forge Media Route Layer

    0x0funky/agent-sprite-forge

    Generates an image or an image-to-video clip through a configured provider API or a signed-in Codex or Grok CLI, and reports the route, file, hash and cost estimate.

    4.4k GitHub stars~2.2k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed

More from SpaceZephyr/design-buddy

All 16 skills in this repo
  • Slide Deck Image Generator

    SpaceZephyr/design-buddy

    Turns written content into designed slide images from an outline, merges them into PPTX or PDF, and can borrow styles from a registry of brand design systems.

    176 GitHub stars~6.5k tokensUpdated 3 mo ago
    Auto-check passed
  • WeChat Article Layout

    SpaceZephyr/design-buddy

    Turns an article into WeChat Official Account HTML with a local preview, a choice of three visual styles and a button that copies the rich HTML.

    176 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed
  • AI Chart Image Generator

    SpaceZephyr/design-buddy

    Generates a finished chart image directly with GPT-image-2 from a text description, across ten chart types such as flowcharts, architecture diagrams and SWOT grids in six visual styles.

    176 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Batch Image Skill Builder

    SpaceZephyr/design-buddy

    Walks a non-coder through structured questions about scene, style, color, text rules and consistency, then auto-generates a complete, ready-to-use batch image-generation skill.

    176 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Space Image Studio

    SpaceZephyr/design-buddy

    Generates PNG images for four common needs: Xiaohongshu covers, slide illustrations, charts and article logic diagrams, with twelve visual styles and automatic style suggestions.

    176 GitHub stars~2k tokensUpdated 3 mo ago
    Auto-check passed
  • Batch Logo Generator

    SpaceZephyr/design-buddy

    Generates ten logo variants in one run from a brand description or an uploaded reference image, with seven style options, using the Gemini image API and saving files to an Obsidian folder.

    176 GitHub stars~870 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Article Illustration Batch Generator

What does Article Illustration Batch Generator do?

Splits a Markdown article by heading, drafts an image prompt for each section, then generates diagrams with the Gemini API and embeds them in the note. Written in Chinese, this skill reads a Markdown article, splits it at H2 and H3 headings, skips frontmatter, quotes and footnotes, and records each section's title, one-sentence main point and a few key concepts.md, defaulting to a minimal hand-drawn look with an architectural blueprint editorial style as the alternative, and writes one image prompt per section covering the diagram type, its content and short Chinese labels.

When should I use Article Illustration Batch Generator?

Article Illustration Batch Generator fits situations like: adding diagrams or concept art to every section of a long Markdown article; preparing illustrated notes in an Obsidian vault; choosing between hand-drawn and blueprint styles for article visuals.

How do I install Article Illustration Batch Generator in Claude Code?

Run `npx skills add SpaceZephyr/design-buddy --skill space-ai-article-illustration -a claude-code`. Or copy the skill folder (space-ai-article-illustration in SpaceZephyr/design-buddy) into .claude/skills/space-ai-article-illustration in your project. Claude Code loads it when a task matches its description.

How do I install Article Illustration Batch Generator in Codex?

Run `npx skills add SpaceZephyr/design-buddy --skill space-ai-article-illustration -a codex`. Or copy the skill folder (space-ai-article-illustration in SpaceZephyr/design-buddy) into .agents/skills/space-ai-article-illustration in your project. Codex loads it when a task matches its description.

Can I use Article Illustration Batch Generator 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 SpaceZephyr/design-buddy --skill space-ai-article-illustration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/space-ai-article-illustration, .gemini/skills/space-ai-article-illustration, .github/skills/space-ai-article-illustration and .opencode/skills/space-ai-article-illustration in your project.

What does Article Illustration Batch Generator need to run?

Going by SKILL.md and its folder, Article Illustration Batch Generator needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named REMOVED_GEMINI_KEY and GEMINI_API_KEY. Our summary lists: Python 3 to run the image script; Gemini API access for image generation; An Obsidian vault with an image folder.

Does Article Illustration Batch Generator access the network?

SKILL.md names 2 domains. In commands or code: api.labnana.com and generativelanguage.googleapis.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Article Illustration Batch Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Article Illustration Batch Generator use?

No licence was found for Article Illustration Batch Generator or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Article Illustration Batch Generator use?

About 1k tokens (SKILL.md is roughly 4.1k 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 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Article Illustration Batch Generator?

Skills that share tags, products or a category with Article Illustration Batch Generator: Nanobanana Skill (feiskyer/claude-code-settings, 1.7k stars), Document Converter (BlackBeltTechnology/pi-agent-dashboard, 315 stars), Imagen (sanjay3290/ai-skills, 432 stars) and Nano Banana (kkoppenhaver/cc-nano-banana, 378 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Article Illustration Batch Generator?

SpaceZephyr (a GitHub user) maintains it in SpaceZephyr/design-buddy, which has 176 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on July 6, 2026.

Source: SpaceZephyr/design-buddy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.