Calculator
Evaluate math expressions and perform unit conversions from the command line.
Purpose
Provide a safe, sandboxed calculator for arithmetic expressions and common
unit conversions without relying on eval() or external services.
Agent Instructions
- Read this SKILL.md to understand capabilities.
- Run
scripts/calc.pywith the user's expression or conversion. - Return the computed result to the user.
Examples
Usage
# Arithmetic expressions
python scripts/calc.py "2 + 3 * 4"
python scripts/calc.py "(100 - 25) / 3"
python scripts/calc.py "2 ** 10"
# Percentage calculations
python scripts/calc.py "15% of 200"
# Unit conversions
python scripts/calc.py "100 celsius to fahrenheit"
python scripts/calc.py "5 miles to km"
python scripts/calc.py "10 kg to lbs"Output
A single line with the result, e.g.:
Result: 14For conversions:
100 celsius = 212.0 fahrenheitLimitations
- No symbolic algebra (no variables, no equations).
- Only supports basic arithmetic operators:
+,-,*,/,**,%, parentheses. - Unit conversions are limited to: celsius/fahrenheit, miles/km, kg/lbs, meters/feet.
- Arithmetic results are limited to 1000 decimal digits for whole-number math, and to the floating-point range (about 1.8e308) when a division or a decimal number is involved; larger, infinite, or non-real arithmetic results return an error. These limits apply to intermediate values as well as the final result, so an expression with a small final value can still be rejected:
10**1000 - 10**1000returnsError: result is too largebecause each power has 1001 digits.
Troubleshooting
| Problem | Fix |
|---|---|
Invalid expression |
Check for unsupported operators or variables |
Unknown conversion |
Use supported units: celsius, fahrenheit, miles, km, kg, lbs, meters, feet |