Agent skill

Dinero Currency Patterns

by dinerojs in dinerojs/dinero.js

Currency handling patterns for the Dinero.js money library. An agent skill from dinerojs/dinero.js.

MITAuto-check passedBackend & APIs

Install Dinero Currency Patterns

skills CLI
$ npx skills add dinerojs/dinero.js --skill dinero-currency-patterns -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dinerojs/dinero.js dinero-currency-patterns --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dinerojs/dinero.js.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/dinero-currency-patterns .claude/skills/dinero-currency-patterns && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dinero-currency-patterns
GitHub stars
6.8k
Token cost
~650 tokens
SKILL.md length
215 words
Files
9
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Currency handling patterns for the Dinero.js money library. An agent skill from dinerojs/dinero.js.

  • Works in 4 steps: Type Safety (HIGH) → Conversion (HIGH) → Storage (HIGH) → …
  • Working with multiple currencies
  • SKILL.md covers When to Apply, Rule Categories by Priority, Quick Reference and How to Use
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Dinero Currency Patterns is an agent skill from dinerojs/dinero.js. Currency handling patterns for the Dinero.js money library. Use when working with multiple currencies, converting between currencies, defining custom currencies, storing monetary values in databases, or integrating with payment services like Stripe or PayPal. Triggers on currency conversion, database schema design for money, or payment API integration with Dinero objects.

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files (for example `rules/convert-reusable.md`, `rules/convert-scaled-rates.md` and `rules/payment-services.md`).

It sits in Backend & APIs, covering Third-party API integration and Database schema design. It works with PayPal, Stripe and TypeScript. The repository describes itself as: Create, calculate, and format money in JavaScript and TypeScript. The licence is MIT.

When your agent uses it

  • Working with multiple currencies
  • Converting between currencies
  • Defining custom currencies
  • Storing monetary values in databases

Example prompts

  • “/dinero-currency-patterns”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Type Safety (HIGH)
  2. Conversion (HIGH)
  3. Storage (HIGH)
  4. Payment Integration (MEDIUM)

What it can do on your machine

Read from SKILL.md and the folder at commit 76b969e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • v2.dinerojs.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dinero Currency Patterns loads about 650 tokens when it runs. Until then it costs about 100 tokens; SKILL.md has 215 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~100
When it runs · the whole SKILL.md, loaded when a task matches
~650

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dinerojs/dinero.js at commit 76b969e, republished under its MIT licence (© dinerojs). 215 words, ~650 tokens.

Download SKILL.mdSave it as .claude/skills/dinero-currency-patterns/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
dinero-currency-patterns
description
Currency handling patterns for the Dinero.js money library. Use when working with multiple currencies, converting between currencies, defining custom currencies, storing monetary values in databases, or integrating with payment services like Stripe or PayPal. Triggers on currency conversion, database schema design for money, or payment API integration with Dinero objects.
license
MIT
metadata.author
dinerojs
metadata.version
1.0.0

Dinero.js Currency Patterns

Patterns for handling currencies with Dinero.js: type safety, conversions, custom currencies, database storage, and payment service integration.

When to Apply

Reference these guidelines when:

  • Converting between currencies with convert
  • Defining custom currencies (e.g., cryptocurrencies, loyalty points)
  • Looking up currencies dynamically from external input
  • Storing monetary values in a database
  • Integrating with payment services (Stripe, PayPal, Square)

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Type SafetyHIGHtypes-
2ConversionHIGHconvert-
3StorageHIGHstorage-
4Payment IntegrationMEDIUMpayment-

Quick Reference

1. Type Safety (HIGH)
  • types-as-const - Define custom currencies with as const satisfies for compile-time safety
  • types-currency-mismatch - TypeScript catches currency mismatches in operations at compile time
  • types-lookup-validation - Validate currency codes from external sources at runtime
2. Conversion (HIGH)
  • convert-scaled-rates - Use scaled amounts for fractional exchange rates, not floats
  • convert-reusable - Build reusable converter functions with higher-order patterns
3. Storage (HIGH)
  • storage-database - Store amount, currency code, and scale as separate columns
  • storage-no-money-type - Avoid PostgreSQL's money type for multi-currency applications
4. Payment Integration (MEDIUM)
  • payment-services - Map Dinero objects to payment service formats with dedicated helpers

How to Use

Read individual rule files for detailed explanations and code examples:

rules/types-as-const.md
rules/convert-scaled-rates.md

Each rule file contains:

  • Brief explanation of why it matters
  • Incorrect code example with explanation
  • Correct code example with explanation
  • Additional context and references

© dinerojs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files in .agents/skills/dinero-currency-patterns of dinerojs/dinero.js.

  • SKILL.md
  • rules/convert-reusable.md
  • rules/convert-scaled-rates.md
  • rules/payment-services.md
  • rules/storage-database.md
  • rules/storage-no-money-type.md
  • rules/types-as-const.md
  • rules/types-currency-mismatch.md
  • rules/types-lookup-validation.md

