calculator

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

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

2. Extract the numbers from the user's request

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

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

5. Present the result clearly with the operation performed

Examples

Example 1: Addition

Input: "What is 15 + 27?" Steps:

1. Operation: Addition
2. Numbers: 15 and 27
3. Calculation: 15 + 27 = 42 Output: "The sum of 15 and 27 is 42"

Example 2: Division

Input: "Divide 100 by 4" Steps:

1. Operation: Division
2. Numbers: 100 and 4
3. Calculation: 100 ÷ 4 = 25 Output: "100 divided by 4 equals 25"

Example 3: Multiplication with decimals

Input: "Calculate 3.5 times 8" Steps:

1. Operation: Multiplication
2. Numbers: 3.5 and 8
3. 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:

1. Operation: Division
2. Numbers: 10 and 0
3. 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