Skip to main content
skill CX Codex

calculator — Claude Code skill: what it does, how to install

calculator evaluates arithmetic math expressions with arbitrary-precision decimal numbers, preventing floating-point errors.

MIT 1 installs ★ 598 updated 2026-04-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Code-and-Sorts/awesome-copilot-agents --skill calculator -a claude-code
Open on GitHub

What calculator does

The tool evaluates arithmetic operations including addition, subtraction, multiplication, division, and exponents. It runs calculations through big.js so decimal additions stay accurate without floating-point drift. The parser respects parentheses and operator precedence. Exponentiation is right-associative.

Running the script requires Node.js and npm. A build step prepares the code before running evaluations.

Trigonometric functions, modulo, factorials, and variable symbols are unsupported, and exponents must remain integers.

What it helps with

  • evaluate decimal math expressions without float rounding errors
  • compute nested expressions respecting parenthetical precedence
  • raise numbers to integer powers with exact precision

Example prompts for the agent

  • Calculate the exact value of (2 + 3) * 4
  • Evaluate 1 + 4.5 * (3 - 6) / 5
  • Compute 2 ^ 10

How to install calculator

1Skills CLI (Vercel)

npx skills add Code-and-Sorts/awesome-copilot-agents --skill calculator -a claude-code

2Manually: put the files in place

~/.claude/skills/calculator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/calculator/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about calculator

How do I install calculator in Claude Code?

Run npx skills add Code-and-Sorts/awesome-copilot-agents --skill calculator -a claude-code.

What does calculator do?

It evaluates arithmetic expressions with arbitrary decimal precision using big.js to prevent standard floating-point inaccuracies.

What are the system requirements for calculator?

The tool requires Node.js and npm installed in the environment.

Source text

SKILL.md · MIT
---
name: calculator
description: Performs arbitrary-precision arithmetic calculations including addition, subtraction, multiplication, division, and exponents. Use when the user asks to calculate, compute, or evaluate math expressions, or when precise decimal arithmetic is needed to avoid floating-point errors.
license: MIT
compatibility: Requires Node.js and npm
metadata:
  author: Colby Timm
  version: "1.0"
---

# Calculator

Evaluate arithmetic expressions with arbitrary-precision decimal math using [big.js](https://github.com/MikeMcl/big.js/).

## When to Use

- User asks to calculate or evaluate a math expression
- Precise decimal arithmetic is needed (avoids floating-point errors like `0.1 + 0.2 = 0.30000000000000004`)
- Expressions involve parentheses, operator precedence, or exponents

## Supported Operations

| Operator | Description | Precedence |
| -------- | ----------- | ---------- |
| `+` | Addition | 1 |
| `-` | Subtraction | 1 |
| `*` | Multiplication | 2 |
| `/` | Division | 2 |
| `^` | Exponent (right-associative) | 3 |
| `()` | Parentheses | Highest |

## Usage

```bash
cd scripts
npm ci || npm install
npm run build
npm run calculate "<expression>"
```

## Examples

| Input | Output |
| ----- | ------ |
| `"3 + 2"` | `5` |
| `"10 / 4"` | `2.5` |
| `"2 ^ 10"` | `1024` |
| `"(2 + 3) * 4"` | `20` |
| `"1 + 4.5 * (3-6) / 5"` | `-1.7` |
| `"-5 + 3"` | `-2` |
| `"2 ^ 3 ^ 2"` | `512` (right-associative: 2^9) |

## Edge Cases

- **Empty expression**: Throws "Empty expression" error
- **Mismatched parentheses**: Throws "Mismatched parentheses" error
- **Division by zero**: big.js throws an error
- **Exponent must be integer**: big.js `.pow()` requires integer exponents

## Limitations

- No trigonometric functions (sin, cos, tan)
- No variables or symbolic math
- Exponents must be integers
- No factorial, modulo, or bitwise operators

© Colby Timm · MIT · Code-and-Sorts/awesome-copilot-agents

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set2

Project sponsors

Companies that keep this analytics open