A lightweight, pure Python CLI tool to calculate tips and split bills among multiple people with zero external dependencies.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install cn-tip-calculator
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 cn-tip-calculator 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 Tip Calculator?
The Tip Calculator is a lightweight command-line interface (CLI) tool designed to simplify dining and entertainment expense management. Built entirely using the Python standard library, this utility allows users to quickly determine tip amounts, customize gratuity percentages, and calculate individual shares for split bills without requiring external dependencies or third-party API keys.
As a highly practical addition to Openclaw Skills, this tool integrates seamlessly into developer workflows, automation scripts, and conversational AI agents. It provides offline-first, private, and deterministic calculations, making it an ideal utility for quick financial computations on the go.
Tip Calculator Use Cases
- Restaurant Bill Splitting: Instantly divide a large restaurant or bar tab among multiple dining companions.
- Custom Gratuity Calculation: Apply specific tip percentages (like 15%, 18%, 20%, 25%, or custom values) based on service quality.
- Automated Expense Reporting: Integrate with CLI workflows to log food and beverage expenses accurately for business trips.
- AI Agent Tool Integration: Use as a functional tool for local AI agents or assistants operating within Openclaw Skills to perform basic financial arithmetic.
How Tip Calculator Works
- Input Parameters: The user provides the base bill amount, the desired tip percentage, and the optional number of people splitting the bill.
- Tip Calculation: The script calculates the exact tip amount based on the percentage provided.
- Total Consolidation: The tip is added to the original bill to compute the grand total.
- Bill Splitting: If a split count is specified, the script divides the grand total equally by the number of participants.
- Structured Output: The final results (tip amount, total amount, and per-person cost) are formatted and printed directly to the terminal.
Tip Calculator Setup
No complex installation is needed since this tool utilizes the pure Python standard library. Simply ensure you have Python 3 installed.
Clone the repository or download the script:
# Navigate to your script folder
cd scripts
# Run with base bill and custom tip
python3 tip_calculator.py --bill 85.50 --tip 18
# Run with bill splitting enabled
python3 tip_calculator.py --bill 120.00 --tip 20 --split 4
Tip Calculator Data Schema & Taxonomy
The Tip Calculator script processes arguments directly from the command line and returns structured, human-readable terminal output.
Command Line Arguments
| Parameter | Type | Required | Description |
|---|---|---|---|
--bill |
Float | Yes | The total pre-tip bill amount (e.g., 85.50). |
--tip |
Integer | Yes | The tip percentage (e.g., 18 for 18%). |
--split |
Integer | No | The number of people to divide the bill among (default: 1). |
Expected Output Format
When executed, the script outputs the calculated breakdown:
- Tip Amount: Calculated gratuity based on the input percentage.
- Total Bill: The sum of the original bill and the tip.
- Per Person: Individual share when splitting (only shown if
--splitis greater than 1).
Tip Calculator Advanced Features
- Zero-Dependency Execution: Runs natively on any system with Python 3, ensuring lightweight and secure operations.
- Offline Capability: No network or API connections required, keeping all financial inputs secure and private on your local machine.
- Flexible Integration: Easily combined with shell scripts or integrated as an extensible function within larger Openclaw Skills environments.
- Precise Decimal Formatting: Ensures clean currency display without floating-point precision issues common in basic calculators.
SKILL.md
Loading
Related Openclaw Skills
cn-whitespace-cleaner
A lightweight, dependency-free command-line tool to strip redundant spaces, unwanted tabs, and excess line breaks from your text inputs and files.
Unicode Info
A local, zero-dependency Python tool for inspecting Unicode character codepoints, official names, and categories.
Web Image Optimizer
A local image compression tool and AI agent skill that automatically processes, resizes, and converts images to meet targeted file sizes for optimal web performance.
URL Health Checker
A lightweight, zero-dependency Python tool for diagnosing URL accessibility, following redirect chains, and resolving HTTP status errors.
cn-text-reverser
A zero-dependency Python tool for reversing multi-byte text sequences globally or character-by-character.
Text Encoding Detector
A lightweight, pure-Python utility to automatically detect text file encodings and BOM markers without external dependencies.
Featured*
