Freelance Toolkit Fr

What This Skill Does

The Freelance Toolkit (FR) is a comprehensive CLI-based management suite designed specifically for independent workers and micro-entrepreneurs in France. It centralizes essential administrative tasks—such as client relationship management, time tracking, professional invoice generation, and financial reporting—into a single, unified workspace. Built using Python 3, this tool operates locally to ensure user privacy, storing all sensitive data within the user's home directory under ~/.freelance/. It handles complex requirements like French legal business mentions and localized currency formatting, allowing freelancers to focus on their work rather than paperwork.

Installation

To install this skill, use the OpenClaw repository command:

clawhub install openclaw/skills/skills/hugosbl/freelance-toolkit-fr

Ensure that you have Python 3 installed on your system, as all backend processing utilizes the standard library. Once installed, initialize your configuration using the config.py script to set your professional details, SIRET number, and payment information. This will create the necessary storage structure in ~/.freelance/.

Use Cases

This toolkit is ideal for:

• Solo Consultants: Managing multiple client portfolios and ensuring rates are tracked accurately.
• Micro-Entrepreneurs: Generating compliant HTML invoices that satisfy French legal standards without the need for bloated accounting software.
• Time Tracking: Monitoring project progress to ensure billable hours are captured, which feeds directly into the performance dashboard.
• Financial Reporting: Analyzing monthly or annual revenue and comparing paid versus pending invoices for better cash flow management.

Example Prompts

1. "Check the dashboard and tell me my total revenue for 2026 and how many hours I worked for Acme."
2. "Generate a new invoice for Acme for 5 hours of 'Dev site web' at 400 euros and 1 hour of 'Design logo' at 200 euros."
3. "Start tracking time for the 'Site web Acme' project."

Tips & Limitations

• Security: Since all data is stored locally in ~/.freelance/, ensure your home directory has appropriate permissions. The tool does not store data on external clouds.
• Formatting: Ensure you provide items in the format Name:Quantity:Rate when generating invoices to avoid parsing errors.
• Scope: This tool is optimized for the French market (micro-entreprise status). It is intended for individuals and does not support complex VAT calculations or multi-user team structures. Always verify the generated invoices before sending them to clients to ensure they meet your specific professional expectations.