Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Changed the file path rules for `download-invoice-pdf`: `--output` now accepts both absolute and relative paths, as long as they end in `.pdf`. - Clarified that relative output paths are resolved against the current working directory, and output must be within an allowed media root or working directory. - Removed the previous restriction on absolute paths and `../` traversals when specifying output PDF location.
What This Skill Does
Issues and manages SmartBill invoices via the SmartBill.ro API using a local CLI script. Covers payload validation, dry-run inspection, invoice creation with confirmation gates, series lookup, and PDF download.
The CLI enforces a validate-then-dry-run-then-confirm flow that prevents accidental final invoice issuance, which the raw API does not.
When to use it
- Creating a client invoice after confirming line items
- Downloading a PDF copy of an issued invoice by series and number
- Listing available document series before issuing
- Validating an invoice JSON payload before sending to the API
- Dry-running an invoice to inspect the normalized payload without making an API call
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Issue an invoice for client Acme SRL based on invoice.json
- 1Run validate-payload on invoice.json to check structure
- 2Run create-invoice with --dry-run to inspect normalized payload
- 3Present payload to user and request explicit confirmation
- 4Run create-invoice with --allow-final to issue the invoice
- 5Capture returned series and number verbatim for logging
Invoice issued; series and zero-padded number stored in run log
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.