ai-image-gen SKILL.md skillA

ai-image-gen from zju-real/easel is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add zju-real/easel/ai-image-gen@git:20261012.0d53744

Pins git:20261012.0d53744 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
zju-real/easel
Path
skills/builtin/ai-image-gen/SKILL.md
Versions recorded
1
Latest version
git:20261012.0d53744, committed Oct 12, 2026
Size
5,169 bytes
Repository stars
3,982
License
Apache-2.0

通用 AI 生图:文生图 / 图生图 / 图像变体。当用户说 AI 生图、AI 画图、文生图、图生图、生成图片、生成配图、图像生成、AI 出图、AI 作图、换图、改图、图像编辑、给我画一张、生成一张图 时使用。支持 OpenAI 兼容 API 与 apimart 异步 API,用户自备 API key。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# ai-image-gen Skill

> 通用 AI 文生图 / 图生图 / 图像变体。用户自备图像生成 API key(OpenAI 兼容 或 apimart 异步),产物写入 `outputs/`。

调用共享脚本 `skills/shared/scripts/ai_image.py`(纯标准库,无第三方依赖)。
本 SKILL 不索要、不回显、不写入、不提交任何真实 API key —— key 只存在于用户自己的 `.env`。

## 边界(和相邻 SKILL 区分)

- **ai-image-gen(本 SKILL)**:通用 AI 生图,任意题材,文生图 / 图生图 / 变体。
- **ecom-details-image**:电商详情页 / 商品主图专用出图(25 场景模板、PDP 序列)。要做电商商品图走它。
- **card-\* / poster-\***:HTML+CSS 渲染截图(金句卡、小红书卡、海报),**非 AI 生成**,是确定性设计出图。
- **image-editing**:已有图片的确定性处理(改尺寸/裁剪/加水印/压缩),不生成新画面。

## 配置(执行前必读)

> **配置检查路径铁律**:先 `cd` 到运行时说明给出的 Easel 项目根,确认当前目录有 `.env` 和 `skills/shared/scripts/ai_image.py`,再运行下列命令。不得在任何执行引擎的 workspace 或共享脚本副本中检查,也不得用 `env` / `printenv` 代替读取项目 `.env`;否则会把已配置的 `IMG_BASE_URL`/Key 误判为缺失。

需在项目根目录 `.env` 中设置三项(脚本从当前目录向上自动查找 `.env`):

| 变量 | 说明 | 兼容别名 |
|---|---|---|
| `IMG_BASE_URL` | API 根地址 | `OPENAI_BASE_URL` / `OPENAI_API_BASE` / `BASE_URL` |
| `IMG_MODEL` | 图片模型名 | `OPENAI_IMAGE_MODEL` / `IMAGE_MODEL` / `OPENAI_MODEL` |
| `IMG_API_KEY` | API key | `OPENAI_API_KEY` / `API_KEY` |

支持两类服务,脚本按 `base_url` 自动检测(也可 `--mode sync|async` 强制):

- **OpenAI 兼容(同步)**:`base_url` 不含 apimart。走 `/images/generations`、`/images/edits`、`/images/variations`。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zju-real/easel/ai-image-gen@sha256:14d9118638de23dd

