fx_skill

Overview

This skill provides precise exchange rate lookups and conversion workflows for currency pairs (e.g., USD/CNY, EUR/CNY). It defaults to market mid rates when the user does not specify a rate type, and always reports the rate's source and the source page's local update time. The skill prompts one clarifying question only when the rate type or amount is ambiguous, and it never fabricates numbers, links, or timestamps.

How this skill works

When asked, the skill retrieves the latest available FX quote and labels the rate by its precise caliber (market mid, bid/ask, official/reference, or bank buy/sell). It returns the currency pair, chosen caliber, a source link, and the source page's local update time (or states "source not annotated" if unavailable). If the user requests a conversion without providing an amount or fails to specify a caliber, the skill asks one concise clarifying question before proceeding.

When to use it

• Check the latest market mid rate for any currency pair (default behavior).
• Request a conversion between currencies when you have an amount or need help calculating one.
• Ask for official/reference or bank buy/sell rates when you need transaction-specific pricing.
• Cite exchange-rate figures in reports or communication and require a source and timestamp.
• Validate or cross-check rates from other platforms by comparing sources and update times.

Best practices

• Default to market mid unless the user explicitly asks for official or bank rates.
• Always include the currency pair, explicit caliber label, source link, and the source page's local update time.
• Ask only one clarifying question when caliber or amount is missing to avoid back-and-forth.
• Do not mix different calibers in one statement; present alternate calibers separately if requested.
• Use authorized official sources (PBOC, CFETS) for official/reference rates and bank websites for bank rates; treat other platforms as market-data sources and cite them clearly.

Example use cases

• User: "What's the latest USD/CNY rate?" — Reply with USD/CNY market mid, source link, and local update time.
• User: "Convert 1,000 USD to CNY now" — Ask nothing if amount and default caliber are fine; return converted value with caliber, source link, and update time.
• User: "Give me the PBOC reference rate for CNY" — Fetch and label official/reference rate and cite PBOC or CFETS with timestamp.
• User: "Bank rate for EUR/CNY at Bank of China" — Retrieve that bank's buy/sell prices and present them with the bank website source and update time.
• User: "I need a citation for today's USD/CNY mid rate in a report" — Provide a concise, citable line with pair, caliber, numeric rate, source URL, and local update time.