← Back to Skills Marketplace
bytesagain-lab

Currconv

by bytesagain-lab · GitHub ↗ · v3.0.1 · MIT-0
cross-platform ✓ Security Clean
324
Downloads
0
Stars
2
Active Installs
10
Versions
Install in OpenClaw
/install currconv
Description
Convert currencies using frankfurter.app free API. Use when converting amounts, checking exchange rates, or viewing rate history. Requires curl.
README (SKILL.md)

CurrConv

A real currency converter using live exchange rates from the European Central Bank via the free frankfurter.app API. Convert currencies, check rates, list available currencies, and look up historical exchange rates. No API key required.

Commands

Command Description
currconv convert \x3Camount> \x3Cfrom> \x3Cto> Convert an amount from one currency to another using live rates
currconv rates \x3Cbase> Show all exchange rates for a base currency (default: EUR)
currconv list List all available currencies with full names
currconv history \x3Cfrom> \x3Cto> \x3Cdate> Get a historical exchange rate with comparison to today
currconv version Show version
currconv help Show available commands and usage

Requirements

  • Bash 4+ (set -euo pipefail)
  • curl — for API requests
  • python3 — for JSON parsing and number formatting
  • Internet connection (calls frankfurter.app API)
  • No API key required (free, public API)

When to Use

  1. Quick currency conversion — currconv convert 100 USD EUR for instant conversion
  2. Checking exchange rates — currconv rates USD shows all rates against the dollar
  3. Available currencies — currconv list shows all 30+ supported currencies
  4. Historical rates — currconv history USD EUR 2024-01-15 with comparison to today's rate
  5. Travel planning — Convert amounts between currencies before a trip

Examples

# Convert 100 USD to EUR
currconv convert 100 USD EUR

# Convert 5000 JPY to GBP
currconv convert 5000 JPY GBP

# Convert 1000 CNY to USD
currconv convert 1000 CNY USD

# Show all rates for USD
currconv rates USD

# Show all rates for EUR (default)
currconv rates

# List all available currencies
currconv list

# Get historical rate for a specific date
currconv history USD EUR 2024-01-15

# Historical GBP to JPY rate
currconv history GBP JPY 2023-06-01

Example Output

$ currconv convert 100 USD CNY
┌───────────────────────────────────────────────────┐
│  Currency Conversion                              │
├───────────────────────────────────────────────────┤
│  100.00         USD                                │
│  =                                                 │
│  688.82         CNY                                │
├───────────────────────────────────────────────────┤
│  Rate:  1 USD  = 6.888200   CNY                    │
│  Date:  2026-03-18                                 │
│  Source: European Central Bank                     │
└───────────────────────────────────────────────────┘

$ currconv history USD EUR 2024-01-15
┌───────────────────────────────────────────────────┐
│  Historical Exchange Rate                         │
├───────────────────────────────────────────────────┤
│  Pair:       USD → EUR                             │
│  Date:       2024-01-15                            │
│  Rate:       1 USD  = 0.91234 EUR                  │
├───────────────────────────────────────────────────┤
│  Today:      1 USD  = 0.92150 EUR                  │
│  Change:     +0.009160 (+1.00%)                    │
│  Today date: 2026-03-18                            │
├───────────────────────────────────────────────────┤
│  Source: European Central Bank                     │
└───────────────────────────────────────────────────┘

Supported Currencies

Run currconv list for the full list. Common currencies include:

  • USD — US Dollar
  • EUR — Euro
  • GBP — British Pound
  • JPY — Japanese Yen
  • CNY — Chinese Yuan
  • AUD — Australian Dollar
  • CAD — Canadian Dollar
  • CHF — Swiss Franc
  • KRW — South Korean Won
  • SGD — Singapore Dollar

30+ currencies supported in total, all sourced from the European Central Bank.

Data Source

All exchange rates come from the European Central Bank via the free frankfurter.app API. Rates are typically updated once per business day. No API key or registration required.

Powered by BytesAgain | bytesagain.com | [email protected]

Data Storage

Rate cache stored in ~/.local/share/currconv/.

Usage Guidance
This skill appears to do what it says: call the frankfurter.app API and format results. Before installing: (1) ensure your agent environment provides curl, bash (4+) and python3 as the SKILL.md requires; (2) inspect the remainder of scripts/script.sh (the manifest was truncated in the review) if you want to confirm caching behavior and any file writes to ~/.local/share/currconv/; (3) be aware it needs outbound network access to api.frankfurter.app but does not request credentials or other system access. If you do not want any local files written, run it in a contained environment or check for/clean the cache directory after use.
Capability Analysis
Type: OpenClaw Skill Name: currconv Version: 3.0.1 The CurrConv skill is a legitimate currency conversion utility that uses the frankfurter.app API (European Central Bank data). The implementation in `scripts/script.sh` is well-structured, featuring robust input validation for currency codes and dates, and uses Python3 for safe JSON parsing. No signs of data exfiltration, malicious execution, or prompt injection were found.
Capability Assessment
ℹ Purpose & Capability
The skill's name/description match its behavior: it queries frankfurter.app for rates and provides convert/list/history functionality. Minor inconsistency: registry metadata lists no required binaries, while SKILL.md and the included script clearly require curl, bash (4+) and python3. This is an administrative mismatch but not a functional red flag.
✓ Instruction Scope
SKILL.md and scripts instruct only to call the frankfurter.app API, parse JSON locally, and present results. The included script’s visible code only accesses the API, formats output, validates inputs, and uses local temp files; it does not read unrelated system files or environment secrets in the shown portion.
✓ Install Mechanism
No install spec is provided (instruction-only), and the packaged script is a plain shell script. No downloads from external or untrusted URLs or archive extraction are present in the manifest.
✓ Credentials
The skill declares no required environment variables or credentials and the visible script does not attempt to read secrets. It does require network access and local execution tools (curl, python3), which are proportionate to the stated purpose.
ℹ Persistence & Privilege
always:false and no special privileges requested. SKILL.md states a rate cache location (~/.local/share/currconv/); the truncated script portion shown does not visibly perform persistent writes, so confirm the remainder of the script if you care about local cache files and their permissions. The skill does not modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install currconv
  3. After installation, invoke the skill by name or use /currconv
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.1
v3.0.1: Fixed metadata alignment — dependencies declared, claims corrected.
v3.0.0
v3.0.0: Complete rewrite with real functionality + SKILL.md aligned.
v2.0.1
update
v2.0.0
v2.5 standard: Use-when desc, homepage, source, security fix
v1.0.5
retry-fix-token
v1.0.4
old template -> domain-specific v2.0.0
v1.0.3
Quality upgrade: custom functionality
v1.0.2
Standards compliance: unique content, no template text
v1.0.1
Quality improvement: better docs, examples, cleaner text
v1.0.0
Initial release
Metadata
Slug currconv
Version 3.0.1
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 10
Frequently Asked Questions

What is Currconv?

Convert currencies using frankfurter.app free API. Use when converting amounts, checking exchange rates, or viewing rate history. Requires curl. It is an AI Agent Skill for Claude Code / OpenClaw, with 324 downloads so far.

How do I install Currconv?

Run "/install currconv" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Currconv free?

Yes, Currconv is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Currconv support?

Currconv is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Currconv?

It is built and maintained by bytesagain-lab (@bytesagain-lab); the current version is v3.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463556 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259610 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200551 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191226 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190235 · by oswalpalash

💬 Comments