← Back to Skills Marketplace
article-images-gen
by
Alex Redisread
· GitHub ↗
· v1.0.2
· MIT-0
205
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install article-images-gen
Description
文案插图专家，为文章生成手绘风格插图。风格：手绘、简约、整洁、留白、构图平衡、色调统一。Use when user asks to generate illustrations for articles, "为文章配图", "生成插图", or needs hand-drawn style images for...
README (SKILL.md)
Article Images Generator (文案插图专家)
专为文章生成手绘风格插图，使用阿里百炼 DashScope Qwen-Image API。
调用脚本
# 为文章生成配图（全自动：分析 → 生成大纲 → 生成提示词 → 生成图片 → 插入文章）
bun scripts/illustrator.ts path/to/article.md [--density \x3Clevel>] [--output-dir \x3Cpath>]
# 单张图片（直接 prompt）
bun scripts/main.ts --prompt "your prompt" [--image output.png]
# 批量 prompt 文件
bun scripts/main.ts --promptfiles prompt1.md,prompt2.md
密度选项：minimal (1-2张) | balanced (3-4张) | per-section（推荐）| rich (5+张)
工作流程
- 分析文案：识别章节结构、核心论点、适合插图的位置
- 分析判断：AI 根据文章章节数量和内容自动选择密度（默认 per-section）
- 生成大纲：保存
{outputDir}/outline.md - 生成提示词：保存
{outputDir}/prompts/NN-hand-drawn-{slug}.md - 生成图片：调用 DashScope API，保存到
{outputDir}/ - 更新文章：在对应章节后插入图片引用
环境要求
- 运行时：bun (
bun run/bunx) - API Key：
DASHSCOPE_API_KEY环境变量
输出目录
固定输出到 /tmp/imageGen/{YYYYMMDD}/{articleName}/，例如：
/tmp/imageGen/20260410/my-article/01-hand-drawn-concept.png
articleName 取文章文件名（不含扩展名），日期取当天日期。
Usage Guidance
Before installing or running: (1) Understand that the scripts will send generated prompts (which include extracted terms from your article) to DashScope's API — your article content will leave your machine. Only provide DASHSCOPE_API_KEY if you trust that service. (2) Ensure you have bun installed; the manifest metadata currently omits this requirement. (3) The tool will modify your article in-place and creates a .bak timestamped backup — test on a copy first. (4) Verify the expected DASHSCOPE_BASE_URL if you use a non-standard endpoint. (5) Prefer to inspect the repository origin (homepage/source unknown) and vet the API endpoint before providing credentials. If you are uncomfortable with automatic uploads or in-place edits, do not run the illustrator script or run it on a local copy instead.
Capability Analysis
Type: OpenClaw Skill
Name: article-images-gen
Version: 1.0.2
The skill bundle is a legitimate tool designed to generate hand-drawn illustrations for articles using the AliCloud DashScope (Qwen-Image) API. The code in `scripts/illustrator.ts` and `scripts/article-analyzer.ts` performs article structure analysis, generates image prompts based on section headings, and updates the original Markdown file with image references after creating a backup. No evidence of data exfiltration, unauthorized execution, or malicious prompt injection was found; the file system and network operations are strictly aligned with the stated purpose of image generation and article modification.
Capability Assessment
Purpose & Capability
The skill claims to be an article illustration generator and the code implements that using DashScope (Qwen-Image). However the registry/manifest metadata says 'required binaries: none' and 'required env vars: none', while SKILL.md and the code require the bun runtime and the DASHSCOPE_API_KEY (and optionally DASHSCOPE_BASE_URL). This metadata omission is an inconsistency that could mislead users about what secrets and tooling are needed.
Instruction Scope
Runtime instructions and scripts analyze the article file, build prompts that include extracted article terms, call the DashScope image-generation API with those prompts, download images, and then modify the original article (creating a timestamped .bak). Sending article-derived text to the external API and automatically editing the article are expected for this purpose, but are important side effects the user should be aware of.
Install Mechanism
There is no install spec and the skill is instruction+script based (invoked via bun). No external downloads or extract steps are used, so nothing arbitrary is written to disk beyond the script's normal output.
Credentials
The code requires DASHSCOPE_API_KEY (and optionally DASHSCOPE_BASE_URL) and expects the bun runtime, but the registry metadata does not declare these. Requesting an API key for the external DashScope service is proportionate to the stated purpose, but the omission from declared requirements is a red flag — it makes it easy to miss that your article text will be sent to an external service and that you must provide credentials.
Persistence & Privilege
The skill is not marked always:true and does not request elevated platform privileges, which is good. It does modify user files (writes backups and overwrites the article with image references) and writes output under /tmp/imageGen/{date}/{articleName}/; these are expected behaviors but the automatic in-place edits are a persistent change the user should review.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install article-images-gen - After installation, invoke the skill by name or use
/article-images-gen - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Simplified workflow and documentation for easier usage.
- Now automatically saves all outputs to `/tmp/imageGen/{YYYYMMDD}/{articleName}/`.
- Updated instructions for running scripts using bun and new parameters.
- Script auto-selects illustration density based on article content (default: per-section).
- Environment setup clarified: requires bun runtime and `DASHSCOPE_API_KEY`.
v1.0.1
No file or documentation changes detected in this version.
- No visible updates; contents remain identical to the previous release.
v1.0.0
Initial release of Article Images Generator.
- Generates hand-drawn style illustrations for articles with a focus on minimalism, balance, and unified colors.
- Supports automatic analysis of content to determine optimal illustration positions and density.
- Integrates with 阿里百炼 DashScope Qwen-Image for image generation.
- Includes API retry logic for rate limiting and Chinese filename support (pinyin slug).
- Step-by-step workflow: analyze article, confirm density, build outline, generate prompts and images, and update article with illustrations.
Metadata
Frequently Asked Questions
What is article-images-gen?
文案插图专家，为文章生成手绘风格插图。风格：手绘、简约、整洁、留白、构图平衡、色调统一。Use when user asks to generate illustrations for articles, "为文章配图", "生成插图", or needs hand-drawn style images for... It is an AI Agent Skill for Claude Code / OpenClaw, with 205 downloads so far.
How do I install article-images-gen?
Run "/install article-images-gen" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is article-images-gen free?
Yes, article-images-gen is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does article-images-gen support?
article-images-gen is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created article-images-gen?
It is built and maintained by Alex Redisread (@redisread); the current version is v1.0.2.
More Skills