Freelance Invoice

What This Skill Does

The Freelance Invoice skill is a professional-grade document generation tool designed to transform raw transaction data into clean, formatted PDF invoices. By leveraging headless browsers like Puppeteer or command-line utilities like wkhtmltopdf, this skill automates the tedious aspects of financial administration. It handles multi-currency support, tax calculation, subtotaling, and professional layout design without requiring external SaaS subscriptions or complex API keys. It acts as an internal engine within your AI agent, ensuring you can bill clients, track financial documentation, and maintain brand consistency through custom templates while keeping all sensitive data local.

Installation

To integrate this skill into your environment, run the following command within your terminal: clawhub install openclaw/skills/skills/sa9saq/freelance-invoice Ensure your local environment has Node.js 18+ installed. While Puppeteer is recommended for superior visual rendering, you may install wkhtmltopdf as a lightweight alternative if system resources are constrained. Always verify your system path permits the execution of these rendering binaries.

Use Cases

This skill is perfect for independent contractors and small business owners who need to generate invoices on the fly. It is ideal for:

• Freelancers issuing monthly retainers or project-based milestones.
• Consultants tracking hours and applying specific tax percentages per jurisdiction.
• Small agencies requiring consistent document branding across client portfolios.
• Automated billing systems that need to generate receipts triggered by project completions.

Example Prompts

1. "Generate a new invoice for 'Design Services' for client 'Acme Corp'. I worked 10 hours at $75/hour. Use tax rate 8.5%, today's date, and invoice number INV-2025-001."
2. "Create an invoice to 'Tech Solutions Ltd' for $2,000 for software development. Please use the Euro currency, include a 20% VAT line, and add a note thanking them for their business."
3. "Prepare an invoice for my client in Japan. Charge 50,000 JPY for 'Consulting', and include my bank details: Bank Name, SWIFT code, and Account Number. Please save it as a PDF."

Tips & Limitations

To maximize the utility of this skill, ensure that all currency symbols and tax rates are explicitly provided to avoid rounding errors. For recurring invoices, keep a history of your naming conventions to avoid duplicate invoice numbers.

Limitations: This skill does not store your financial history in a database; it is a document generation tool. You are responsible for the safe storage of the generated PDF files. Furthermore, ensure you sanitize all input data before generation to prevent XSS vulnerabilities if you are using custom HTML templates. If Puppeteer fails due to sandbox restrictions, verify your Docker or local OS permissions, or fallback to the wkhtmltopdf binary.