AgentGen — HTML to PDF & Image

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...

Security Scan

The skill's requirements and instructions match its stated purpose (calling the agentgen CLI / AgentGen API to render HTML to PDF/images); nothing requests unrelated credentials or system access, though there are modest privacy and install-source considerations to review before use.

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.

Assessment

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.

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 "<h1>Hello</h1>" --output hello.png

# Free tier — generate a PDF (no API key)
agentgen pdf --html "<h1>Invoice</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 <img src="...">

Max file size: 10 MB

---

Typical workflow

1. Build HTML with all styles inlined
2. Upload any local assets with agentgen upload and replace src/href values with the returned URLs
3. 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 <style> 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.