kdp-generator

Generate Amazon KDP compatible books - both e-books from Markdown and low-content books (journals, planners, log books). Use when the user needs to publish b...

Security Scan

The skill's purpose (generate KDP books) is plausible and many included scripts match that goal, but there are packaging/instruction mismatches and other small inconsistencies you should verify before installing.

Purpose & Capability

The name/description (KDP book generator) matches the code: many scripts generate PDFs, covers, metadata, and batch workflows. Requiring no credentials and no external binaries is reasonable for offline PDF/image generation. However, the SKILL.md example commands reference a scripts/ subdirectory (e.g., scripts/md2epub.py), while the repository manifest lists those Python files at the top level (md2epub.py, generate_cover.py, etc.). That path mismatch is an inconsistency that may break runtime usage or indicate sloppy packaging.

Instruction Scope

SKILL.md's runtime instructions stay within KDP publishing tasks (convert Markdown to EPUB, generate interiors and covers, produce metadata, batch generation). It does instruct the agent to 'use this skill whenever the user mentions KDP...' which is a broad trigger but not in itself malicious. I found no instructions that ask the agent to read unrelated system files or to exfiltrate environment variables. Still, SKILL.md references commands under scripts/ while the supplied files live at project root — the mismatch could cause the agent to attempt to run non-existent paths or to run files in unexpected locations.

Install Mechanism

Registry metadata says 'No install spec — instruction-only skill', but the bundle contains many executable Python files (18 code files + others). Having code included is normal for a generator skill, but calling this 'instruction-only' is inconsistent. There is no download-from-URL or package installer present (lower install risk), but verify how the platform will surface/execute these files because the packaging mismatch could lead to broken runs or unexpected behavior.

Credentials

The skill declares no required environment variables or credentials, which is consistent with offline generation of PDFs and images. SKILL.md suggests using Midjourney/Stable Diffusion prompts for AI cover generation and tells the user to upload to KDP but does not request API keys or credentials. That is proportionate — if you expect the skill to upload to Amazon or call image APIs, it currently has no declared mechanism or env vars to do so (which is safer).

Persistence & Privilege

Flags show always:false and model invocation allowed (normal). The skill does not request persistent privileges or to modify other skills or system-wide configs. Nothing indicates it will force-enable itself or require continuous background presence.

What to consider before installing

This skill appears to do what it says — create KDP-ready interiors, covers, and metadata — and it includes the necessary Python scripts. However: - Packaging mismatch: SKILL.md examples use scripts/ paths but the files in the bundle are at the repository root. Confirm how the platform will run these scripts (will it place them in a 'scripts/' folder or run top-level files?). This mismatch may break the skill or cause the agent to attempt to run unexpected paths. - Review the omitted files: 16 files were truncated in the manifest. Before installing, scan those files for any networking (HTTP requests, sockets), subprocess.invocations, or code that reads environment variables or arbitrary files. None were visible in the excerpts, but the omitted files could contain such behavior. - No credentials requested: The skill does not ask for Amazon or image-service API keys. That is safer, but if you expect the skill to upload to KDP or call Midjourney/Stable Diffusion APIs, you'll need to handle credentials yourself — do not paste secrets into prompts or allow the agent to store them. - Run in a sandbox first: If you install and run this skill, test it in an isolated environment (no sensitive files, no credentials) to validate outputs and to confirm there are no unexpected network calls or side effects. If you want, I can: (1) scan the omitted files for network or credential usage, (2) search the full code for subprocess/network calls, or (3) produce a short checklist of exact lines/patterns to look for before trusting the skill.

Amazon KDP Book Generator

全能KDP出版工具 - 支持电子书转换和低内容书籍批量生产

🚀 Quick Start (6步法)

Step 1: Capture Intent     → 确定是电子书还是低内容书
Step 2: Interview          → 询问书名、页数、风格等需求
Step 3: Initialize         → 选择模板类型 (guided_journal/planner/etc)
Step 4: Edit               → 配置书籍参数
Step 5: Package            → 生成PDF + 封面Prompt + 元数据
Step 6: Iterate            → 用Eval Loop验证效果 ✨

