smart-illustrator
by axtonliu
AI-powered article illustrations with intelligent position detection and cover learning system. Claude Code Skill.
103stars
15forks
TypeScript
Added 2/7/2026
API IntegrationSKILL.mdai-illustrationbest-effortclaude-codeclaude-skills
Installation
# Add to your Claude Code skills
git clone https://github.com/axtonliu/smart-illustratorSKILL.md
name: smart-illustrator
description: 智能配图与 PPT 信息图生成器。支持三种模式：(1) 文章配图模式 - 分析文章内容，生成插图；(2) PPT/Slides 模式 - 生成批量信息图；(3) Cover 模式 - 生成封面图。所有模式默认生成图片，--prompt-only 只输出 prompt。触发词：配图、插图、PPT、slides、封面图、thumbnail、cover。
Smart Illustrator - 智能配图与 PPT 生成器
⛔ 强制规则（违反即失败）
规则 1：用户提供的文件 = 要处理的文章
/smart-illustrator SKILL_05.md → SKILL_05.md 是文章，为它配图
/smart-illustrator README.md → README.md 是文章，为它配图
/smart-illustrator whatever.md → whatever.md 是文章，为它配图
无论文件名叫什么，都是要配图的文章，不是 Skill 配置。
规则 2：必须读取 style 文件
生成任何图片 prompt 前，必须读取对应的 style 文件：
| 模式 | 必须读取的文件 |
|------|---------------|
| 文章配图（默认） | styles/style-light.md |
| Cover 封面图 | styles/style-cover.md |
| --style dark | styles/style-dark.md |
禁止自己编写 System Prompt。
❌ 错误："你是一个专业的信息图设计师..."（自己编的）
✅ 正确：从 style 文件的代码块中提取 System Prompt
使用方式
文章配图模式（默认）
/smart-illustrator path/to/article.md
/smart-illustrator path/to/article.md --prompt-only # 只输出 prompt
/smart-illustrator path/to/article.md --style dark # 深色风格
/smart-illustrator path/to/article.md --no-cover # 不生成封面图
PPT/Slides 模式
# 默认：直接生成图片
/smart-illustrator path/to/script.md --mode slides
# 只输出 JSON prompt（不调用 API）
/smart-illustrator path/to/script.md --mode slides --prompt-only
默认行为：调用 Gemini API 生成批量信息图。
--prompt-only：输出 JSON prompt 并自动复制到剪贴板，可直接粘贴到 Gemini Web 手动生成。
PPT JSON 格式（--prompt-only 时输出）：
{
"instruction": "请逐条生成以下 N 张独立信息图。",
"batch_rules": { "total": "N", "one_item_one_image": true, "aspect_ratio": "16:9" },
"style": "[从 styles/style-light.md 读取完整内容]",
"pictures": [
{ "id": 1, "topic": "封面", "content": "系列名称\n\n第N节：标题" },
{ "id": 2, "topic": "主题", "content": "原始内容" }
]
}
Cover 模式
/smart-illustrator path/to/article.md --mode cover --platform youtube
/smart-illustrator --mode cover --platform youtube --topic "Claude 4 深度评测"
Smart Illustrator
Intelligent article illustration Skill for Claude Code with dual-engine system: automatically selects Mermaid (for structured diagrams) or Gemini (for creative visuals) based on content type.
Status
Status: Experimental
- This is a public prototype that works for my demos, but does not yet cover all input scales and edge cases.
- Output quality varies based on model version and input structure; results may fluctuate.
- My primary focus is demonstrating how tools and systems work together, not maintaining this codebase.
- If you encounter issues, please submit a reproducible case (input + output file + steps to reproduce).
Why Smart Illustrator?
Creating illustrations for articles is time-consuming: manual design takes hours, stock photos lack context, and generic AI tools don't understand article structure. Smart Illustrator combines intelligent position detection, dual-engine system (Mermaid + Gemini), and cover learning to generate contextual illustrations in minutes.
Who it's for: Newsletter writers, YouTube creators, technical bloggers, course instructors.
When to use: When you need high-quality illustrations for articles, YouTube thumbnails with best practices, or consistent visual style across content series.