frankfurter: Skill for Claude Code

.agents/skills/implementing-providers/SKILL.md

implementing-providers is a skill for Claude Code, Codex from lineofflight/frankfurter. It costs 57 tokens per session (3,102 once invoked), scanned A, original, MIT.

A checklist for adding or updating exchange-rate data sources in a software project. It covers checking the source API, currencies, publication schedule, and historical coverage before coding.

In plain words
What is it for?
Use it when adding a central bank or other exchange-rate API, implementing a provider from an issue, or backfilling, fixing, or updating an existing provider.
Why use it?
It prevents incomplete providers, fake test data, and permanent gaps in historical exchange-rate records.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is lineofflight/frankfurter's own configuration. It tells Claude Code and Codex how to work on frankfurter itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything frankfurter configures →

About the project

Frankfurter is an open-source API that provides daily currency exchange rates collected from institutional sources. Developers use it to retrieve currency data, convert amounts, or run their own instance with Docker. The catalogue entries are add-ons for working with the API.

lineofflight/frankfurter · 1,838 stars · on GitHub · frankfurter.dev

Reuse

Borrowing it

Nothing to install: this file belongs to lineofflight/frankfurter. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/lineofflight/frankfurter/main/.agents/skills/implementing-providers/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/lineofflight/frankfurter

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for implementing-providers

README.md
[![agentmods](https://agentmods.dev/badge/skills/lineofflight/frankfurter/implementing-providers.svg)](https://agentmods.dev/skills/lineofflight/frankfurter/implementing-providers)
Your own site
<a href="https://agentmods.dev/skills/lineofflight/frankfurter/implementing-providers"><img src="https://agentmods.dev/badge/skills/lineofflight/frankfurter/implementing-providers.svg" alt="Measured on agentmods" height="20"></a>
Per session 57 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,102 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00057 $0.03102
Opus 5 $0.00028 $0.01551
Sonnet 5 $0.00011 $0.00620
Haiku 4.5 $0.00006 $0.00310

Measured 6d ago against content hash 787e31ad15f8, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

implementing-providers scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- `fetch(after: nil, upto: nil)` — fetches from the source API, returns an array of records
.agents/skills/implementing-providers/SKILL.md · 147 lines

How it starts

The opening of the file, as written. The whole thing — 147 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Adding a New Provider

Checklist for adding a new exchange rate data provider. Each step references an existing provider as a pattern to follow.

Before You Start

  • Identify the API endpoint and authentication requirements
  • Verify the API is accessible — make a test request and confirm you get a 200 response with valid data. If the API returns 403, times out, or is otherwise inaccessible, stop here. Do not proceed with a hand-crafted cassette or fake data.
  • Read the API docs — understand pagination, date filtering, and rate limiting. Some APIs require specific params for date ranges (e.g., HKMA needs choose=end_of_day for from/to to work). Getting this right avoids downloading the entire dataset on every request.
  • Confirm the base currency and available quote currencies
  • Check the publish schedule (timezone, frequency, days of week)
  • Determine the earliest available date for historical data (goes in coverage_start in the seed file)

Go/no-go: does the provider backfill meaningfully?

Before writing code, confirm the provider has a usable historical archive. If not, don't implement it — forward-only providers accumulate permanent gaps each year and the maintenance cost outweighs the value.

Stop and skip the provider if either of these is true:

  • Live page only, no historical endpoint. Every year (or whenever the scheduler misses a window) leaves a permanent hole. Even a fresh deploy is forward-only from day one.
  • Archive exists but lags badly. An archive that's months behind the live page means anything between the last archive entry and "now" is permanently lost if we don't catch it live.

If the provider has a real archive (downloadable history reaching back years, not just the current snapshot), proceed. Note coverage_start from the earliest archive date and continue with the checklist.

Implementation Checklist

1. Adapter class — lib/provider/adapters/<key>.rb

Inherit from Provider::Adapters::Adapter. See any existing adapter for the pattern (e.g. lib/provider/adapters/boi.rb).

Read the full file on GitHub · 147 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 147 lines · 57 tokens per session scan A 787e31ad15f8

Subscribe to this mod's changes

implementing-providers is a skill published in the GitHub repository lineofflight/frankfurter (1,838 stars, last pushed 5d ago), licensed MIT. It adds 57 tokens to every session and 3,102 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

gmgn-contract-dd

Contract due-diligence score for one token address — contract safety, holder structure and price action combined into a single 0-100 composite, capped by GMGN's own rug label, where every deduction names the field it read and an absent field is never a passing check. Use when the user wants one verdict number rather…

GMGNAI/gmgn-skills · 367 tokens

gmgn-market

Get crypto and meme token price charts (K-line, candlestick, OHLCV), trending meme coin rankings by volume, newly launched tokens on launchpads (pump.fun, fourmeme, letsbonk, Raydium, etc.), the hot-search ranking (most-searched tokens), and search for a specific token or wallet by name, symbol, contract address…

GMGNAI/gmgn-skills · 153 tokens

gmgn-swap

BEFORE RUNNING ANY COMMAND: Run gmgn-cli config --check. If exit code is 0, proceed normally. If exit code is 1, (1) run gmgn-cli config and show the output to the user; (2) once the user sends the API Key, run gmgn-cli config --apply to complete configuration and verification, then show the output to the user. If…

GMGNAI/gmgn-skills · 404 tokens

gmgn-wallet-score

Score any wallet address across three angles — profitability (a real track-record score: is this trader actually good?), copy-tradeability (can YOU actually capture what it makes, plus a latency/slippage/gas backtest), and Dev reputation (if it's mostly a token launcher, how trustworthy are its launches) — plus…

GMGNAI/gmgn-skills · 0 tokens

gmgn-wallet-analysis

The trader's decision dossier on a wallet — four pass/fail gates (is the record real, is the edge still working THIS week, can you actually get filled, does it cut losses) plus what the wallet is holding and buying right now, its entry market-cap band, its copy window in seconds, and a concrete size cap. Answers the…

GMGNAI/gmgn-skills · 278 tokens

alpaca-trade-api-sdk

Integrate and build on the @alpacahq/alpaca-trade-api TypeScript SDK for the Alpaca Trading and Market Data APIs (the unified Alpaca client, ergonomic order builders, normalized market-data shapes, pagination, typed errors, resilience, and real-time streaming). Use when writing or reviewing code that imports…

alpacahq/alpaca-trade-api-js · 123 tokens