Invoice Gen

Generate professional PDF invoices from simple text commands. Supports multiple currencies, tax calculation, CJK text, and customizable templates. No externa...

Security Scan

The skill's code and instructions match its stated purpose (offline PDF invoice generation); it does not request credentials or network access and contains no obvious exfiltration or unrelated capabilities.

Purpose & Capability

Name/description promise (generate PDF invoices, CJK support, offline) aligns with included assets: SKILL.md describes usage and dependencies and scripts/gen_invoice.py implements PDF generation with CJK font discovery and invoice formatting. No unrelated credentials, binaries, or services are requested.

Instruction Scope

SKILL.md instructs the agent to run the included Python script and to install reportlab and optional CJK fonts. The runtime instructions and script operate on provided invoice fields and an output path only; they do not read arbitrary user files, environment secrets, or contact network endpoints.

Install Mechanism

No install spec is provided; the skill is instruction-only with a bundled script. Declared dependency is pip install reportlab and optional OS package manager font installs — both are expected for PDF/CJK rendering. There are no downloads from untrusted URLs or archive extraction instructions.

Credentials

The skill requires no environment variables, credentials, or config paths. The script searches common font paths on disk (expected for CJK support) but does not access other system secrets or configuration.

Persistence & Privilege

The skill is not marked always:true and does not modify other skills or agent configuration. It runs as a one-off script that writes a user-specified output PDF path only.

Assessment

This skill appears to be what it claims: an offline PDF invoice generator. Before installing/running: (1) ensure you install reportlab from PyPI (pip3 install reportlab) and any CJK fonts you actually need; the SKILL.md suggests using sudo apt/yum to install fonts — only do that on systems you control. (2) Review or run the included scripts/gen_invoice.py in an isolated environment if you have concerns about file writes; it only writes the specified output file but will search font directories. (3) Provide only expected invoice data as arguments and avoid running with elevated privileges unnecessarily. If you need network-isolated assurance, run it in a container/VM. Overall there are no credentials requested and no network calls or obfuscated code in the provided script.

Invoice Generator

Generate professional PDF invoices from natural language or structured data. Works offline, no external service needed.

Quick Start

Tell your OpenClaw agent:

Generate an invoice for:
- Client: Acme Corp, 123 Main St, New York
- Items: Web Development 40 hours @ $150/hr, Server Setup 1x $500
- Tax: 10%
- Due: Net 30
- My company: Zac Tech LLC

The agent will use this skill to generate a professional PDF invoice.

Script Usage

python3 {baseDir}/scripts/gen_invoice.py \
  --from "Your Company, 123 Street, City" \
  --to "Client Name, 456 Ave, City" \
  --items "Web Development|40|150" "Server Setup|1|500" \
  --tax 10 \
  --currency USD \
  --due "Net 30" \
  --number "INV-2026-001" \
  --output invoice.pdf

Features

• 📄 Clean, professional PDF layout
• 💰 Multiple currencies (USD, EUR, GBP, CNY, JPY, AUD, etc.)
• 📊 Automatic subtotal, tax, and total calculation
• 🔢 Sequential invoice numbering
• 🇨🇳 CJK text support (Chinese/Japanese/Korean company names and items)
• 📝 Notes and payment terms field
• 🖨️ Print-ready A4 format

Item Format

Each item is a pipe-separated string: description|quantity|unit_price

"Website Design|1|2000"
"Hosting (monthly)|12|50"
"Content Writing|20|75"

Dependencies

pip3 install reportlab

For CJK support, install CJK fonts:

sudo yum install -y google-noto-sans-cjk-ttc-fonts  # RHEL/CentOS
sudo apt install -y fonts-noto-cjk                    # Ubuntu/Debian