Open the folder on GitHubat commit 76b969e

Compare with similar skills

Dinero Currency Patterns next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dinero Currency Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dinero Currency Patterns this skilldinerojs/dinero.js6.8k—~650Automated safety check: PassMIT
API ForgeEliasOulkadi/shokunin114—~2.9kAutomated safety check: PassMIT
SaaS Scaffolderborghei/Claude-Skills891—~1.8kAutomated safety check: PassMIT
SaaS Scaffolderalirezarezvani/claude-skills28k1 repos~2.6kAutomated safety check: PassMIT
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
AI ClientOpentrons/opentrons523—~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • API Forge

    EliasOulkadi/shokunin

    Design REST/GraphQL APIs with OpenAPI 3.1, error handling, pagination, rate limiting, webhooks, and idempotency.

    114 GitHub stars~2.9k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • SaaS Scaffolder

    borghei/Claude-Skills

    Generate SaaS boilerplate with auth, database schemas, Stripe billing, multi-tenancy, API routes, and dashboard UI on a Next.js/TypeScript/Tailwind stack.

    891 GitHub stars~1.8k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • SaaS Scaffolder

    alirezarezvani/claude-skills

    Generates complete, production-ready SaaS project boilerplate including authentication, database schemas, billing integration, API routes, and a working dashboard using Next.js 14+ App Router…

    28k GitHub starsUsed in 1 repo~2.6k tokens
    DatabasesAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • AI Client

    Opentrons/opentrons

    Conventions for the opentrons-ai-client React/TypeScript frontend — project structure, API integration, state management (Jotai), feature flags, types, and testing.

    523 GitHub stars~1.6k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Bfl API

    black-forest-labs/skills

    BFL FLUX API integration guide covering endpoints, async polling patterns, rate limiting, error handling, webhooks, and regional endpoints with Python and TypeScript code examples.

    128 GitHub starsUsed in 1 repo~2.5k tokens
    Backend & APIsAuto-check: notes

More from dinerojs/dinero.js

  • Commit

    dinerojs/dinero.js

    Create a git commit with optional automatic Linear issue linking.

    6.8k GitHub stars~667 tokensUpdated 5 days ago
    Auto-check passed
  • Dinero Best Practices

    dinerojs/dinero.js

    Core best practices for the Dinero.js money library. An agent skill from dinerojs/dinero.js.

    6.8k GitHub stars~756 tokensUpdated 5 days ago
    Auto-check passed
  • Dinero Formatting

    dinerojs/dinero.js

    Formatting patterns for the Dinero.js money library. An agent skill from dinerojs/dinero.js.

    6.8k GitHub stars~622 tokensUpdated 5 days ago
    Auto-check passed

Categories

Questions about Dinero Currency Patterns

What does Dinero Currency Patterns do?

Currency handling patterns for the Dinero.js money library. An agent skill from dinerojs/dinero.js. js.js money library.

When should I use Dinero Currency Patterns?

Dinero Currency Patterns fits situations like: working with multiple currencies; converting between currencies; defining custom currencies; storing monetary values in databases.

How do I install Dinero Currency Patterns in Claude Code?

Run `npx skills add dinerojs/dinero.js --skill dinero-currency-patterns -a claude-code`. Or copy the skill folder (.agents/skills/dinero-currency-patterns in dinerojs/dinero.js) into .claude/skills/dinero-currency-patterns in your project. Claude Code loads it when a task matches its description.

How do I install Dinero Currency Patterns in Codex?

Run `npx skills add dinerojs/dinero.js --skill dinero-currency-patterns -a codex`. Or copy the skill folder (.agents/skills/dinero-currency-patterns in dinerojs/dinero.js) into .agents/skills/dinero-currency-patterns in your project. Codex loads it when a task matches its description.

Can I use Dinero Currency Patterns in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dinerojs/dinero.js --skill dinero-currency-patterns -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dinero-currency-patterns, .gemini/skills/dinero-currency-patterns, .github/skills/dinero-currency-patterns and .opencode/skills/dinero-currency-patterns in your project.

What does Dinero Currency Patterns need to run?

SKILL.md names no scripts, command-line tools or credentials: Dinero Currency Patterns is instructions for the agent only.

Does Dinero Currency Patterns access the network?

SKILL.md names 1 domain. As links in the text: v2.dinerojs.com. This is read from the text; nothing was executed.

Is Dinero Currency Patterns safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dinero Currency Patterns use?

Dinero Currency Patterns is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dinero Currency Patterns use?

About 650 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dinero Currency Patterns?

Skills that share tags, products or a category with Dinero Currency Patterns: API Forge (EliasOulkadi/shokunin, 114 stars), SaaS Scaffolder (borghei/Claude-Skills, 891 stars), SaaS Scaffolder (alirezarezvani/claude-skills, 28k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dinero Currency Patterns?

dinerojs (a GitHub organization) maintains it in dinerojs/dinero.js, which has 6,804 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 5, 2026.

Source: dinerojs/dinero.js on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.