| 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:
- Multiply the monthly shekel figure by 12 to get the annual shekel figure.
- Fetch today's FX rate —
ILS → {target_currency}.
- Multiply to get the annual figure in the target currency.
- 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:
- Fetch today's FX rate —
{source_currency} → ILS.
- Convert the annual foreign amount to annual shekels.
- Divide by 12 to get the monthly shekel figure.
- 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:
- 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).
- 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.
