commerce-currency
Manage currency settings and exchange rates. Use when running `stateset-currency` or converting amounts.
SKILL.mdskills/commerce-currency/SKILL.md
GitHubCommerce Currency
Handle exchange rates and currency settings for global commerce operations.
How It Works
- Configure the base currency for the store (e.g.,
USD). - Enable supported currencies and set exchange rates.
- Convert amounts between currencies using current rates.
- Format values with locale-appropriate symbols and decimal places.
- Report rate history and conversion audit trail.
Usage
- CLI:
stateset-currency ...orstateset "convert 100 USD to EUR" - Writes require
--apply. - MCP tools:
get_exchange_rate,list_exchange_rates,convert_currency,set_exchange_rate,set_base_currency,enable_currencies,format_currency.
Permissions
- Read:
get_exchange_rate,list_exchange_rates,convert_currency,format_currency— no--applyneeded. - Write:
set_exchange_rate,set_base_currency,enable_currencies— requires--apply.
Examples
stateset "convert 100 USD to EUR"
stateset --apply "set exchange rate USD/EUR 0.92"
stateset "list enabled currencies"
Status Flows
Exchange Rate: Draft -> Active -> Expired (or Superseded) Currency: Disabled -> Enabled -> Active (or Disabled)
Output
{"amount":100.00,"from":"USD","to":"EUR","converted":92.00,"rate":0.9200,"rate_date":"2025-01-15T12:00:00Z","order_id":"ord_456","status":"converted","sku":"WIDGET-001"}
Present Results to User
- Exchange rate used, source, and timestamp.
- Converted totals with proper formatting and decimal precision.
- Any base currency changes and their downstream effects.
- Enabled currency list if modified.
Troubleshooting
- Rate missing: set a rate with
set_exchange_rateor enable the currency pair. - Precision issues: use correct decimal places per currency (e.g., 0 for JPY, 2 for USD).
- Stale rates: verify
rate_dateand update if older than acceptable threshold. - Base currency change: existing prices and amount values are not auto-converted; recalculate manually.
Error Codes
CURRENCY_RATE_MISSING: No exchange rate found for the requested currency pair.CURRENCY_PRECISION_INVALID: Decimal precision does not match the target currency standard.CURRENCY_RATE_STALE: Exchange rate is older than the acceptable freshness threshold.
Related Skills
- commerce-tax — cross-border tax calculation requires currency conversion
- commerce-payments — multi-currency payment processing
- commerce-invoices — invoice amounts in customer currency
References
- references/currency-commands.md
- /home/dom/stateset-icommerce/cli/.claude/agents/currency.md