Salary Conversion

---
name: salary-conversion
description: Use when the user wants to convert a salary between Israeli and world conventions — Israeli salaries are stated **monthly in shekels (NIS / ILS)**, while most other countries state salaries **annually in their local currency** (USD, EUR, GBP, etc.). Handles both directions. Israel → world - multiply the monthly shekel figure by 12 and convert at today's FX rate to the target currency. World → Israel - convert the annual foreign amount to shekels at today's rate, divide by 12, and round the monthly shekel result to the nearest integer (no decimals). Uses today's FX rate — doesn't need to be up-to-the-minute; a rate from the current day is sufficient. Trigger phrases - "convert this salary to USD", "what is X NIS per month in dollars", "how much is Y USD a year in shekels", "israeli salary to world salary", "שכר במונחים בינלאומיים", "convert shekel salary", "monthly shekel to annual dollar", "annual euro salary to monthly shekel".
---

# Salary Conversion (Israel ↔ World)

Converts salaries between the Israeli convention (**monthly in shekels / NIS / ILS**) and the world convention (**annual in local currency**).

## Direction 1 — Israel → world

Input: a monthly salary in shekels (e.g. `25,000 NIS/month`, `₪ 18000`, `twenty thousand shekels a month`).

Procedure:

1. Multiply the monthly shekel figure by **12** to get the annual shekel figure.
2. Fetch today's FX rate — `ILS → {target_currency}`.
3. Multiply to get the annual figure in the target currency.
4. Present the result at a reasonable precision (usually no more than 2 significant decimal places for the foreign side — `$87,234` is better than `$87,234.16`).

Example: `25,000 NIS/month` → `25,000 × 12 = 300,000 NIS/year` → at `1 ILS = 0.27 USD` → `300,000 × 0.27 = $81,000/year`.

## Direction 2 — World → Israel

Input: an annual salary in a foreign currency (e.g. `$120,000/year`, `€85k annual`, `£60,000 per annum`).

Procedure:

1. Fetch today's FX rate — `{source_currency} → ILS`.
2. Convert the annual foreign amount to annual shekels.
3. Divide by **12** to get the monthly shekel figure.
4. **Round to the nearest integer shekel** — no decimals on the shekel side. `₪ 22,471` is correct; `₪ 22,471.33` is not.

Example: `$120,000/year` → at `1 USD = 3.70 ILS` → `120,000 × 3.70 = 444,000 NIS/year` → `444,000 / 12 = 37,000 NIS/month`.

## FX rate sourcing

Use a reputable rate from **today** — it does not need to be real-time. Acceptable sources in rough order of preference:

1. A live FX API the agent can call (e.g. `https://api.frankfurter.app/latest?from=ILS&to=USD`, ECB, Bank of Israel daily reference rate).
2. A web search for "ILS USD today" / "USD ILS today" returning today's rate from a reputable source (Bloomberg, Reuters, Google Finance, XE).

Always cite the source and the rate used (e.g. `Rate used: 1 USD = 3.703 ILS (frankfurter.app, 2026-04-23)`). If the user asks the same conversion again on a different day, re-fetch rather than reusing the previous rate.

## Default assumptions (ask if unsure)

- If the user says just "shekels" or "NIS" without a time period, assume **monthly** (Israeli convention).
- If the user gives a foreign-currency figure without a time period, assume **annual** (world convention).
- If the input is ambiguous (e.g. "60k USD" — monthly or annual?), ask.
- Default target currency for Israel → world is **USD** unless the user specifies otherwise.

## Gross vs net

This skill handles **stated salary figures as given** — it does not compute Israeli tax, bituach leumi, pension, or keren hishtalmut to move between gross and net. If the user needs gross ↔ net, say so explicitly and note that's outside scope — point them to an Israeli salary calculator (e.g. `kolzchut.org.il`) or offer to do a rough estimate with named assumptions.

## Rounding

- Shekel side (both directions): always round to the nearest integer shekel. No decimals.
- Foreign side: up to the agent — 2 decimals is usually overkill; whole units or thousands is typically cleaner for salary figures.

## Out of scope

- Cost-of-living / PPP adjustments ("is ₪25k in Tel Aviv equivalent to $X in NYC lifestyle-wise"). This is purely nominal FX conversion.
- Tax / net computation.
- Historical salary conversions at a specific past date (use today's rate only).
- Signing bonuses, RSUs, equity — just base salary.