calculator-skill
Mathematical calculation skill for computing arithmetic expressions, trigonometry, logarithms, and complex math. Use EXCLUSIVELY for math calculations: sin, cos, tan, sqrt, log, exponents, etc.
When & Why to Use This Skill
The Calculator Skill is a high-precision mathematical utility designed for Claude agents to execute complex arithmetic, trigonometric, and logarithmic computations. By integrating this skill, AI agents can move beyond simple estimation to provide exact numerical results for scientific, financial, and technical queries, ensuring reliability in data-heavy workflows.
Use Cases
- Scientific & Engineering Calculations: Solve advanced problems involving trigonometry (sin, cos, tan), square roots, and unit conversions between radians and degrees.
- Financial Modeling: Perform precise calculations for compound interest, depreciation, and risk assessment using exponents and logarithmic functions.
- Educational Support: Assist students and researchers by evaluating multi-step mathematical expressions and providing accurate solutions to algebraic problems.
- Data Processing: Use as a backend utility to normalize numerical data, calculate absolute values, and process constants like Pi and Euler's number within automated scripts.
| name | calculator-skill |
|---|---|
| description | "Mathematical calculation skill for computing arithmetic expressions, trigonometry, logarithms, and complex math. Use EXCLUSIVELY for math calculations: sin, cos, tan, sqrt, log, exponents, etc." |
| license | MIT |
| author | example-author |
| version | "1.0.0" |
Calculator Skill
A specialized mathematical calculator skill for computing arithmetic expressions, trigonometric functions, logarithms, and advanced math operations.
⚠️ IMPORTANT: Use This Skill For Math Calculations ONLY
This skill is designed EXCLUSIVELY for mathematical calculations. Use it when:
- The user asks to calculate or compute mathematical expressions
- Trigonometric operations are needed (sin, cos, tan, radians, degrees)
- Basic arithmetic is required (addition, subtraction, multiplication, division)
- Advanced operations are needed (exponents, square roots, logarithms)
- Complex expressions need to be evaluated
- Keywords: calculate, compute, math, trigonometry, sin, cos, tan, sqrt, log, radians
Supported Operations
Basic Arithmetic
- Addition:
5 + 3 - Subtraction:
10 - 4 - Multiplication:
6 * 7 - Division:
20 / 4
Trigonometric Functions ⭐
sin(x)- Sine of x (x in radians)cos(x)- Cosine of x (x in radians)tan(x)- Tangent of x (x in radians)radians(x)- Convert degrees to radiansdegrees(x)- Convert radians to degrees
Advanced Operations
- Exponentiation:
2 ** 8(2 to the power of 8) - Square root:
sqrt(16) - Logarithms:
log(100),log10(100) - Absolute value:
abs(-5)
Constants
- Pi:
pi(3.14159...) - Euler's number:
e(2.71828...)
For a complete list of all available functions, see references/functions.md.
How to Use
- Identify the mathematical operation the user wants to perform
- Format the expression as a valid mathematical expression
- Run the calculation script with the expression as an argument
- Return the result to the user
Running the Script
python scripts/calculate.py "expression"
Quick Examples
Trigonometry (This Skill's Specialty!) ⭐
python scripts/calculate.py "sin(radians(30))"
# Result: 0.5
python scripts/calculate.py "cos(0)"
# Result: 1.0
python scripts/calculate.py "tan(radians(45))"
# Result: 1.0
Basic Calculation
python scripts/calculate.py "125 + 237"
# Result: 362
Complex Expression
python scripts/calculate.py "2**10 / 4"
# Result: 256.0
For more detailed examples across different domains, see references/examples.md.
Additional Resources
- references/REFERENCE.md - Complete technical reference and implementation details
- references/functions.md - Full list of supported mathematical functions
- references/examples.md - Domain-specific calculation examples
Edge Cases and Error Handling
The script handles common mathematical errors:
- Division by zero: Returns an error message
- Invalid expressions: Reports syntax errors clearly
- Undefined operations: Catches mathematical domain errors
- Invalid input: Validates the expression before evaluation
Safety
The script uses Python's restricted eval() to safely evaluate mathematical expressions without executing arbitrary code. Only mathematical operations are allowed.