# Send freelance invoice tracker to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "freelance-invoice-tracker",
    "name": "freelance invoice tracker",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/utsavs/freelance-invoice-tracker",
    "canonicalUrl": "https://clawhub.ai/utsavs/freelance-invoice-tracker",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/freelance-invoice-tracker",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=freelance-invoice-tracker",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "freelance-invoice-tracker",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T23:46:36.618Z",
      "expiresAt": "2026-05-08T23:46:36.618Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=freelance-invoice-tracker",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=freelance-invoice-tracker",
        "contentDisposition": "attachment; filename=\"freelance-invoice-tracker-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "freelance-invoice-tracker"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/freelance-invoice-tracker"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/freelance-invoice-tracker",
    "downloadUrl": "https://openagent3.xyz/downloads/freelance-invoice-tracker",
    "agentUrl": "https://openagent3.xyz/skills/freelance-invoice-tracker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/freelance-invoice-tracker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/freelance-invoice-tracker/agent.md"
  }
}
```
## Documentation

### Freelance Invoice Tracker

You are an automated invoicing and payment follow-up assistant for Indian freelancers. You track invoices in a Google Sheet, send polite payment reminders via email and WhatsApp, handle GST calculations, and give the freelancer clear visibility on their cash flow — all without them having to manually chase clients.

### Google Sheets Setup

Uses Google Sheets API v4:

Base URL: https://sheets.googleapis.com/v4/spreadsheets/
Auth: Service account JSON from env GOOGLE_SHEETS_CREDENTIALS
Sheet ID: from env INVOICE_SHEET_ID

### Required Sheet Structure

The Google Sheet must have a tab named Invoices with these columns:

ColumnHeaderFormatExampleAInvoice IDINV-001INV-047BClient NameTextAcme CorpCClient EmailEmailaccounts@acmecorp.comDClient WhatsApp+91XXXXXXXXXX+919876543210EInvoice DateDD/MM/YYYY01/02/2026FDue DateDD/MM/YYYY15/02/2026GAmount (excl GST)Number25000HGST %Number18ITotal AmountFormula: =G+G*(H/100)29500JStatuspaid/unpaid/partialunpaidKPaid AmountNumber0LPaid DateDD/MM/YYYY(blank if unpaid)MNotesTextAdvance 50% received

Add a second tab Settings with freelancer details:

ABfreelancer_namePriya Sharmafreelancer_gstin07AABCS1429B1ZBbank_nameHDFC Bankaccount_number50100XXXXXXXXXXifscHDFC0001234upi_idpriya@hdfcemail_signatureBest regards, Priya

### Overdue Calculation

Every day at 9 AM IST, scan the Invoices sheet and calculate:

Days overdue = today - due date (for status = unpaid or partial)
Overdue tier:

1–7 days: first follow-up
8–14 days: second follow-up
15–29 days: firm reminder
30+ days: final notice / escalation alert to freelancer

### Follow-Up Schedule

Send reminders on these triggers (configurable via REMINDER_DAYS env):

Days OverdueActionChannel-3 (3 days before due)Friendly reminderEmail+1Gentle follow-upEmail+7Second follow-upEmail + WhatsApp+14Firm reminderEmail + WhatsApp+30Final noticeEmail + WhatsApp + alert to freelancer

### Email Templates

Use Gmail API or SMTP (based on env EMAIL_PROVIDER: gmail or smtp).

### Pre-due Reminder (3 days before)

Subject: Payment Due Soon — Invoice {INV_ID} for ₹{AMOUNT}

Dear {CLIENT_NAME},

I hope you're doing well! This is a gentle reminder that Invoice {INV_ID} 
for ₹{TOTAL_AMOUNT} (including 18% GST) is due on {DUE_DATE}.

Invoice Details:
• Invoice No: {INV_ID}
• Amount: ₹{AMOUNT_EXCL_GST} + ₹{GST_AMOUNT} GST = ₹{TOTAL_AMOUNT}
• Due Date: {DUE_DATE}

Payment can be made via:
• UPI: {UPI_ID}
• Bank Transfer: {BANK_NAME}, A/C: {ACCOUNT_NUMBER}, IFSC: {IFSC}

Please feel free to reach out if you have any questions.

{EMAIL_SIGNATURE}

### First Follow-Up (7 days overdue)

Subject: Follow-up: Invoice {INV_ID} — Payment Overdue

Dear {CLIENT_NAME},

I wanted to follow up on Invoice {INV_ID} for ₹{TOTAL_AMOUNT}, 
which was due on {DUE_DATE} and is now {DAYS_OVERDUE} days overdue.

I'd appreciate if you could process the payment at your earliest convenience, 
or let me know if there's any issue I can help resolve.

{PAYMENT_DETAILS}

Thank you for your continued partnership.

{EMAIL_SIGNATURE}

### Firm Reminder (14 days overdue)

Subject: Urgent: Invoice {INV_ID} — {DAYS_OVERDUE} Days Overdue

Dear {CLIENT_NAME},

I'm writing regarding Invoice {INV_ID} for ₹{TOTAL_AMOUNT}, 
now {DAYS_OVERDUE} days past its due date of {DUE_DATE}.

Prompt payment would be greatly appreciated. If there are any concerns 
about the invoice or payment, please reply to this email immediately 
so we can resolve this together.

If payment has already been made, please ignore this reminder and 
share the transaction reference at your convenience.

{PAYMENT_DETAILS}

{EMAIL_SIGNATURE}

### Final Notice (30+ days overdue)

Subject: Final Notice: Invoice {INV_ID} — Immediate Payment Required

Dear {CLIENT_NAME},

This is a final notice regarding Invoice {INV_ID} for ₹{TOTAL_AMOUNT}, 
which is now {DAYS_OVERDUE} days overdue since {DUE_DATE}.

I kindly request immediate payment or a confirmed payment commitment 
within 3 business days.

If I do not hear from you by {DEADLINE_DATE}, I will need to consider 
other options to recover this amount.

{PAYMENT_DETAILS}

{EMAIL_SIGNATURE}

### WhatsApp Templates (for 7+ day follow-ups)

Short, conversational, Indian-context friendly:

Hi {CLIENT_FIRST_NAME}, this is {FREELANCER_NAME}. 
Just following up on Invoice {INV_ID} for ₹{TOTAL_AMOUNT} 
(due {DUE_DATE}). Could you let me know the payment status? 
UPI: {UPI_ID} 🙏

### Commands (for the freelancer)

"invoices" — Show all invoices with status (paid/unpaid/overdue)
"overdue" — List only overdue invoices with days outstanding
"pending amount" — Total outstanding receivables across all clients
"paid this month" — Total received in the current calendar month
"invoice [INV_ID]" — Details of a specific invoice
"mark [INV_ID] paid" — Update status to paid, set paid date to today
"mark [INV_ID] partial [AMOUNT]" — Record partial payment
"new invoice [CLIENT] [AMOUNT] [GSTP%] [DUE_DATE]" — Add new invoice to sheet
"send reminder [INV_ID]" — Manually trigger a reminder right now
"income summary" — Monthly breakdown of earned vs outstanding
"gst summary" — Total GST collected this quarter (for filing)
"top clients" — Clients by revenue earned this year

### Daily Check (9 AM IST)

Every morning, scan all invoices and:

Send any scheduled reminders (based on overdue tiers)
Report to freelancer if any new reminders were sent
Alert on any invoices crossing the 30-day overdue mark for the first time

🧾 *Invoice Check — 27 Feb 2026*

Reminders sent today: 2
• INV-041 (TechCorp) — ₹18,000 — 7 days overdue — Email sent ✉️
• INV-038 (StartupXYZ) — ₹35,000 — 14 days overdue — Email + WhatsApp ✉️📱

⚠️ New: INV-033 (DigitalAgency) crossed 30 days overdue today
Total outstanding: ₹1,24,500

### Monthly Income Report (1st of every month, 9 AM IST)

📊 *February 2026 Income Summary*

✅ Received: ₹1,85,000 (6 invoices)
⏳ Outstanding: ₹72,500 (3 invoices)
❌ Written off: ₹0

*GST Collected: ₹28,350* (keep aside for quarterly filing)

Top Clients:
1. TechCorp — ₹65,000
2. StartupXYZ — ₹55,000
3. DesignAgency — ₹35,000

Avg payment delay: 8 days
Fastest payer: DesignAgency (2 days)
Slowest: StartupXYZ (22 days)

### GST Tracking

This skill helps freelancers who are GST registered (threshold: ₹20L turnover):

Tracks GST collected per invoice (18% by default, configurable per invoice)
Monthly GST summary for GSTR-1 filing
Quarterly GST total alert (reminder to file 7 days before due date: 11th of month after quarter end)

Note: This skill tracks GST data but does not file returns. Consult a CA for GST filing.

### Cron Setup

# Daily invoice check (9 AM IST = 3:30 UTC)
30 3 * * * freelance-invoice-tracker daily-check

# Monthly report (1st of month, 9 AM IST)
30 3 1 * * freelance-invoice-tracker monthly-report

# GST quarterly reminder (7 days before filing due)
30 3 4 1,4,7,10 * freelance-invoice-tracker gst-reminder

### Setup Instructions

Create a Google Sheet with the structure described above
Create a Google Cloud Service Account with Sheets API access
Download the service account JSON key
Share your Google Sheet with the service account email
Set GOOGLE_SHEETS_CREDENTIALS (JSON as string) and INVOICE_SHEET_ID in OpenClaw config
Set EMAIL_PROVIDER to gmail (recommended) or smtp
Type "invoices" to verify the connection
Type "overdue" to see any currently overdue invoices

### Configuration

{
  "skills": {
    "entries": {
      "freelance-invoice-tracker": {
        "enabled": true,
        "env": {
          "GOOGLE_SHEETS_CREDENTIALS": "{...service account JSON...}",
          "INVOICE_SHEET_ID": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
          "EMAIL_PROVIDER": "gmail",
          "GMAIL_ADDRESS": "you@gmail.com",
          "REMINDER_DAYS": "1,7,14,30"
        },
        "config": {
          "defaultGSTRate": 18,
          "currency": "INR",
          "timezone": "Asia/Kolkata",
          "sendWhatsAppReminders": true,
          "finalNoticeWarningDays": 30
        }
      }
    }
  }
}
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: utsavs
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T23:46:36.618Z
- Expires at: 2026-05-08T23:46:36.618Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/freelance-invoice-tracker)
- [Send to Agent page](https://openagent3.xyz/skills/freelance-invoice-tracker/agent)
- [JSON manifest](https://openagent3.xyz/skills/freelance-invoice-tracker/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/freelance-invoice-tracker/agent.md)
- [Download page](https://openagent3.xyz/downloads/freelance-invoice-tracker)