# Calculator

Evaluate mathematical expressions and unit conversions.

- Repository: https://github.com/NVIDIA/SkillEvaluator (620 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add NVIDIA/SkillEvaluator --skill calculator -g -a claude-code -y`
Codex: `npx skills add NVIDIA/SkillEvaluator --skill calculator -g -a codex -y`
Cursor: `npx skills add NVIDIA/SkillEvaluator --skill calculator -g -a cursor -y`
Gemini CLI: `npx skills add NVIDIA/SkillEvaluator --skill calculator -g -a gemini-cli -y`

## Description

Evaluate mathematical expressions and unit conversions. Handles arithmetic, percentages, exponents, and common unit conversions (temperature, distance, weight). No external dependencies.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

1. Read this SKILL.md to understand capabilities.
2. Run `scripts/calc.py` with the user's expression or conversion.
3. Return the computed result to the user.

## Examples

### Usage

```bash
# 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: 14
```

For conversions:
```
100 celsius = 212.0 fahrenheit
```

## Limitations

- 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.

## Troubleshooting

| Problem | Fix |
|---------|-----|
| `Invalid expression` | Check for unsupported operators or variables |
| `Unknown conversion` | Use supported units: celsius, fahrenheit, miles, km, kg, lbs, meters, feet |

