Flow PDF Generator

Generate professional PDF documents from structured JSON data. Use when user wants to create, export, or save content as a PDF file. Supports styled titles,...

Security Scan

The skill is internally consistent: it generates PDFs from structured JSON using a local Python script (ReportLab); it does not request credentials or perform network access, though it omits a declared dependency and has a small CLI parsing quirk to be aware of.

Purpose & Capability

Name/description match the provided code and schema. The included script implements PDF generation (titles, tables, lists, images, page breaks) using ReportLab, which is exactly what the description promises.

Instruction Scope

SKILL.md instructs running the included script with JSON via --data or a file. The script reads JSON from the CLI or a file and will read image files referenced in the JSON (expected for embedding images). Minor concern: parse_args tries json.loads(json_input) and on JSONDecodeError treats the same value as a filename and opens it — this can lead to unexpected local file reads if an invalid JSON string is passed. There are no network calls or secret exfiltration in the code.

Install Mechanism

No install spec is provided (instruction-only), which is low risk. However, the code requires the ReportLab Python package but SKILL.md does not include installation instructions or a requirements.txt; users must install reportlab (e.g., pip install reportlab) before running.

Credentials

The skill requests no environment variables, credentials, or config paths and the code does not access environment secrets. All file I/O is limited to user-specified JSON or image paths.

Persistence & Privilege

Skill is not always-enabled and does not modify other skills or system-wide agent config. It does not persist credentials or request elevated/system privileges.

Assessment

This skill appears to do what it says: generate PDFs from JSON using the included script. Before installing/running: (1) Review the script yourself — it reads any file paths you provide in the JSON (images or a JSON filename), so do not pass sensitive filesystem paths. (2) Install reportlab in a virtualenv (pip install reportlab) — the dependency is not declared. (3) Note the CLI quirk: if --data contains invalid JSON the script will try to open that string as a filename, which can cause unexpected local file reads; avoid passing untrusted strings as --data. (4) Run the script as a non-privileged user or in a sandbox if you will process JSON from untrusted sources. If you want extra assurance, run the script on sample data first to confirm behavior.

PDF Generator

Generate styled PDF documents from structured JSON data using ReportLab.

Quick Start

python scripts/generate_pdf.py --output report.pdf --data '{
  "title": "Monthly Report",
  "subtitle": "March 2026",
  "author": "PragDev",
  "sections": [
    {"type": "text", "text": "Introduction text here."},
    {"type": "highlight", "text": "Key metric: +15%"},
    {"type": "list", "items": ["Item 1", "Item 2"]}
  ]
}'

JSON Schema Reference

See references/schema.md for complete schema documentation.

Output

• PDF saved to path specified by --output or data.output
• Default: output.pdf in current directory

Tips

• Use accent_color and header_color for brand colors
• Tables auto-alternate row backgrounds
• Images must exist at the specified path
• Page breaks create new pages