Shelly Invoice Generator

What This Skill Does

The Shelly Invoice Generator is a specialized automation tool designed to streamline the billing lifecycle for freelancers, consultants, and small business owners. Instead of manually creating documents in complex accounting software, users can generate professional, print-ready invoices directly from the command line or an AI-driven terminal environment. The skill handles the calculations for line-item totals, tax application, and date management, outputting the result in either clean Markdown for documentation or polished HTML for client delivery.

Installation

To begin using the Shelly Invoice Generator, ensure you have the OpenClaw agent environment configured. Execute the following command in your terminal to install the skill from the official repository:

clawhub install openclaw/skills/skills/claudiodrusus/shelly-invoice-generator

Once installed, the ./generate-invoice.sh executable will be available within your skill directory. Ensure your environment has basic shell permissions to execute scripts.

Use Cases

• Freelance Invoicing: Quickly bill clients for hours worked or project milestones immediately upon project delivery.
• Documentation Automation: Maintain a history of billable items in Markdown format within project repositories for better auditing.
• Client Billing Portals: Use the HTML format output to generate documents that can be attached to emails or hosted as static invoice pages.
• Batch Processing: Integrate the script into automated workflows to generate invoices programmatically after specific tasks are completed.

Example Prompts

1. "Generate a markdown invoice for Acme Corp, email [email protected], with 10 hours of web development at 150/hr and a 10% tax rate."
2. "Create an HTML invoice for Design Review services for Bob, using today's date, 5 hours at 120/hr, and save it as invoice-march.html."
3. "Draft a professional invoice for Shelly Labs from my project logs for 40 hours of development at 150 per hour, including a custom invoice number INV-2026-001."

Tips & Limitations

• Item Formatting: Always use the pipe separator (Description|Qty|Rate) precisely as requested. The script is sensitive to these delimiters.
• Tax Handling: The tax parameter is a percentage; ensure you only provide the numeric value (e.g., use 10 for 10%, not 0.10).
• Templates: When using the HTML format, ensure the template.html file is present in the working directory; otherwise, the output may not render as expected.
• Limitations: The skill currently does not support multi-currency conversion or automated payment processing; it focuses solely on the generation of the document itself.