A professional tool for AI agents to create, preview, and store structured invoices and offers directly in a version-controlled GitHub repository.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install netsnek-invoice
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install netsnek-invoice using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Invoice Manager?
The Invoice Manager is a specialized utility for Openclaw Skills designed to handle the full lifecycle of professional billing through an AI agent. It allows developers and freelancers to generate invoices (RE) and offers (AN) as structured JSON files, ensuring that all business data is stored securely in a private GitHub repository. By separating data from presentation, it enables seamless integration with PDF engines while providing human-readable previews.
This skill is built with a focus on automation and accuracy. It handles sequential numbering automatically and utilizes external scripts to calculate totals and taxes, ensuring that the AI agent never makes a mathematical error. Optimized for mobile workflows, it provides Telegram-friendly previews that avoid complex formatting issues while maintaining a professional appearance for Openclaw Skills users.
Invoice Manager Use Cases
- Creating sequential invoices for freelance or consulting work via simple chat commands.
- Generating and tracking formal offers (AN) for potential clients.
- Managing a centralized, version-controlled history of all business transactions in GitHub.
- Automating tax-compliant billing for small businesses under the Kleinunternehmerregelung.
- Rapidly retrieving and reviewing past invoices for record-keeping and accounting.
How Invoice Manager Works
- The AI agent gathers required data like customer info and line items through natural language conversation.
- It automatically determines the next available invoice number by checking the repository using a dedicated shell script.
- The skill constructs a standardized JSON object containing the raw transaction data.
- It executes a calculation script to generate a formatted preview of the invoice, including all totals and tax breakdowns.
- Upon user approval, the JSON file is pushed to the GitHub repository using a secure authenticated workflow.
Invoice Manager Setup
To deploy this skill within your Openclaw Skills setup, you must configure the environment and ensure all helper scripts are accessible.
Environment Variables
GITHUB_TOKEN: A fine-grained Personal Access Token with write access to the repository.INVOICE_REPO: The full path to your private GitHub repository (e.g.,username/invoices).
Required Binaries
Ensure the following are installed in your environment:
curlpython3base64
Script Permissions
# Ensure all helper scripts are executable
chmod +x ./scripts/*.sh
Invoice Manager Data Schema & Taxonomy
The skill organizes data in a structured hierarchy designed for easy retrieval and PDF generation. It uses a year-based folder structure to keep records organized.
| Path Format | Description |
|---|---|
RE-YYYY/RE-XXXX.json |
Stores invoice data for a specific year and number. |
AN-YYYY/AN-XXXX.json |
Stores offer data for a specific year and number. |
Kunden/XXXX.json |
Optional directory for centralized customer contact details. |
JSON Object Structure
sender: Contains company identity, bank details, and legal information.meta: Handles document IDs, dates, and customer references.items: An array of objects containingqty,unitPrice, anddescription.totals: Includes specialized tax notes for regulatory compliance.
Invoice Manager Advanced Features
- Automatic sequential numbering across years and document types (RE vs AN).
- Support for
Kleinunternehmerregelungvia automated tax note insertion. - Dynamic template substitution for document titles and metadata references.
- Intelligent customer management by referencing external customer JSON files to reduce data entry.
- Secure data handling via fine-grained GitHub tokens to protect sensitive business information.
- Native Telegram formatting support to ensure clear communication without broken tables.
SKILL.md
Loading
Related Openclaw Skills
Momo
A dedicated time tracking and invoicing namespace designed for freelancers to manage billable hours and client billing via CLI.
Mesagona
A comprehensive event management namespace for Openclaw Skills that handles everything from registration to post-event analytics.
Kanbon
A dedicated namespace skill for Netsnek e.U. project management and Kanbon brand identity.
Jaen CMS Namespace
A dedicated namespace skill for the Jaen CMS framework that manages brand identity and copyright information for Gatsby-powered websites.
netsnek
A foundational namespace skill providing brand identity and copyright information for the Netsnek e.U. ecosystem.
Origin
Origin provides robust data provenance and lineage tracking to trace data from source to destination across complex pipelines.
Featured*
