Skill: lyair1/agentgen (version 1.0.0)

--- name: agentgen description: 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, set AGENTGEN_API_KEY with tokens from agent-gen.com. metadata: openclaw: emoji: "🖨️" homepage: https://www.agent-gen.com primaryEnv: AGENTGEN_API_KEY requires: bins: - agentgen install: - kind: brew tap: Agent-Gen-com/agentgen formula: agentgen bins: [agentgen] --- # 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 ```sh # 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](https://www.agent-gen.com) include free tokens — no credit card required to get started. ```sh export AGENTGEN_API_KEY=your_key_here ``` Check your balance: ```sh 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) ```sh # 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) ```sh # 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. ```sh 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`.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)