etsy-listing-generator
Generate Etsy listing images from HTML templates using Playwright. Supports single and batch rendering with customizable title, subtitle, badge text, and product images. Use when creating Etsy product listing images, mockups, or running batch generation for multiple products (e.g., puppet printables, digital downloads). Works with any HTML template that uses PRODUCT_IMAGE_URL, TITLE_TEXT, SUBTITLE_TEXT, BADGE_LEFT_TEXT placeholders.
How do I install this agent skill?
npx skills add https://github.com/mmcmedia/openclaw-agents --skill etsy-listing-generatorIs this agent skill safe to install?
- Gen Agent Trust Hubfail
The skill is vulnerable to Indirect Prompt Injection and local file exposure. It renders user-provided HTML templates and strings using Playwright without sanitization, creating a Cross-Site Scripting (XSS) surface within the rendering engine. Furthermore, the skill's explicit support for 'file://' URLs and local file system paths poses a high risk of sensitive data exposure and arbitrary file read.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · No issues
- Runlayerwarn
7/7 files flagged
What does this agent skill do?
Etsy Listing Image Generator
Generate professional Etsy listing images from HTML templates via Playwright screenshot rendering.
Quick Start — Single Image
node scripts/render.mjs <template> <image-url> <title> <subtitle> <badge> <output>
Example:
node scripts/render.mjs \
assets/puppet-listing.html \
"http://localhost:3021/api/output/moses-characters.png" \
"Bible Story Puppet Printables" \
"Moses & The Exodus" \
"12 ELEMENTS + 4 BACKGROUNDS" \
output/moses-listing.png
Quick Start — Batch
Create a JSON file with an array of objects:
[
{ "file": "http://localhost:3021/api/output/moses-characters.png", "subtitle": "Moses & The Exodus" },
{ "file": "http://localhost:3021/api/output/david-characters.png", "subtitle": "David & Goliath" }
]
Run:
node scripts/render.mjs --batch assets/puppet-listing.html stories.json output/listings/
Batch JSON Fields
| Field | Required | Default | Description |
|---|---|---|---|
file / image / url | Yes | — | Product image URL (HTTP or file://) |
title | No | "Bible Story Puppet Printables" | Large top text on banner |
subtitle / name | No | — | Smaller bottom text on banner |
badge | No | "12 ELEMENTS + 4 BACKGROUNDS" | Left badge text |
output | No | Auto from subtitle | Output filename |
Template Placeholders
Templates are plain HTML files. The renderer replaces these strings:
PRODUCT_IMAGE_URL→ product/character imageTITLE_TEXT→ large banner textSUBTITLE_TEXT→ smaller banner textBADGE_LEFT_TEXT→ left pill badgeINSTANT DOWNLOAD→ right badge (hardcoded, edit HTML to change)
Template Design — Current Base (puppet-listing.html)
- 1400×2000px portrait format
- White background, sage green (#4D6840) bottom banner
- Gold pill badges (top-left: custom, top-right: INSTANT DOWNLOAD)
- Poppins font throughout
- Product image uses
object-fit: cover; object-position: center center - Subtle TheSunDaisy watermark
Creating New Templates
Copy assets/puppet-listing.html and modify. Key CSS to adjust:
.canvaswidth/height — canvas dimensions.bannerheight — green section size.product-areatop/bottom — image boundaries.badgestyling — pill badge appearance.title/.subtitle— typography
Keep the placeholder strings (PRODUCT_IMAGE_URL, etc.) for the renderer to replace.
Serving Local Images
If product images are local files, either:
- Serve via Image Forge backend: copy to
/projects/image-forge/output/→ accessible athttp://localhost:3021/api/output/filename.png - Use
file://URLs (must be absolute paths) - Start any local HTTP server in the image directory
Dependencies
- Node.js
- Playwright (
npx playwright install chromiumif not installed)
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/mmcmedia/openclaw-agents/etsy-listing-generator">View etsy-listing-generator on skillZs</a>