SkillAgentSearch skills...

afrexai-invoice-engine

Generate, manage, and track professional invoices with payment terms, recurring billing, overdue automation, and financial reporting

Install / Use

npx skills add LeoYeAI/openclaw-master-skills --skill afrexai-invoice-engine

Installs into whichever agent you are using.

About this skill
๐Ÿ“„

SKILL.md

Installable skill definition

Quality Score

90/100

Category

Automation

Supported Platforms

Universal

Our assessment of afrexai-invoice-engine

afrexai-invoice-engine scores 90/100 on our quality scale, 1218th of 2,790 Automation skills we index (top 44%).

Its SKILL.md is 16 KB long, well organised into 41 sections with 16 code examples: a thorough specification that gives an agent plenty to work with.

With 2,149 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
14/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-10-30 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit โ€” read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk โ€” read a skill before letting an agent act on it.

afrexai-invoice-engine compared with similar skills

All 4 of these similar skills score higher than afrexai-invoice-engine; compare them before choosing.

SkillScoreStarsUpdatedFormat
afrexai-invoice-engine (this skill)by LeoYeAI902.1k4mo agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server

Frequently asked questions

How do I install afrexai-invoice-engine?
Run npx skills add LeoYeAI/openclaw-master-skills --skill afrexai-invoice-engine. The install tabs above show the steps for each supported agent.
Which AI agents does afrexai-invoice-engine work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is afrexai-invoice-engine safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is afrexai-invoice-engine still maintained?
The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

name: afrexai-invoice-engine description: Generate, manage, and track professional invoices with payment terms, recurring billing, overdue automation, and financial reporting. Use when creating invoices, tracking payments, managing clients, or reviewing revenue.

Invoice Engine โ€” Complete Invoicing & Accounts Receivable

A zero-dependency agent skill for end-to-end invoicing โ€” from quote to payment to reporting.

Quick Start

When the user says "create an invoice" or "bill [client]":

  1. Check if client exists in memory (see Client Registry below)
  2. If new client โ†’ run Client Onboarding
  3. Generate invoice using the Invoice Builder
  4. Present for review โ†’ finalize
  5. Track in the Invoice Ledger

1. Client Registry

Maintain a YAML client database in your workspace:

# clients.yaml
clients:
  - id: "CLI-001"
    name: "Acme Corp"
    contact: "Jane Smith"
    email: "jane@acme.com"
    address:
      line1: "123 Business Ave"
      line2: "Suite 400"
      city: "New York"
      state: "NY"
      zip: "10001"
      country: "US"
    tax_id: "US-EIN-12-3456789"
    payment_terms: "net-30"       # net-15, net-30, net-45, net-60, due-on-receipt, custom
    preferred_currency: "USD"
    default_tax_rate: 0           # 0 for B2B cross-border, local rate for domestic
    notes: "PO required for invoices > $5,000"
    created: "2026-01-15"
    lifetime_revenue: 12500.00
    invoices_sent: 3
    invoices_paid: 2
    avg_days_to_pay: 22

Client Onboarding Checklist

When adding a new client, collect:

  • [ ] Legal entity name (exactly as on their records)
  • [ ] Billing contact name + email
  • [ ] Billing address (full, with country)
  • [ ] Tax ID / VAT number (if applicable)
  • [ ] Preferred payment terms
  • [ ] Currency preference
  • [ ] Any PO or approval requirements
  • [ ] Tax-exempt? (if so, get certificate reference)

2. Invoice Builder

Invoice Number Format

[PREFIX]-[YEAR].[MONTH].[SEQUENCE]
Example: INV-2026.02.001

Configurable prefix per business line:

  • INV = standard invoice
  • PRO = proforma / quote
  • REC = recurring invoice
  • CN = credit note

Invoice Template

When generating an invoice, structure it as:

โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—
โ•‘  [YOUR COMPANY NAME]                                     โ•‘
โ•‘  [Address Line 1]                                        โ•‘
โ•‘  [City, State ZIP]                                       โ•‘
โ•‘  [Country]                                               โ•‘
โ•‘  Tax ID: [YOUR TAX ID]                                   โ•‘
โ• โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ฃ
โ•‘                                                          โ•‘
โ•‘  INVOICE [NUMBER]                  Date: [ISSUE DATE]    โ•‘
โ•‘                                    Due:  [DUE DATE]      โ•‘
โ•‘                                                          โ•‘
โ•‘  Bill To:                          Payment Terms:        โ•‘
โ•‘  [CLIENT NAME]                     [Net-30 / etc.]       โ•‘
โ•‘  [Client Address]                                        โ•‘
โ•‘  [City, State ZIP]                 PO Number:            โ•‘
โ•‘  Tax ID: [CLIENT TAX ID]          [If applicable]        โ•‘
โ•‘                                                          โ•‘
โ• โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ฃ
โ•‘  #  โ”‚ Description          โ”‚ Qty โ”‚ Rate    โ”‚ Amount     โ•‘
โ• โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ฃ
โ•‘  1  โ”‚ [Service/Product]    โ”‚  1  โ”‚ $X,XXX  โ”‚ $X,XXX.XX โ•‘
โ•‘  2  โ”‚ [Service/Product]    โ”‚  3  โ”‚ $XXX    โ”‚ $X,XXX.XX โ•‘
โ•‘  3  โ”‚ [Expense passthrough]โ”‚  1  โ”‚ $XXX    โ”‚ $XXX.XX   โ•‘
โ• โ•โ•โ•โ•โ•โ•งโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•งโ•โ•โ•โ•โ•โ•งโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•งโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ฃ
โ•‘                              Subtotal:    $XX,XXX.XX     โ•‘
โ•‘                              Discount:    -$X,XXX.XX     โ•‘
โ•‘                              Tax (X%):    $X,XXX.XX      โ•‘
โ•‘                              โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€   โ•‘
โ•‘                              TOTAL DUE:   $XX,XXX.XX     โ•‘
โ• โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ฃ
โ•‘  Payment Methods:                                        โ•‘
โ•‘  โ€ข Bank Transfer: [Bank] | Acct: [XXXX] | Routing: [XX] โ•‘
โ•‘  โ€ข PayPal: [email]                                       โ•‘
โ•‘  โ€ข Stripe: [payment link]                                โ•‘
โ•‘  โ€ข Bitcoin: [address] / Lightning: [LNURL]               โ•‘
โ•‘                                                          โ•‘
โ•‘  Notes: [Custom message / thank you / late fee notice]   โ•‘
โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

Line Item Types

  • Time-based: Hours ร— hourly rate (log hours, auto-calculate)
  • Fixed fee: Project milestones, retainers
  • Quantity-based: Units ร— unit price
  • Expense passthrough: At-cost or with markup %
  • Discount line: Negative amount (early payment, volume, loyalty)
  • Recurring: Auto-populated from recurring schedule

Tax Handling Decision Tree

Is client in same country as you?
โ”œโ”€โ”€ YES โ†’ Apply local tax rate
โ”‚   โ”œโ”€โ”€ Client tax-exempt? โ†’ Add exemption reference, 0% tax
โ”‚   โ””โ”€โ”€ Client NOT exempt โ†’ Apply standard rate
โ””โ”€โ”€ NO โ†’ Usually 0% (reverse charge / export)
    โ”œโ”€โ”€ Both in EU? โ†’ Reverse charge mechanism (0%, note on invoice)
    โ”œโ”€โ”€ US interstate? โ†’ Check nexus rules
    โ””โ”€โ”€ International โ†’ 0% with export reference

Discount & Pricing Framework

  • Early payment: 2/10 Net 30 (2% discount if paid within 10 days)
  • Volume: Tiered pricing (1-10 units = $X, 11-50 = $Y, 51+ = $Z)
  • Loyalty: After 6+ invoices, offer 5% ongoing discount
  • Bundled: Package multiple services, discount 10-15% vs ร  la carte
  • Seasonal: Q4 premium (+10%), Q1 discount (-5%) if applicable

