← Back to Skills Marketplace
91
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install invoice-agent
Description
Professional invoice and payment management skill. Create, track, and manage invoices with natural language. Supports multi-currency, tax calculations, payme...
README (SKILL.md)
Invoice Agent 💰
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 "[email protected]" \
--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.htmlfor custom branding - Customize brand color: change
BRAND_COLOR_DEFAULTinscripts/generate_invoice.py
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: invoice-agent
Version: 1.0.1
The invoice-agent skill is a legitimate local utility for managing business invoices and payment tracking. The core logic in scripts/invoice.py and scripts/generate_invoice.py handles CRUD operations and HTML generation using standard Python libraries without any network requests, external dependencies, or suspicious system calls. All data is stored locally in the user's home directory (~/.invoice-agent/), and the instructions in SKILL.md are strictly aligned with the stated purpose of the tool.
Capability Tags
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install invoice-agent - After installation, invoke the skill by name or use
/invoice-agent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fixed license to proprietary. Single-user license via ClawHub marketplace.
v1.0.0
Initial release of invoice-agent — command-line invoice and payment management.
- Create and manage invoices using natural language.
- Supports multi-currency, tax calculations, and local data storage (no cloud/API).
- Tracks payment status, overdue invoices, and automates reminder escalation.
- Generates professional HTML invoices from JSON data.
- Provides financial summaries and revenue reports for freelancers, agencies, and small businesses.
Metadata
Frequently Asked Questions
What is Invoice Agent?
Professional invoice and payment management skill. Create, track, and manage invoices with natural language. Supports multi-currency, tax calculations, payme... It is an AI Agent Skill for Claude Code / OpenClaw, with 91 downloads so far.
How do I install Invoice Agent?
Run "/install invoice-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Invoice Agent free?
Yes, Invoice Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Invoice Agent support?
Invoice Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Invoice Agent?
It is built and maintained by Atum246 (@atum246); the current version is v1.0.1.
More Skills