← 返回 Skills 市场

AgentGen — HTML to PDF & Image

Name: AgentGen — HTML to PDF & Image
Author: lyair1

作者 Yair levi · GitHub ↗ · v1.0.0

cross-platform ⚠ suspicious

411

总下载

当前安装

版本数

在 OpenClaw 中安装

/install agentgen

功能描述

Generate PDFs and images from HTML. No sign-up required — the free tier works out of the box (1 req/min, small watermark). For higher volume and no watermark...

使用说明 (SKILL.md)

AgentGen — HTML → PDF & Image

Convert any HTML to a PDF or screenshot image via the AgentGen API.

Free tier — no sign-up required

The /v1/generate/image and /v1/generate/pdf endpoints work without an API key. Just omit the X-API-Key header.

Limits:

1 request per 60 seconds per IP (returns 429 if exceeded)
Single-page PDFs only
A small agent-gen.com watermark is added to all output

# Free tier — generate an image (no API key)
agentgen image --html "\x3Ch1>Hello\x3C/h1>" --output hello.png

# Free tier — generate a PDF (no API key)
agentgen pdf --html "\x3Ch1>Invoice\x3C/h1>" --output invoice.pdf

Simply omit AGENTGEN_API_KEY and the CLI uses the free tier automatically.

Authenticated tier — no watermark, no rate limit

Set your API key to use the full API. New accounts at agent-gen.com include free tokens — no credit card required to get started.

export AGENTGEN_API_KEY=your_key_here

Check your balance:

agentgen balance

If you run out, the CLI prints your current balance, the amount required, and a direct link to buy more tokens.

Generate an image (1 token authenticated / free with watermark)

# From a file
agentgen image --file page.html --output screenshot.png

# Custom viewport
agentgen image --file page.html --width 1200 --height 630 --output og.png

# JPEG at 2× scale
agentgen image --file page.html --format jpeg --scale 2 --output hero.jpg

Formats: png (default), jpeg, webp Default viewport: 1200 × 630 px

Generate a PDF (2 tokens/page authenticated / free single-page with watermark)

# Single page from a file
agentgen pdf --file report.html --output report.pdf

# With paper format and margins
agentgen pdf --file report.html \
  --format A4 \
  --margin-top 20mm --margin-bottom 20mm \
  --margin-left 15mm --margin-right 15mm \
  --print-background \
  --output report.pdf

# Multi-page (requires API key)
agentgen pdf --pages cover.html chapter1.html chapter2.html --output book.pdf

# Landscape
agentgen pdf --file slide.html --landscape --output slide.pdf

Paper formats: A4 (default), Letter, A3, Legal

Upload a temp file (free, authenticated only)

Upload images, fonts, or other assets and reference them by URL inside your HTML. Files are publicly accessible for 24 hours.

agentgen upload logo.png
# Returns a URL — use it in your HTML as \x3Cimg src="...">

Max file size: 10 MB

Typical workflow

Build HTML with all styles inlined
Upload any local assets with agentgen upload and replace src/href values with the returned URLs
Run agentgen pdf or agentgen image with --output to save locally, or use the returned URL directly

Tips for good output

Inline all CSS — use \x3Cstyle> blocks or style="" attributes. No access to local stylesheets.
Use absolute URLs for images and fonts, or upload them first with agentgen upload.
For PDFs, use --print-background if your design has colored backgrounds or background images.
For retina-quality images, use --scale 2.
For OG images, use --width 1200 --height 630.

安全使用建议

This skill appears to do what it says: it runs the 'agentgen' CLI which sends your HTML to agent-gen.com to produce PDFs or images. Before installing: (1) confirm the Homebrew tap (Agent-Gen-com/agentgen) and formula are from the official project and inspect the formula/binary if you can; (2) do not upload sensitive files — 'agentgen upload' makes assets publicly accessible for 24 hours; (3) free tier works without a key but is rate-limited and watermarked; if you set AGENTGEN_API_KEY you will be giving that key to the CLI to authenticate with agent-gen.com — ensure you trust the service and rotate the key if you later uninstall; (4) avoid sending personally identifiable or confidential HTML/content to the service unless you accept the privacy tradeoffs. If you want lower risk, consider reviewing the brew formula source or running the CLI in a restricted environment/container.

功能分析

Type: OpenClaw Skill Name: agentgen Version: 1.0.0 The skill is classified as suspicious due to the `agentgen upload` command, which allows uploading local files to a third-party service (agent-gen.com) where they become publicly accessible for 24 hours. While this feature is explicitly documented in SKILL.md as part of the workflow, the inherent risk of uploading arbitrary local files to a public URL, even if temporary, makes it a high-risk capability that could lead to accidental data exposure or misuse, thus warranting a 'suspicious' classification rather than 'benign'.

能力评估

✓ Purpose & Capability

Name/description, required binary (agentgen), and primary credential (AGENTGEN_API_KEY) all align with a CLI that talks to agent-gen.com. No unrelated env vars or binaries are requested.

ℹ Instruction Scope

SKILL.md only instructs use of the agentgen CLI and AgentGen API endpoints (image/pdf/upload/balance). It does not ask the agent to read unrelated files or secrets. Important operational note: 'agentgen upload' makes uploaded files publicly accessible for 24 hours and the free tier returns watermarked single-page output — these are functional behaviors with privacy implications (you should not upload sensitive content).

ℹ Install Mechanism

Install uses a Homebrew tap (Agent-Gen-com/agentgen) and creates an 'agentgen' binary. Using a third-party brew tap is reasonable for CLI distribution but carries more risk than installing from a mainline package manager; verify the tap/formula and the binary's provenance before installing.

✓ Credentials

Only a single API key (AGENTGEN_API_KEY) is declared as the primary credential, which is proportional to the described authenticated tier. The skill also documents a free tier that works without a key. No other unrelated credentials or paths are requested.

✓ Persistence & Privilege

Skill does not request always:true or other elevated persistence. It is user-invocable and allows autonomous invocation by default (normal). It does not instruct modifying other skills or system-wide settings.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install agentgen
安装完成后，直接呼叫该 Skill 的名称或使用 /agentgen 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release — generate PDFs and images from HTML with agentgen CLI and API. - Convert HTML to PDF or image via simple CLI commands - Free tier: no sign-up, 1 request/min, watermark on output - Authenticated tier: remove watermark, higher volume, supports multi-page PDFs - Upload temp assets for 24 hours to use in HTML - Supports custom output formats and viewport sizes - Clear guidance for inlining styles and referencing uploaded assets

元数据

Slug agentgen

版本 1.0.0

许可证 —

累计安装 1

当前安装数 1

历史版本数 1

常见问题