Invoice Agent

Professional invoice and payment management skill. Create, track, and manage invoices with natural language. Supports multi-currency, tax calculations, payme...

Security Scan

The skill's code, runtime instructions, and requested resources are coherent with an offline CLI invoice manager that stores data under ~/.invoice-agent and does not require external credentials.

Purpose & Capability

Name/description (invoice creation, reminders, HTML generation, local storage) match the included scripts and SKILL.md. The scripts read/write only under ~/.invoice-agent and implement the advertised features (create/list/update/export/reminders/HTML generation). No unrelated services, binaries, or credentials are requested.

Instruction Scope

Runtime instructions tell the agent to run the included CLI scripts and to use SKILL_DIR; they operate only on local files under ~/.invoice-agent. One implementation note: the HTML generation inserts invoice fields into the template without escaping, so if invoice fields contain HTML/script content it could produce an HTML injection/XSS when opened in a browser. The reminders script generates email text but does not send emails or contact external endpoints.

Install Mechanism

No install spec is provided (instruction-only skill). All source files are included in the bundle; there are no downloads, package installs, or external install URLs to evaluate.

Credentials

No environment variables, API keys, or external credentials are required. The requested filesystem access (creating ~/.invoice-agent and writing JSON/invoice files) is proportionate to the stated purpose.

Persistence & Privilege

always is false and the skill does not request elevated or persistent platform privileges. It does not modify other skills or system-wide agent settings and only writes to its own data directory.

Assessment

This package appears to be a self-contained, local invoice CLI. Before installing: (1) review and back up any existing ~/.invoice-agent data since the scripts will create/write there; (2) note that the HTML generator directly injects invoice fields into the template without escaping — avoid including untrusted HTML in invoice fields or sanitize/escape fields before opening generated HTML in a browser; (3) reminders.py only formats messages and prints them — it does not send emails (so no hidden exfiltration), but if you modify it to send messages, inspect any added network code carefully; (4) the skill is proprietary and has no homepage/author details in metadata — if provenance matters to you, ask the publisher for source/audit info or run it in a restricted environment first.

Professional invoice management entirely from the command line. All data stored locally at ~/.invoice-agent/data.json.

Setup (one-time)

# Configure your business defaults
python3 SKILL_DIR/scripts/invoice.py config \
  --business-name "Your Business" \
  --business-email "[e-mail]" \
  --currency USD \
  --tax-rate 0

Quick Workflows

Create an Invoice (natural language → invoice)

User: "Create an invoice for Acme Corp for website design $2500 and SEO setup $500, due in 30 days"

python3 SKILL_DIR/scripts/invoice.py create \
  --client "Acme Corp" \
  --items "Website Design|1|2500" "SEO Setup|1|500" \
  --due-days 30

Generate Professional HTML Invoice

# Export first
python3 SKILL_DIR/scripts/invoice.py export --id INV-XXX
# Generate HTML
python3 SKILL_DIR/scripts/generate_invoice.py ~/.invoice-agent/invoices/INV-XXX.json invoice.html

Check Overdue Payments & Send Reminders

python3 SKILL_DIR/scripts/invoice.py overdue
python3 SKILL_DIR/scripts/reminders.py

Financial Dashboard

python3 SKILL_DIR/scripts/invoice.py summary --period month

Key Commands

Command	Purpose
create --client NAME --items "desc|qty|price"	New invoice
list [--status STATUS]	List/filter invoices
show --id INV-XXX	Full invoice details
update --id INV-XXX --status paid	Mark as paid/sent
summary --period month	Revenue report
overdue	List overdue invoices
reminders.py	Generate reminder emails
generate_invoice.py	HTML invoice from JSON
config [--business-name NAME ...]	Set defaults

Item Format

Items use pipe-separated format: "Description|Quantity|UnitPrice"

• "Website Design|1|2500" → 1 × $2,500 = $2,500
• "Hosting|3|29.99" → 3 × $29.99 = $89.97
• "Consulting|2|150" → 2 × $150 = $300

Reminder Escalation

Auto-escalation based on days overdue:

• 1-7 days: Gentle/friendly tone
• 8-21 days: Firm/professional tone
• 22+ days: Final notice with legal warning

References

• Full command reference: see references/guide.md
• HTML template: edit assets/invoice-template.html for custom branding
• Customize brand color: change BRAND_COLOR_DEFAULT in scripts/generate_invoice.py