← Back to Skills Marketplace
123
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install normieclaw-invoicegen
Description
Stop paying $15/month just to generate a PDF. Tell OpenClaw 'Bill Acme Corp for 10 hours of design work at $85/hr, net 30' and get a beautifully branded invo...
Usage Guidance
What to check before installing and using InvoiceGen:
- Runtime requirements: The registry metadata lists no required binaries, but the code and README expect Python 3 and Playwright (plus a Chromium install via `playwright install chromium`). Install those intentionally — the package will not do that for you.
- Local vs networked rendering: The PDF generator uses Playwright to load a local HTML file but Playwright can fetch remote resources referenced in the HTML (images, fonts, CSS). If a logo or template includes a remote URL, rendering may make network requests (which could reveal your IP or load content you didn't expect). Use local logo files in invoices/ or ensure remote resources are trusted.
- Path & data safety: The skill enforces output paths within invoices/ and the SKILL.md prescribes sanitizing client-provided strings — follow those rules. Review how your assistant templates LOGO_PATH and client fields are populated to avoid accidental path traversal or remote URLs.
- Sensitive data storage: Do not store raw bank account numbers, full tax IDs, or plaintext secrets in business-profile.json. The package itself advises restricting file permissions (chmod 600/700). Follow that guidance and consider using reference IDs or a secure secrets mechanism if you need to include payment details.
- Optional dashboard: The dashboard notes discuss Supabase and encryption for production use. Those are optional and not implemented by the included scripts; only enable/ integrate those services if you understand the additional operational and security implications.
- Review the code: The included Python script appears well-scoped (disables JS before rendering and enforces output path checks). Still, if you will run it on sensitive data, inspect the template generation code your assistant will produce (ensure it doesn't embed remote URLs or unsanitized HTML) and run in a controlled environment initially.
If you want, I can: (a) list the exact commands to install the required runtime (Python + Playwright), (b) scan the templates for any occurrences of remote URLs, or (c) produce a short checklist to harden local usage (permissions, sandboxing, restricting logos to local files).
Capability Analysis
Type: OpenClaw Skill
Name: normieclaw-invoicegen
Version: 1.0.3
The InvoiceGen skill is a well-implemented tool for local invoice management and PDF generation. It demonstrates strong security awareness by implementing path traversal protections and disabling JavaScript execution during PDF rendering in `scripts/generate-invoice-pdf.py`. The instructions in `SKILL.md` and `SETUP-PROMPT.md` prioritize data isolation and proper file permissions (e.g., chmod 600/700), with no evidence of malicious intent, unauthorized network activity, or data exfiltration.
Capability Assessment
Purpose & Capability
The skill's name, README, SKILL.md, templates, and scripts all implement an invoicing/PDF workflow as described. However the registry metadata claims no required binaries or env vars, while the README and scripts require Python and Playwright (and a Chromium install) to render PDFs — that mismatch is an incoherence the user should be aware of.
Instruction Scope
SKILL.md keeps behavior tightly scoped to the invoices/ directory and documents path-sanitization, prompt-injection defenses, and explicit user confirmation before generating PDFs. The instructions do not ask to read unrelated system files or exfiltrate data.
Install Mechanism
There is no install spec in the registry (instruction-only), which minimizes automated install risk. The included Python script uses Playwright (a headless browser) but the package does not itself download remote code. The user must install Playwright/Chromium manually; that step will download a browser binary from upstream.
Credentials
The skill declares no required environment variables or credentials (consistent with local invoicing). The dashboard documentation mentions optional Supabase usage and advises storing keys in env vars, but those are optional and not required by the provided scripts.
Persistence & Privilege
The skill does not request 'always' inclusion and does not modify other skills. Its persistent data is confined to an invoices/ directory and local JSON/SQLite artifacts as described.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install normieclaw-invoicegen - After installation, invoke the skill by name or use
/normieclaw-invoicegen - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
v1.0.3: Security fixes: confined scripts to skill directory, removed filesystem traversal from setup
v1.0.2
v1.0.2: MIT license, cleaned descriptions, removed cross-sell
v1.0.0
Initial publish from NormieClaw.ai — Free OpenClaw skills for everyone.
Metadata
Frequently Asked Questions
What is InvoiceGen?
Stop paying $15/month just to generate a PDF. Tell OpenClaw 'Bill Acme Corp for 10 hours of design work at $85/hr, net 30' and get a beautifully branded invo... It is an AI Agent Skill for Claude Code / OpenClaw, with 123 downloads so far.
How do I install InvoiceGen?
Run "/install normieclaw-invoicegen" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is InvoiceGen free?
Yes, InvoiceGen is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does InvoiceGen support?
InvoiceGen is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created InvoiceGen?
It is built and maintained by Nollio (@nollio); the current version is v1.0.3.
More Skills