agentgen_skill

Overview

This skill converts HTML into PDFs and screenshot images using the AgentGen API. It works out of the box on the free tier (no sign-up required) with modest limits and a small watermark. Provide an API key to remove the watermark, lift rate limits, and enable multi-page PDFs and uploads. The CLI is simple: supply HTML or files and save the generated PDF/image locally or use the returned URL.

How this skill works

The CLI sends your HTML to AgentGen’s /v1/generate/image or /v1/generate/pdf endpoints and returns a file or a public URL. The free tier requires no API key but enforces 1 request per minute, single-page PDFs, and adds a watermark. Supplying AGENTGEN_API_KEY uses authenticated endpoints: multi-page PDFs, higher throughput, no watermark, and temporary file uploads. Options let you control viewport, paper format, margins, scale, and output format.

When to use it

• Create single-page PDFs or screenshots quickly without signing up
• Produce shareable images for social cards or hero graphics (OG images)
• Generate multi-page PDFs or remove watermarks when you have an API key
• Convert HTML invoices, reports, or slides into printable PDFs
• Capture retina-quality screenshots or different image formats for web assets

Best practices

• Inline all CSS or include styles in <style> blocks to ensure correct rendering
• Use absolute URLs for images/fonts or upload assets with agentgen upload before referencing them
• Enable --print-background for PDFs if your layout includes colored backgrounds or background images
• For higher-fidelity images use --scale 2 for retina-quality output
• Use specified width/height for OG images (1200×630 recommended) and set viewport to match your target device

Example use cases

• Export a single-page invoice or report to PDF with margins and print backgrounds
• Generate OG images from an HTML template at 1200×630 for social sharing
• Create a high-resolution JPEG hero image using --scale 2 for marketing pages
• Build multi-page e-books or manuals by supplying multiple HTML files (requires API key)
• Upload local logos or fonts, reference the returned URLs, and produce a PDF with embedded assets