3. Invoice Lifecycle & Status Tracking

Status Flow

DRAFT โ†’ SENT โ†’ VIEWED โ†’ PARTIALLY_PAID โ†’ PAID โ†’ CLOSED
                  โ†“
              OVERDUE โ†’ ESCALATED โ†’ WRITTEN_OFF
                  โ†“
            DISPUTED โ†’ RESOLVED โ†’ PAID

Invoice Ledger (YAML)

# invoices.yaml
invoices:
  - number: "INV-2026.02.001"
    client_id: "CLI-001"
    status: "sent"
    issue_date: "2026-02-13"
    due_date: "2026-03-15"
    currency: "USD"
    subtotal: 5000.00
    discount: 0
    tax: 0
    total: 5000.00
    amount_paid: 0
    balance_due: 5000.00
    payment_terms: "net-30"
    line_items:
      - description: "AI Integration Consulting โ€” February"
        qty: 20
        rate: 250.00
        amount: 5000.00
    payments: []
    notes: ""
    sent_date: "2026-02-13"
    reminders_sent: 0
    created: "2026-02-13T10:30:00Z"

Payment Recording

When a payment comes in:

payments:
  - date: "2026-03-10"
    amount: 5000.00
    method: "bank_transfer"    # bank_transfer, stripe, paypal, btc, cash, check
    reference: "TXN-ABC123"
    notes: "Paid in full"

Update: amount_paid, balance_due, status (โ†’ paid if balance = 0, โ†’ partially_paid if balance > 0)


4. Recurring Invoices

Schedule Configuration

recurring:
  - id: "REC-001"
    client_id: "CLI-001"
    description: "Monthly Retainer โ€” AI Ops Support"
    frequency: "monthly"          # weekly, biweekly, monthly, quarterly, annually
    day_of_month: 1               # 1-28 (avoid 29-31 for safety)
    line_items:
      - description: "AI Operations Retainer"
        qty: 1
        rate: 3500.00
    auto_send: true               # false = create as draft
    start_date: "2026-01-01"
    end_date: null                # null = indefinite
    next_invoice: "2026-03-01"
    invoices_generated: 2
    active: true

Recurring Invoice Routine (run on schedule)

  1. Check recurring entries where next_invoice <= today and active = true
  2. For each: generate invoice from template, assign next number
  3. If auto_send = true โ†’ mark as sent, notify client
  4. If auto_send = false โ†’ save as draft, notify user for review
  5. Update next_invoice to next occurrence
  6. Log in daily memory

5. Overdue Management & Collections

Reminder Schedule

| Days After Due | Action | Tone | |---|---|---| | +1 day | Friendly reminder email | "Just a gentle reminder..." | | +7 days | Follow-up with invoice attached | "Following up on..." | | +14 days | Firm reminder, mention late fee | "This invoice is now 14 days past due..." | | +30 days | Final notice before escalation | "Final notice โ€” please remit payment..." | | +45 days | Escalate to human (Kalin/Christina) | Flag for personal outreach | | +60 days | Consider write-off or collections | Business decision |

Reminder Templates

Day +1 (Friendly)

Subject: Friendly reminder โ€” Invoice [NUMBER] due [DATE]

Hi [CONTACT],

Hope all is well! Just a quick reminder that invoice [NUMBER] for [AMOUNT] was due on [DATE].

If you've already sent payment, please disregard this note.

Payment details are on the attached invoice. Let me know if you need anything.

Best,
[YOUR NAME]

Day +14 (Firm)

Subject: Invoice [NUMBER] โ€” 14 days overdue ([AMOUNT])

Hi [CONTACT],

Invoice [NUMBER] for [AMOUNT] is now 14 days past the due date of [DATE].

Per our agreement, a late fee of [X]% may apply to balances outstanding beyond [Y] days.