---

功能概览

类型	功能	输出
📖 电子书	Markdown → EPUB	标准电子书
📔 低内容书	内页PDF生成	日记/计划本/工作簿
🎨 封面设计	AI Prompt + 自动生成	Midjourney/即梦提示词
🏷️ 元数据	关键词/分类/定价	JSON配置
🔄 批量生产	多本同时生成	生产清单

---

电子书出版 (E-books)

将 Markdown 书稿转换为 Amazon KDP 兼容的 EPUB 格式。

Quick Start

# 基础转换
python scripts/md2epub.py manuscript.md --title "书名" --author "作者"

# 带封面的完整版
python scripts/md2epub.py manuscript.md \
  --title "书名" \
  --author "作者" \
  --cover cover.jpg

完整流程

1. 准备书稿 (manuscript.md)
2. 生成封面 - scripts/generate_cover.py
3. 转换 EPUB - scripts/md2epub.py
4. 生成元数据 - scripts/generate_metadata.py
5. 上传 KDP

---

低内容书籍出版 (Low-Content Books)

生成日记本、计划本、工作簿等内页PDF，适合规模化量产。

支持的书籍类型

类型	说明	典型页数	状态
guided_journal	引导日记（每日问题）	108页	✅ 完整支持
daily_planner	每日计划本（日程+目标）	120页	✅ 完整支持
gratitude_journal	感恩日记（正念写作）	90页	✅ 完整支持
workbook	练习册（互动内容）	80页	🔄 开发中
log_book	记录本（数据追踪）	100页	🔄 开发中
activity_book	活动书（儿童迷宫/填字）	50页	🔄 开发中
notebook	笔记本（横线/格子/空白）	120页	🔄 开发中

Quick Start

# 单本书籍生成（完整版）
python scripts/create_lowcontent_book.py \
  --title "The Entrepreneur's Daily Journal" \
  --subtitle "A 90-Day Guided Workbook for Building Your Business" \
  --type guided_journal \
  --pages 108 \
  --days 90 \
  --size 6x9 \
  --paper cream \
  --style minimalist \
  --output ./books/

# 批量生成
python scripts/batch_create_books.py --config batch_config.json

输出文件说明

生成完成后，输出目录包含：

output/
└── book_20260315_155625/
    ├── interior.pdf          # ✅ 内页PDF（直接上传KDP）
    ├── cover_prompt.md       # 🎨 AI封面绘画提示词
    ├── metadata.json         # 🏷️ KDP元数据
    └── README.md             # 📖 使用说明

支持的参数

参数	说明	默认值	选项
--title	书名（必填）	-	-
--subtitle	副标题	空	-
--type	书籍类型（必填）	-	guided_journal, daily_planner, gratitude_journal...
--pages	总页数	108	-
--days	天数	90	适用于日记/计划本
--size	尺寸	6x9	6x9, 8.5x11, A5
--paper	纸张颜色	cream	cream, white
--style	封面风格	minimalist	minimalist, watercolor, geometric...
--author	作者名	Luna & Boss	-
--output	输出目录	./output	-

程序化使用

from scripts.kdp_book_factory import KDPBookFactory, BookConfig, BookType
from scripts.pdf_generator import generate_interior_pdf

# 快速生成单本PDF
output_path = generate_interior_pdf(
    title="The Entrepreneur's Daily Journal",
    subtitle="A 90-Day Guided Workbook",
    book_type="guided_journal",
    days=90,
    output_dir="./books/"
)

# 使用工厂模式批量生成
factory = KDPBookFactory()

configs = [
    BookConfig(
        title="Morning Journal",
        subtitle="Start Your Day with Intention",
        book_type=BookType.GUIDED_JOURNAL,
        page_count=108
    ),
    BookConfig(
        title="Gratitude Journal",
        subtitle="Daily Reflections for Joy",
        book_type=BookType.GRATITUDE_JOURNAL,
        page_count=90
    ),
]
results = factory.batch_create(configs)

---

封面设计

自动生成封面图片

