invoice-generatorGenerate professional PDF invoices from JSON data. Use when the user needs to create an invoice, billing document, or payment request with company/client details and line items.
Install via ClawdBot CLI:
clawdbot install tmigone/invoice-generatorRequires:
Generate PDF invoices from structured JSON data.
cd invoice-generator && npm install
INVOICE_DIR environment variable (or in skills.entries.invoice-generator.env):export INVOICE_DIR="/path/to/your/invoices"
This creates the directory structure:
$INVOICE_DIR/
โโโ configs/ # Optional: saved invoice configs
โโโ invoices/ # Generated PDF output
# From stdin (on-the-fly)
cat invoice-data.json | {baseDir}/scripts/generate.sh
# From a full file path
{baseDir}/scripts/generate.sh /path/to/invoice-data.json
# From a saved config (looks in $INVOICE_DIR/configs/)
{baseDir}/scripts/generate.sh client-template
# Loads: $INVOICE_DIR/configs/client-template.json
# Output goes to: $INVOICE_DIR/invoices/invoice-{number}.pdf (auto-versions if exists)
The JSON input must contain these fields:
{
"company": {
"name": "Your Company",
"address": "123 Main St",
"cityStateZip": "City, State, 12345",
"country": "Country"
},
"client": {
"name": "Client Name",
"address": "456 Client Ave",
"cityStateZip": "City, State, 67890",
"country": "Country",
"taxId": "TAX123"
},
"invoice": {
"number": "INV-2025.01",
"date": "Jan 15 2025",
"dueDate": "Jan 30 2025"
},
"items": [
{
"description": "Service description",
"rate": "1000.00",
"currency": "USD"
}
],
"totals": {
"currency": "USD",
"total": "1,000.00"
}
}
See references/data-schema.md for complete field documentation.
The script outputs the path to the generated PDF file on success:
$INVOICE_DIR/invoices/invoice-INV-2025.01.pdf
# If that filename already exists, the script will write:
# $INVOICE_DIR/invoices/invoice-INV-2025.01-2.pdf (then -3, etc.)
Generated Mar 1, 2026
Freelancers can quickly generate professional invoices for clients after completing projects. This skill automates the creation of PDF invoices from structured project data, ensuring accurate billing details and timely payment requests. It's ideal for solo professionals managing multiple client engagements.
Small businesses can use this skill to streamline their billing processes by generating invoices for goods or services sold. It handles company and client details, line items, and totals, reducing manual entry errors. This supports efficient cash flow management for retail or service-based operations.
Consulting firms can automate invoice generation for client engagements, ensuring consistency in branding and compliance with tax requirements. The skill processes JSON data to produce detailed invoices with itemized services, aiding in transparent billing and financial reporting. It's useful for firms with recurring client projects.
Event planners can create invoices for clients covering venue rentals, catering, and other services. This skill generates PDFs with clear line items and due dates, facilitating organized payment tracking for events. It helps manage multiple vendors and client billing in a structured format.
Software developers can invoice clients for project milestones or hourly work using this skill. It allows for detailed itemization of development tasks, rates, and currencies, ensuring accurate billing for international clients. This supports agile project management and financial transparency.
Businesses offering monthly or annual services can use this skill to generate recurring invoices for subscription fees. It automates billing cycles by processing JSON data with client details and service tiers, reducing administrative overhead. This model supports steady revenue streams from ongoing client relationships.
Companies charging per project can leverage this skill to invoice clients upon completion of specific deliverables. It handles one-time payments with detailed line items for project phases, ensuring clear communication of costs. This model is common in consulting, construction, and creative industries.
Professionals billing by the hour, such as lawyers or contractors, can use this skill to generate invoices based on time logs. It processes JSON data with hourly rates and descriptions, facilitating accurate billing for variable work hours. This model supports flexible pricing for services with unpredictable durations.
๐ฌ Integration Tip
Ensure the INVOICE_DIR environment variable is set correctly and that required binaries like node and weasyprint are installed to avoid generation errors.
Query Copilot Money personal finance data (accounts, transactions, net worth, holdings, asset allocation) and refresh bank connections. Use when the user asks about finances, account balances, recent transactions, net worth, investment allocation, or wants to sync/refresh bank data.
Stripe API integration with managed OAuth. Manage customers, subscriptions, invoices, products, prices, and payments. Use this skill when users want to process payments, manage billing, or handle subscriptions with Stripe. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
QuickBooks API integration with managed OAuth. Manage customers, invoices, payments, bills, and run financial reports. Use this skill when users want to interact with QuickBooks accounting data. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Advanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest. Use when calculating investment growth, pricing strategies, loan values, discounts, or comparing financial scenarios across different rates and time periods. Includes both CLI and interactive web UI.
Track expenses via natural language, get spending summaries, set budgets
Query and manage personal finances via the official Actual Budget Node.js API. Use for budget queries, transaction imports/exports, account management, categorization, rules, schedules, and bank sync with self-hosted Actual Budget instances.