How do I install the Invoice Agent skill?

Run npx skillmds@latest add lord1egypt/invoice-agent in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Invoice Agent safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Invoice Agent?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Invoice Agent free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Proprietary — see LICENSE….

Who published Invoice Agent?

Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Invoice Agent by lord1egypt — Agent Skill

Name: Invoice Agent
Rating: 4.666666666666667 (3 reviews)
Author: Lord1Egypt

Invoice Agent

Professional invoice and payment management skill. Create, track, and manage invoices with natural language. Supports multi-currency, tax calculations, payment reminders with escalation, HTML invoice generation, overdue tracking, and financial summaries. Use when: (1) creating invoices from natural language descriptions, (2) tracking payment status and overdue invoices, (3) generating professional HTML invoices, (4) sending payment reminders with escalation levels, (5) viewing financial summaries and revenue reports, (6) managing client billing workflows. Perfect for freelancers, agencies, and small businesses. All data stored locally — no cloud dependencies or API keys required.

Lord1Egypt Updated Sep 8, 2026 2 repo stars

File contents

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 "you@business.com" \
  --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

---name: invoice-agentdescription: Professional invoice and payment management skill. Create, track, and manage invoices with natural language. Supports multi-currency, tax calculations, payment reminders with escalation, HTML invoice generation, overdue tracking, and financial summaries. Use when: (1) creating invoices from natural language descriptions, (2) tracking payment status and overdue invoices, (3) generating professional HTML invoices, (4) sending payment reminders with escalation levels, (5) viewing financial summaries and revenue reports, (6) managing client billing workflows. Perfect for freelancers, agencies, and small businesses. All data stored locally — no cloud dependencies or API keys required.license: Proprietary — see LICENSE file. Sold as a single-user license vi---# Invoice Agent 💰Professional invoice management entirely from the command line. All data stored locally at `~/.invoice-agent/data.json`.## Setup (one-time)```bash# Configure your business defaultspython3 SKILL_DIR/scripts/invoice.py config \ --business-name "Your Business" \ --business-email "you@business.com" \ --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"``````bashpython3 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```bash# Export firstpython3 SKILL_DIR/scripts/invoice.py export --id INV-XXX# Generate HTMLpython3 SKILL_DIR/scripts/generate_invoice.py ~/.invoice-agent/invoices/INV-XXX.json invoice.html```### Check Overdue Payments & Send Reminders```bashpython3 SKILL_DIR/scripts/invoice.py overduepython3 SKILL_DIR/scripts/reminders.py```### Financial Dashboard```bashpython3 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 FormatItems 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 EscalationAuto-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`

Frequently asked questions