← Back to Skills Marketplace

Agent Invoice Generator

Name: Agent Invoice Generator
Author: johnnywang2001

by John Wang · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ Security Clean

268

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install agent-invoice-generator

Description

Generate professional PDF invoices from natural language or structured data. Use when the user asks to create an invoice, bill a client, generate a receipt,...

README (SKILL.md)

Invoice Generator

Create professional invoices instantly from your agent.

Quick Start

Generate an invoice:

python3 scripts/invoice.py create \
  --client "Acme Corp" \
  --items "Web Development,40h,$150" "Hosting Setup,1,$500" \
  --tax 7 \
  --due-days 30

Commands

Create Invoice

python3 scripts/invoice.py create \
  --client "Client Name" \
  --items "Description,Qty,Rate" \
  --tax 7 \
  --discount 10 \
  --currency USD \
  --due-days 30 \
  --notes "Payment via wire transfer"

From Natural Language

When the user says something like "Invoice Acme Corp for 40 hours of dev work at $150/hr plus a $500 setup fee, 7% tax, net 30" — parse and pass to the create command.

List Invoices

python3 scripts/invoice.py list
python3 scripts/invoice.py list --status unpaid

Mark as Paid

python3 scripts/invoice.py paid --id INV-2026-001

View Invoice

python3 scripts/invoice.py view --id INV-2026-001

Business Info Setup

Configure your business details once:

python3 scripts/invoice.py setup \
  --business "Your Company" \
  --email "[email protected]" \
  --address "123 Main St, City, ST 12345" \
  --phone "+1-555-0100" \
  --logo assets/logo.png

Stored at ~/.openclaw/invoice-config.json.

Invoice Format

Generated invoices include:

Invoice number (auto-incrementing: INV-YYYY-NNN)
Business and client details
Itemized line items with quantities and rates
Subtotal, tax, discount, and total
Due date and payment terms
Notes/terms section
Professional formatting

Output

PDF saved to ~/Documents/Invoices/INV-YYYY-NNN.pdf
Markdown summary printed to chat
Optional: email invoice directly via configured email skill

Currencies

Supports: USD, EUR, GBP, CAD, AUD, JPY, CHF, and 20+ others with proper symbol formatting.

Recurring Invoices

python3 scripts/invoice.py recurring \
  --client "Client" \
  --items "Monthly Retainer,1,$2000" \
  --frequency monthly \
  --start 2026-03-01

Set up as a cron job for automatic generation and delivery.

Usage Guidance

This skill appears to do what it claims (create and store invoices locally). Before installing or running it, consider: 1) Local storage/privacy — it writes business info and invoice JSON to ~/.openclaw and PDFs/HTML to ~/Documents/Invoices; treat those files as potentially sensitive and confirm file permissions and backups. 2) Review the full script on disk (you saw a truncated listing); ensure there are no hidden network calls or telemetry before trusting it with real customer data. 3) reportlab is an optional dependency for PDF output — if you install it, use a trusted source (pip from PyPI) and review package provenance. 4) Recurring invoicing suggestions (cron) and 'email via configured email skill' require separate careful configuration: mailing requires credentials and should be reviewed before enabling automatic delivery. 5) Concurrency note: invoice numbering increments the config file on generation and could race in concurrent runs; if you will run this in parallel, consider locking or single-threaded operation. If you want higher assurance, run the script in a sandboxed environment and inspect the full file contents before giving it access to real data.

Capability Analysis

Type: OpenClaw Skill Name: agent-invoice-generator Version: 1.0.0 The invoice-generator skill is a legitimate utility for creating and managing PDF/HTML invoices. The Python script (scripts/invoice.py) handles local data storage and document generation without any network activity, obfuscation, or suspicious execution patterns. All file operations are restricted to the user's home directory (~/.openclaw and ~/Documents/Invoices), and the instructions in SKILL.md align perfectly with the tool's stated functionality.

Capability Assessment

✓ Purpose & Capability

The name and description (generate invoices, PDF output, recurring, payment tracking) match the provided script. The script implements invoice creation, numbering, storage, PDF/HTML generation, listing and marking paid — all coherent with the stated purpose.

ℹ Instruction Scope

SKILL.md instructs use of scripts/invoice.py and documents storage locations (~/.openclaw/invoice-config.json, ~/.openclaw/invoices, ~/Documents/Invoices). That scope is appropriate for an invoicing tool, but the skill stores invoice data and business info unencrypted on disk (privacy risk). SKILL.md also suggests recurring invoices via cron and optional emailing via an external 'email skill' (email sending is not implemented in the provided script and would require separate credential/config review).

✓ Install Mechanism

This is instruction-only with an included Python script; there is no install spec, no downloads, and no third-party install automation. It optionally depends on the reportlab Python package for PDF output (fallback to HTML if missing).

✓ Credentials

The skill declares no required environment variables, credentials, or config paths beyond application-specific file locations under the user's home directory. No unrelated secrets or external service keys are requested.

ℹ Persistence & Privilege

The skill persists configuration and invoice JSON files under ~/.openclaw and writes PDF/HTML invoices to ~/Documents/Invoices. It does not request always:true or modify other skills. Persisting potentially sensitive billing data locally is expected behavior but worth noting for privacy and backup/permission considerations.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install agent-invoice-generator
After installation, invoke the skill by name or use /agent-invoice-generator
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

Generate professional PDF invoices from natural language. Multi-currency, tax, discounts, recurring invoices, payment tracking.

Metadata

Slug agent-invoice-generator

Version 1.0.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Agent Invoice Generator?

Generate professional PDF invoices from natural language or structured data. Use when the user asks to create an invoice, bill a client, generate a receipt,... It is an AI Agent Skill for Claude Code / OpenClaw, with 268 downloads so far.

How do I install Agent Invoice Generator?

Run "/install agent-invoice-generator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Agent Invoice Generator free?

Yes, Agent Invoice Generator is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Agent Invoice Generator support?

Agent Invoice Generator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Agent Invoice Generator?

It is built and maintained by John Wang (@johnnywang2001); the current version is v1.0.0.

More Skills