| name | calculator |
| description | Performs basic arithmetic operations including addition, subtraction, multiplication, and division. Use when the user needs to calculate numerical results, perform math operations, or solve arithmetic problems. |
| license | MIT |
| metadata | {"author":"agent-skills-poc","version":"1.0","category":"math"} |
Calculator Skill
This skill performs basic arithmetic calculations.
When to Use
Use this skill when:
- The user asks to perform mathematical calculations
- Addition, subtraction, multiplication, or division is needed
- Numerical results need to be computed
- The user mentions terms like "calculate", "add", "subtract", "multiply", "divide", "sum", "difference", "product", or "quotient"
Instructions
-
Identify the operation the user wants to perform:
- Addition: combining two or more numbers
- Subtraction: finding the difference between numbers
- Multiplication: repeated addition or scaling
- Division: splitting into equal parts
-
Extract the numbers from the user's request
-
Perform the calculation:
- For addition: Add all numbers together
- For subtraction: Subtract the second number from the first
- For multiplication: Multiply the numbers together
- For division: Divide the first number by the second
-
Handle edge cases:
- Division by zero: Return an error stating "Division by zero is not allowed"
- Very large numbers: Use appropriate precision
- Decimal numbers: Maintain precision to at least 2 decimal places
-
Present the result clearly with the operation performed
Examples
Example 1: Addition
Input: "What is 15 + 27?"
Steps:
- Operation: Addition
- Numbers: 15 and 27
- Calculation: 15 + 27 = 42
Output: "The sum of 15 and 27 is 42"
Example 2: Division
Input: "Divide 100 by 4"
Steps:
- Operation: Division
- Numbers: 100 and 4
- Calculation: 100 ÷ 4 = 25
Output: "100 divided by 4 equals 25"
Example 3: Multiplication with decimals
Input: "Calculate 3.5 times 8"
Steps:
- Operation: Multiplication
- Numbers: 3.5 and 8
- Calculation: 3.5 × 8 = 28
Output: "3.5 multiplied by 8 equals 28"
Example 4: Division by zero (error case)
Input: "What is 10 divided by 0?"
Steps:
- Operation: Division
- Numbers: 10 and 0
- Detect division by zero
Output: "Error: Division by zero is not allowed. Please provide a non-zero divisor."
Common Edge Cases
- Division by zero: Always check if the divisor is zero before performing division
- Negative numbers: Handle negative results appropriately
- Decimal precision: Round results to a reasonable number of decimal places (typically 2-4)
- Very large numbers: Be aware of potential overflow issues
- Multiple operations: If the user requests multiple operations, perform them in the correct order (following PEMDAS/BODMAS if applicable)
Tips
- Always confirm the operation and numbers with the user if ambiguous
- Show your work when helpful for understanding
- Use clear mathematical notation in your response
- For complex expressions, break them down into simpler steps
