Document Illustrator Skill — Development skill for Claude Code

Document Illustrator


基于 AI 智能分析的文档配图生成工具

[](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/)

**Document Illustrator** 是一个 Claude Code Skill，它能智能理解文档内容，自动归纳核心要点，并为每个主题生成专业配图。无需依赖特定文档格式，AI 会理解内容并生成符合你选择风格的高质量图片。

✨ 核心特性

• 🤖 AI 智能归纳：自动理解文档内容，智能提取核心主题，无需依赖标题格式
• 📝 格式无关：支持任何格式的文档（Markdown、纯文本、PDF 等）
• 🎨 三种风格：渐变玻璃卡片、票据风格、矢量插画，满足不同场景需求
• 📐 灵活比例：支持 16:9（横屏）和 3:4（竖屏）两种图片比例
• 🖼️ 封面图可选：可生成概括全文的封面图作为系列配图的引导
• ✅ 内容完整：展示归纳结果供你确认，确保所有重要信息都被包含

🚀 快速开始

使用 npx 安装（推荐）

npx skills add https://github.com/op7418/Document-illustrator-skill

手动安装

1. 克隆或下载本仓库到 Claude Skills 目录：

cd ~/.claude/skills/
git clone https://github.com/op7418/Document-illustrator-skill.git

1. 配置 API 密钥（见下方"配置说明"部分）

2. 安装 Python 依赖（见下方"环境要求"部分）

基本使用

在 Claude Code 中直接告诉 Claude：

帮我为这个文档生成配图：/path/to/document.md

或者：

我想为这篇文章生成一些配图

Claude 会引导你完成整个配图生成流程。

🎨 三种风格说明

1. 渐变玻璃卡片风格 (gradient-glass)

**视觉特点**：

• Apple Keynote 风格的极简主义设计
• 玻璃拟态（Glassmorphism）效果
• 深邃虚空黑或纯净陶瓷白基底
• 流动的极光渐变色
• 3D 玻璃物体和发光效果

**适用场景**：

• 科技产品介绍
• 数据分析报告
• 未来趋势展望
• 产品功能演示

2. 票据风格 (ticket)

**视觉特点**：

• 数字极简票券设计
• 高度对比的黑白配色
• 类似登机牌、门票的结构化布局
• 精确的几何分区
• 中英混排，多向文字布局

**适用场景**：

• 信息图表
• 统计数据展示
• 时间线和流程图
• 要点总结

3. 矢量插画风格 (vector-illustration)

**视觉特点**：

• 扁平化矢量插画
• 统一粗细的黑色轮廓线
• 复古柔和的配色方案
• 几何化处理
• 横向全景式构图

**适用场景**：

• 故事叙述
• 概念解释
• 教育内容
• 品牌宣传

📦 安装和配置

步骤 1: 安装 Skill

**使用 npx（推荐）**：

npx skills add https://github.com/op7418/Document-illustrator-skill

**手动安装**：

cd ~/.claude/skills/
git clone https://github.com/op7418/Document-illustrator-skill.git
cd document-illustrator

步骤 2: 配置 API 密钥

1. 获取 Gemini API 密钥：[Google AI Studio](https:/