# 文字封面（可编辑）
python scripts/generate_cover.py \
  --title "书名" \
  --author "作者" \
  --template modern \
  --output cover.jpg

# 验证封面规格
python scripts/generate_cover.py --validate cover.jpg

KDP封面规格:

• 格式: JPEG/TIFF
• 推荐: 2560×1600 像素 (1.6:1)
• 最小: 1000×625 像素

AI封面Prompt生成

from scripts.kdp_book_factory import KDPBookFactory

factory = KDPBookFactory()
config = BookConfig(title="书名", cover_style="minimalist")

# 自动生成Midjourney Prompt
book = factory.create_book(config)
print(book['cover_prompt']['midjourney'])
# Output: "minimalist book cover, clean lines... --ar 2:3 --v 6"

封面风格选项:

• minimalist - 极简商务
• watercolor - 水彩艺术
• geometric - 几何抽象
• photographic - 摄影写实
• illustration - 插画风格
• 3d_render - 3D渲染

AI Prompt 生成策略（预留裁切去水印）:

由于AI生成图片右下角可能有水印，建议：

1. 生成尺寸: 7"×10.5" (2100×3150px)
2. 裁切到: 6"×9" (1800×2700px)
3. 裁切方式: 上下左右各裁0.5"

---

元数据生成

自动生成KDP所需元数据（标题、关键词、分类、定价建议）。

# 生成元数据
python scripts/generate_metadata.py \
  --title "书名" \
  --type "guided_journal" \
  --output metadata.json

# 查看分类帮助
python scripts/generate_metadata.py --categories-help

输出字段:

• title - 书名
• subtitle - 副标题
• keywords - 7个关键词
• categories - 推荐分类
• price_usd - 建议定价
• description - 书籍描述

---

批量生产

适合规模化出版的流水线模式。

配置文件 (batch_config.json)

{
  "books": [
    {
      "title": "Entrepreneur's Daily Journal",
      "type": "guided_journal",
      "pages": 108,
      "style": "minimalist"
    },
    {
      "title": "Gratitude Journal for Moms",
      "type": "gratitude_journal",
      "pages": 90,
      "style": "watercolor"
    }
  ],
  "output_dir": "./production/"
}

运行批量生产

python scripts/batch_create_books.py --config batch_config.json

输出:

• 每本书的内页PDF
• 每本书的封面Prompt
• 每本书的元数据JSON
• production_list.md - 生产清单

---

🧪 Eval Loop 测试系统

使用 skill-creator 的 Eval Loop 测试本 skill 的效果。

运行评估

# 运行测试
python /usr/lib/node_modules/openclaw/skills/skill-creator/scripts/eval_skill.py \
  ./kdp-generator --test-cases ./kdp-generator/evals.json

# 生成可视化报告
python /usr/lib/node_modules/openclaw/skills/skill-creator/scripts/generate_review.py \
  eval_results.json --format html

当前测试结果

测试用例	With Skill	Without Skill	提升
低内容书生成	✅ 1.5kt	❌ 5kt	3.3x
批量生成	✅ 1.8kt	❌ 6kt	3.3x
AI封面Prompt	✅ 1.2kt	✅ 4kt	3.3x
EPUB转换	✅ 1.2kt	❌ 4kt	3.3x
封面生成	✅ 1kt	✅ 3.5kt	3.5x

平均提升: 3.4x 🎉

测试用例配置 (evals.json)

{
  "test_cases": [
    {
      "name": "低内容书生成 - 引导日记",
      "query": "帮我生成一本创业者日记的内页PDF，108页",
      "assertions": [
        {"type": "contains", "expected": "interior"},
        {"type": "contains", "expected": "guided_journal"}
      ]
    }
  ]
}

---

🔍 Description Optimizer

优化 skill 描述的触发率。

# 运行描述优化
python /usr/lib/node_modules/openclaw/skills/skill-creator/scripts/optimize_description.py \
  ./kdp-generator --iterations 5 --apply

优化目标: 让 Claude 在以下场景准确触发本 skill:

• KDP 出版
• 低内容书籍
• 日记/计划本生成
• 封面设计
• 书籍元数据
• 批量出版