Could you confirm when we can expect payment? Happy to discuss if there's an issue.

Thanks,
[YOUR NAME]

Day +30 (Final)

Subject: Final notice โ€” Invoice [NUMBER] overdue ([AMOUNT])

Hi [CONTACT],

This is a final reminder that invoice [NUMBER] for [AMOUNT] remains unpaid, now 30 days past the due date.

Please arrange payment within the next 7 business days to avoid further action.

If there's a dispute or issue with this invoice, please let me know immediately so we can resolve it.

Regards,
[YOUR NAME]

Late Fee Calculation

Standard: 1.5% per month on overdue balance (18% APR)
Grace period: 5 business days after due date
Compound: Simple interest (not compound)
Cap: 25% of invoice total (or local legal maximum)

Formula: late_fee = balance_due ร— (monthly_rate / 30) ร— days_overdue
Example: $5,000 ร— (0.015 / 30) ร— 14 = $35.00

6. Financial Reporting

Revenue Dashboard (generate weekly/monthly)

โ•โ•โ• REVENUE SUMMARY โ€” [MONTH YEAR] โ•โ•โ•

Invoiced This Month:      $XX,XXX.XX  ([N] invoices)
Collected This Month:     $XX,XXX.XX  ([N] payments)
Outstanding (not overdue): $XX,XXX.XX  ([N] invoices)
Overdue:                  $XX,XXX.XX  ([N] invoices, avg [X] days late)
Written Off (YTD):        $XX,XXX.XX

Collection Rate:          XX.X%  (collected / invoiced, trailing 90 days)
Avg Days to Pay:          XX days (trailing 90 days)
Avg Invoice Size:         $X,XXX.XX

โ•โ•โ• TOP CLIENTS (by revenue, YTD) โ•โ•โ•
1. [Client] โ€” $XX,XXX  ([N] invoices, avg [X] days to pay)
2. [Client] โ€” $XX,XXX  ([N] invoices, avg [X] days to pay)
3. [Client] โ€” $XX,XXX  ([N] invoices, avg [X] days to pay)

โ•โ•โ• AGING REPORT โ•โ•โ•
Current (not yet due):     $XX,XXX  ([N] invoices)
1-15 days overdue:         $XX,XXX  ([N] invoices)
16-30 days overdue:        $XX,XXX  ([N] invoices)
31-60 days overdue:        $XX,XXX  ([N] invoices)
60+ days overdue:          $XX,XXX  ([N] invoices) โš ๏ธ

โ•โ•โ• MONTHLY TREND โ•โ•โ•
Jan: $XX,XXX โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ
Feb: $XX,XXX โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ
Mar: $XX,XXX โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ
...

โ•โ•โ• ACTIONS NEEDED โ•โ•โ•
โ€ข [N] invoices need reminder emails
โ€ข [N] recurring invoices due for generation
โ€ข [Client] has disputed INV-XXXX โ€” needs resolution

Key Metrics to Track

  • Collection Rate: % of invoiced amount actually collected (target: >95%)
  • DSO (Days Sales Outstanding): avg days from invoice to payment (target: <30)
  • Overdue Ratio: overdue balance / total outstanding (target: <10%)
  • Revenue Concentration: % from top client (flag if >40% โ€” dependency risk)
  • MRR from Recurring: recurring invoice total / month

7. Credit Notes & Adjustments

When a refund or correction is needed:

credit_note:
  number: "CN-2026.02.001"
  original_invoice: "INV-2026.01.003"
  client_id: "CLI-001"
  reason: "Partial refund โ€” service hours overcharged"
  line_items:
    - description: "

Truncated for display โ€” read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars2.1k
CategoryAutomation
Updated3mo ago
Forks325

Languages

Python

Trust signals

98/100

From repository metadata: license, adoption, age and documentation. Not a code audit โ€” see the Safety scan above for what the skill file itself contains.

1 info
afrexai-invoice-engine โ€” Universal Skill: Install & Safety Check | SkillAgent