The line at the top of this page pins the label git:20261012.0d53744, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_eiorglwhbu7nvl6f.svg)](https://markdownregistry.com/a/art_eiorglwhbu7nvl6f)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 12, 2026.

versioncommittedcommitsizeaudit
git:20261012.0d53744 latest2026-10-12 0d53744 5,169 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5169 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

zju-real/easel · 3,982 stars · license Apache-2.0 · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_eiorglwhbu7nvl6f
GET https://markdownregistry.com/api/v1/resolve?ref=zju-real/easel/ai-image-gen
GET https://markdownregistry.com/api/v1/blob/14d9118638de23ddd3609f53b50670f591161b281fffac2a90a30af4175b3e95

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from zju-real/easel

AGENTS.md@agents/workspace AGENTS.md file
zju-real/easel · agents/workspace/AGENTS.md
git:20261012.0d53744 · audit B · 3,982 stars
ai-music SKILL.md skill
zju-real/easel · skills/builtin/ai-music/SKILL.md · AI 音乐 / BGM 生成:给短视频、社媒内容生成原创背景音乐 / 配乐 / 纯音乐。通过可插拔 provider(阿里 DashScope / Suno 类第三方…
git:20261012.0d53744 · audit A · 3,982 stars
ai-video-gen SKILL.md skill
zju-real/easel · skills/builtin/ai-video-gen/SKILL.md · AI 视频生成:文生视频 / 图生视频 / 数字人首帧驱动。通过可插拔 provider(通义万相 Wan / 火山 Seedance / 快手可灵 / OpenAI 兼容)异步生成视频,用户自备 API key。当用户说 AI…
git:20261012.0d53744 · audit A · 3,982 stars
asset-manager SKILL.md skill
zju-real/easel · skills/builtin/asset-manager/SKILL.md · outputs/ 目录下的产物管理:按日期/平台/类型归档、打标签、搜索历史内容、生成素材清单。 当用户说"整理素材"、"归档"、"找之前的内容"、"搜索历史"、"素材管理"、 "outputs 整理"、"之前做的"时使用。 与其他…
git:20261012.0d53744 · audit A · 3,982 stars
audio-denoise SKILL.md skill
zju-real/easel · skills/builtin/audio-denoise/SKILL.md · 音频降噪:去除录音中的背景噪声、电流声、风噪、嗡嗡声,基于 ffmpeg 滤镜链(afftdn/highpass/lowpass)。 当用户说"降噪""去噪""去杂音""消除背景噪声""电流声""风噪""录音有杂音""音频降噪"时使用。…
git:20261012.0d53744 · audit A · 3,982 stars
audio-editing SKILL.md skill
zju-real/easel · skills/builtin/audio-editing/SKILL.md · 通用音频处理:音频剪辑/裁剪、格式转码(mp3/wav/m4a/aac)、音量归一化、从视频提取音轨、多段拼接、淡入淡出、变速(保音高)。当用户说“剪音频”“裁一段”“转成…
git:20261012.0d53744 · audit A · 3,982 stars
audio-mix SKILL.md skill
zju-real/easel · skills/builtin/audio-mix/SKILL.md · 音频混合 / 混音:把旁白口播 + 背景音乐 + 音效混成一轨,BGM 自动循环补足并可闪避(旁白说话时自动压低 BGM 保证人声清晰)。当用户说 混音、音频混合、旁白加背景音乐、配音加BGM、人声和音乐混一起、加音效、音频叠加、BGM…
git:20261012.0d53744 · audit A · 3,982 stars
audio-visualizer SKILL.md skill
zju-real/easel · skills/builtin/audio-visualizer/SKILL.md · 音频可视化视频:把纯音频(播客片段、音乐、口播金句、电台)渲染成带动态波形/频谱的视频,配封面和标题,好发到抖音/B站/视频号等只收视频的平台。当用户说…
git:20261012.0d53744 · audit A · 3,982 stars
auto-short-video SKILL.md skill
zju-real/easel · skills/builtin/auto-short-video/SKILL.md · 一句话主题 → 成品短视频:自动串联 文案→配图/AI视频→配音→字幕→BGM→合成,把 Easel 制作层零件编排成一条'一键出片'流水线。**单条视频、口播/资讯向,画面默认逐句配图 + Ken Burns…
git:20261012.0d53744 · audit A · 3,982 stars
auto-subtitle SKILL.md skill
zju-real/easel · skills/builtin/auto-subtitle/SKILL.md · 自动字幕 / 语音转字幕:把音频或视频里的语音识别成字幕文件(SRT/ASS/TXT/JSON),可选把字幕烧录进视频。当用户说自动字幕、语音转字幕、视频加字幕、上字幕、转录、听写、字幕文件、生成字幕、烧字幕时使用。
git:20261012.0d53744 · audit A · 3,982 stars
batch-process SKILL.md skill
zju-real/easel · skills/builtin/batch-process/SKILL.md · 批量处理:对一个目录里的一批图片/视频/音频统一套用同一操作——批量压缩、加水印、转格式、缩放、转比例、音量归一化等。当用户说 批量处理、批量压缩、批量加水印、批量转格式、一批图片/视频、给这个文件夹、全部转成、批量缩放、批量转竖版、整个目…
git:20261012.0d53744 · audit A · 3,982 stars
beat-sync-video SKILL.md skill
zju-real/easel · skills/builtin/beat-sync-video/SKILL.md · 音乐卡点视频 / 踩点视频:检测背景音乐的节拍,让图片或片段在节拍点上切换,配推进/白闪特效,做出燃系'卡点'短视频。当用户说 卡点视频、踩点视频、音乐卡点、节奏卡点、按音乐切换、鼓点视频、踩节奏、beat 卡点、图片卡点、卡点混剪…
git:20261012.0d53744 · audit A · 3,982 stars

Every file in zju-real/easel

Browse by kind, by grade A, or by owner.