---

完整工作流示例

场景1: 单本低内容书（完整流程）

# 1. 生成完整书籍（内页PDF + 封面Prompt + 元数据）
python scripts/create_lowcontent_book.py \
  --title "90-Day Entrepreneur Journal" \
  --subtitle "A Guided Workbook for Business Success" \
  --type guided_journal \
  --pages 108 \
  --days 90 \
  --size 6x9 \
  --paper cream \
  --style minimalist \
  --output ./output/

# 输出文件：
# - interior.pdf       → 上传到KDP的内页
# - cover_prompt.md    → Midjourney封面提示词
# - metadata.json      → KDP填写信息
# - README.md          → 使用说明

# 2. 用Midjourney生成封面
# 复制cover_prompt.md里的提示词到Midjourney生成封面图

# 3. 登录KDP上传
# - 上传 interior.pdf 作为内页
# - 上传封面图
# - 按metadata.json填写标题/关键词/分类

书籍内页结构说明

guided_journal（引导日记）

页码	内容	说明
1	标题页	书名+副标题+装饰线
2	版权页	ISBN占位+版权声明
3	欢迎页	使用说明+引言
4-5	目标设定页	90天目标规划（2页）
6-95	每日日志	90天×每天4个引导问题
96-107	周复盘	12周×每周5个复盘问题
108	月度总结	5个维度总结

每日引导问题：

1. What are the 3 most important things today?
2. What progress did I make?
3. What will I improve tomorrow?
4. Today's insight:

daily_planner（每日计划本）

页码	内容
1	标题页
2-13	月度概览（12个月）
14-103	每日计划页

每日计划区域：

• Top Priorities（优先事项）
• Schedule（日程安排）
• Tasks（任务清单）
• Notes（备注）

gratitude_journal（感恩日记）

页码	内容
1	标题页
2-91	每日感恩页

每日感恩问题：

1. 3 things I'm grateful for today
2. The best moment of today was
3. I want to thank
4. Tomorrow I look forward to

场景2: 电子书出版

# 1. 准备书稿 manuscript.md

# 2. 生成封面
python scripts/generate_cover.py \
  --title "Python入门" \
  --author "作者" \
  --template modern

# 3. 转换为EPUB
python scripts/md2epub.py manuscript.md \
  --title "Python入门" \
  --author "作者" \
  --cover cover.jpg

# 4. 生成元数据
python scripts/generate_metadata.py \
  --title "Python入门" \
  --author "作者" \
  --categories "technology,programming"

场景3: 批量日更生产

# 每日批量生成3本书
from scripts.kdp_book_factory import KDPBookFactory, BookConfig, BookType

factory = KDPBookFactory()

daily_books = [
    BookConfig("Morning Journal", BookType.GUIDED_JOURNAL, 108),
    BookConfig("Password Keeper", BookType.LOG_BOOK, 100),
    BookConfig("Kids Activity Book", BookType.ACTIVITY_BOOK, 50),
]

results = factory.batch_create(daily_books)
factory.export_production_list("production_list.md")

---

文件结构

output/
├── book_001/
│   ├── interior.pdf       # 内页PDF
│   ├── cover_prompt.md    # AI封面提示词
│   └── metadata.json      # KDP元数据
├── book_002/
│   └── ...
└── production_list.md     # 生产清单

---

KDP上传检查清单

• 内页PDF已生成（正确尺寸）
• 封面图片已准备（2560×1600或AI Prompt）
• 元数据JSON已生成
• 定价已设置（$6.99-$9.99推荐）
• 分类和关键词已选择
• 已预览检查排版
• 已设置版税选项

---

故障排除

中文字体问题

# Ubuntu/Debian
sudo apt-get install fonts-noto-cjk

# macOS
brew install font-noto-sans-cjk-sc

PDF生成失败

pip install reportlab pillow

依赖安装

pip install reportlab pillow ebooklib beautifulsoup4 markdown

---

References

• Amazon KDP 帮助中心
• KDP 封面尺寸指南

---

Version: 3.0 (with Full PDF Generation)
Last Updated: 2026-03-15