Eternal Invoice Generator

Generate professional PDF invoices, quotes, reminders, and recurring bills with customizable items, taxes, discounts, and payment details from the command line.

Security Scan

The skill's code and instructions match its stated purpose (generating PDF invoices); it has no secret/credential requests, no network calls, and only writes local files (PDFs and a small counter file in the user's home directory).

Purpose & Capability

Name/description (invoice generation) aligns with the included script. The script implements create, list, and remind commands and generates PDFs using fpdf2. It persists an invoice counter in ~/.invoices/counter.json to auto-increment invoice numbers — this is coherent with the stated feature set.

Instruction Scope

SKILL.md directs running the included Python script and editing template files; the runtime instructions and code stay within invoice generation (parsing items, formatting PDFs, saving files). Note: SKILL.md mentions scripts/invoice_template.html and assets/logo.png for customization, but those files are not present in the package — the template customization step is referenced but not shipped.

Install Mechanism

There is no install spec (instruction-only), which minimizes risk. The script requires the external Python package fpdf2 (module 'fpdf'); the code exits with an instruction to 'pip install fpdf2' if missing. That's expected but means the user must install a third-party package (no automatic installer provided).

Credentials

The skill requests no environment variables or credentials. It writes a small counter file to ~/.invoices and outputs PDFs into the current working directory (or a specified output). Those accesses are proportional to maintaining invoice numbering and saving output. No access to unrelated config or secrets is present.

Persistence & Privilege

The skill does not request elevated privileges or always-on persistence. Its only persistent effect is creating ~/.invoices/counter.json and writing PDF files in the working directory. It does not modify other skills, system settings, or network configuration.

Assessment

This skill appears to do what it says: generate invoices as PDFs. Before installing/using it, consider: (1) You must install the fpdf2 Python package (pip install fpdf2); the package is not installed automatically. (2) The tool will create ~/.invoices/counter.json to track auto-increment numbers and will write PDF files to your current directory by default — review or remove that file if you don't want persistent numbering. (3) SKILL.md references template and asset files (scripts/invoice_template.html, assets/logo.png) that are not included; if you need custom templates, add your own and verify formatting. (4) The script does not make network calls or request credentials, but it will include any bank/account details or client data you pass on the generated PDFs — treat output files as sensitive. (5) If you have security concerns, run the script in an isolated environment (virtualenv/container) and inspect the full file (note the provided invoice.py was truncated in the package listing; ensure you have the complete source before running).

Invoice Generator

Create professional PDF invoices from the command line.

Quick Start

python3 scripts/invoice.py create \
  --from "Your Business Name" \
  --to "Client Name" \
  --item "Consulting,8hrs,75" \
  --item "Design,3hrs,100" \
  --due 14

Commands

Command	Description
create	Generate a new invoice PDF
estimate	Create a quote/estimate instead
recurring	Set up a recurring invoice template
list	List generated invoices
remind	Generate a payment reminder

Item Format

Items are specified as: "Description,Quantity,UnitPrice"

Examples:

• "Web Development,40,85" — 40 hours at $85/hr
• "Logo Design,1,1500" — flat rate $1500
• "Hosting,12,29.99" — 12 months at $29.99/mo

Options

Flag	Default	Description
--from	(required)	Your business/personal name
--from-email		Your email
--from-address		Your address
--to	(required)	Client name
--to-email		Client email
--to-address		Client address
--item	(repeatable)	Line items
--tax	0	Tax percentage
--discount	0	Discount percentage or flat amount
--due	30	Payment due in N days
--currency	USD	Currency code
--notes		Additional notes
--prefix	INV	Invoice number prefix
--bank		Bank details for payment
--output	auto	Output filename

Output

Generates a clean, professional PDF with:

• Invoice number (auto-incremented)
• Issue date and due date
• Itemized line items with subtotals
• Tax, discount, and total calculations
• Payment terms and bank details
• Professional formatting

Templates

Invoices use a clean minimal template by default. To customize:

1. Edit scripts/invoice_template.html
2. Add your logo to assets/logo.png