skills.rest
amitpo23
amitpo23COMMUNITY
Explore all skills by this author →
GitHub

shekel-currency-converter

Convert currencies to and from Israeli Shekels using Bank of Israel representative rates.

Updated Jan 9, 2026
Search Tags:#exchange rate#currency conversion#israeli tax#bank of israel#shekel#nis#shaar yatzig
One-click install
npx skills add https://github.com/amitpo23/cfo --skill shekel-currency-converter-amitpo23
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shekel-currency-converter
Source: https://github.com/amitpo23/cfo/tree/main/.claude/skills/shekel-currency-converter
Command: npx skills add https://github.com/amitpo23/cfo --skill shekel-currency-converter-amitpo23

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Israeli tax and accounting rules require foreign-currency amounts to be converted at the official Bank of Israel representative rate (shaar yatzig) for the specific transaction date, not a live forex quote. This Skill fetches the correct current or historical rate and performs the conversion so filings use the legally valid figure. ## Core Features & Use Cases - Live rate conversion: Fetches current representative rates from the Bank of Israel JSON endpoint for all 14 published currencies and converts amounts to or from NIS. - Historical tax-date rates: Queries the BOI SDMX EXR series for a specific past date, automatically walking back over weekends and holidays to the most recent published rate. - Tax-rule guidance: Distinguishes income-date, payment-date, and year-end revaluation rates, and warns that import VAT uses the weekly customs rate (representative rate plus 0.5%), not the bare representative rate. - Use Case: A user asks "What was the dollar rate on January 1, 2026 for my VAT report?" The Skill queries the SDMX series, finds no publication on that holiday, and reports the December 31, 2025 rate with the date clearly stated. ## Quick Start Ask the assistant to convert 1000 US dollars to shekels at today's Bank of Israel representative rate, optionally specifying a historical date for tax purposes.

Frequently Asked Questions about shekel-currency-converter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert USD to shekels at the official Bank of Israel rate?▼

Fetch the live JSON endpoint at boi.org.il/PublicApi/GetExchangeRates, read the USD entry's currentExchangeRate and unit, then multiply the dollar amount by rate divided by unit. The bundled fetch_rates.py script performs this conversion directly from the command line.

How do I get a historical Bank of Israel exchange rate for a specific date?▼

Use the BOI SDMX EXR series at edge.boi.gov.il with the pattern RER_<CUR>_ILS, startPeriod, endPeriod, and format=csv, reading OBS_VALUE by TIME_PERIOD. The JSON endpoint's date parameter is ignored and always returns today's rate.

Which currencies does the Bank of Israel publish representative rates for?▼

The Bank of Israel publishes a representative rate for exactly 14 currencies: USD, GBP, JPY, EUR, AUD, CAD, DKK, NOK, ZAR, SEK, CHF, JOD, LBP, and EGP. Other currencies require conversion through USD or EUR as an intermediate.

Why is there no exchange rate for my requested date?▼

The Bank of Israel publishes no rates on Saturdays, Sundays, or Israeli holidays, so those dates have no observation. Use the most recent published date on or before the requested date and state which date's rate was used.

Can I use the representative rate for import VAT calculations?▼

No. Import VAT and customs use the weekly customs rate (shaar hamekhes) set by the Israel Tax Authority on the import declaration, which is the BOI representative rate plus 0.5%. The plain representative rate is not valid for import VAT.

Does the shekel converter work offline or without network access?▼

Live and historical conversions require network access to the Bank of Israel APIs. The script offers an explicit --demo flag that uses clearly labeled illustrative sample rates, but it never substitutes sample data for a real conversion on a fetch failure.

Related Skills

Explore More Finance & Accounting Skills→
ricablericable

invoice-organizer

Extract invoice data, rename files, and sort receipts into tax-ready folders.

Community
Advanced
aiunlocked1412aiunlocked1412
14

bookkeeper-pro

Create double-entry journal entries and reconcile bank and ledger balances for SME bookkeeping.

Community
Advanced
OneWave-AIOneWave-AI
245

tax-strategy-optimizer

Analyze pre-tax versus Roth retirement contributions to reduce tax liability.

Official
Basic
dkyazzentwatwadkyazzentwatwa
86

currency-converter

Convert currency amounts between 150+ currencies using real-time and historical exchange rates.

Community
Intermediate