version: "1.0.2" name: calculator description: Perform deterministic arithmetic, percent-based math, and change-rate math. when_to_use: Use this skill when the user asks for exact arithmetic, percents, growth or decrease rates, discounts, markups, ratios, or numeric comparisons that should not be estimated mentally. provider_type: builtin provider_id: calculator runtime_type: tool tools:

• evaluate_expression
• calculate
• percentage

supported_callers:

• aichat
• agent
• workflow

max_calls_per_turn: 50 timeout_seconds: 5 display: icon: calculator category: general_tools scenarios:

• general
• data_insights
• office_collaboration

label: en_US: Calculator zh_Hans: 计算器 description: en_US: Designed for amounts, percentages, discounts, rates of change, and other exact calculations; performs arithmetic and numeric comparisons without relying on mental math. zh_Hans: 适用于金额、百分比、折扣、变化率等精确计算，可完成算术运算和数值比较，避免依赖模型心算。 when_to_use: en_US: Use when answers require exact calculation instead of mental math. zh_Hans: 当问题需要精确计算，而不是让模型心算时启用。 tags: en_US:

• Math
• Arithmetic

zh_Hans:

• 数学
• 精确计算

Calculator Skill

Use this skill for exact arithmetic and percentage tasks.

Workflow

1. Prefer one call_skill_tool call with tool_name set to evaluate_expression when the task can be represented as one arithmetic expression.
2. For totals followed by discounts, markups, taxes, or fixed reductions, fold the full final arithmetic into one expression whenever the condition is clear from the problem statement.
3. If a condition must be verified numerically first, use at most two expression calls: one for the condition value and one for the final result.
4. Use calculate only when a single binary operation is clearer than a full expression.
5. Use percentage only when the user asks specifically for percent-of, percentage change, or applying a percentage increase/decrease and a single expression would be less clear.
6. Before calling evaluate_expression, convert the calculation into a pure numeric expression with ASCII operators. Remove units, natural-language notes, labels, thousands separators, and non-standard operators such as × or ÷.
7. Do not calculate mentally when the user expects an exact result.
8. In the final answer, include a concise summary of the calculation process and the result.
9. Mention rounding when a precision value affects the displayed result.

Tool Usage

evaluate_expression accepts:

• expression: a restricted arithmetic expression using numbers, parentheses, +, -, *, /, %, and ^.
• precision: optional decimal places from 0 to 12.

Use decimal percentages inside expressions. For example, use 0.85 for an 85 percent multiplier and 0.15 for a 15 percent decrease.

Example for a grocery total with a fixed reduction and member discount:

• expression: (9.5*10 + 4.8*15 + 15*5 - 30) * 0.85
• precision: 2

calculate accepts:

• operation: add, subtract, multiply, divide, power, or mod.
• left: left operand.
• right: right operand.
• precision: optional decimal places from 0 to 12.

percentage accepts:

• operation: percent_of, change, apply_increase, or apply_decrease.
• value: base value for percent_of, apply_increase, and apply_decrease.
• percent: percentage value, for example 15 means 15 percent.
• from: original value for change.
• to: new value for change.
• precision: optional decimal places from 0 to 12.