mcpField
D
dinero-formatting

dinero-formatting

github.com/dinerojsDevelopment2342 installsUpdated 35w ago
Repository

About dinero-formatting

A reference skill for formatting Dinero.js monetary values in applications. It guides developers through display, locale-aware formatting, non-decimal currencies, and serialization.

Key features

  1. 01Decimal display guidance
  2. 02Currency formatting with Intl.NumberFormat
  3. 03Locale-parameterized formatters
  4. 04Snapshot serialization guidance
  5. 05BigInt JSON replacer guidance
  6. 06Non-decimal currency handling

Use cases

  1. 01Displaying prices and totals in a UI
  2. 02Formatting values for multilingual sites
  3. 03Serializing Dinero objects for APIs or storage
  4. 04Formatting currencies with non-decimal subdivisions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dinerojs/skills --skill dinero-formatting

After installing, type/dinero-formattingin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

rules/
_sections.md
display-no-currency-symbols.md
display-to-decimal.md
locale-intl-formatter.md
locale-multilingual.md
nondecimal-to-units.md
serialization-bigint-json.md
serialization-snapshot.md

Details

From the project README

Dinero.js Formatting

Patterns for formatting Dinero.js monetary values for display. Covers currency symbols, locale-aware formatting, non-decimal currencies, and serialization.

When to Apply

Reference these guidelines when:

  • Displaying prices, totals, or monetary values in a UI
  • Adding currency symbols or locale-specific formatting
  • Formatting non-decimal currencies (e.g., historical currencies with non-base-10 subdivisions)
  • Serializing Dinero objects for APIs, databases, or transport
  • Building reusable formatting utilities

Rule Categories by Priority

PriorityCategoryImpactPrefix
1DisplayCRITICALdisplay-
2LocaleHIGHlocale-
3SerializationHIGHserialization-
4Non-DecimalMEDIUMnondecimal-

Quick Reference

1. Display (CRITICAL)
  • display-to-decimal - Use toDecimal for display strings, not toSnapshot
  • display-no-currency-symbols - Dinero.js does not format currency symbols; compose with Intl.NumberFormat
2. Locale (HIGH)
  • locale-intl-formatter - Build reusable formatters with Intl.NumberFormat
  • locale-multilingual - Create locale-parameterized formatters for multilingual sites
3. Serialization (HIGH)
  • serialization-snapshot - Use toSnapshot for transport and storage, not display
  • serialization-bigint-json - BigInt Dinero objects require a custom JSON replacer
4. Non-Decimal (MEDIUM)
  • nondecimal-to-units - Use toUnits for non-decimal currencies, not toDecimal

How to Use

Read individual rule files for detailed explanations and code examples:

rules/display-no-currency-symbols.md
rules/locale-intl-formatter.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

Comments

Markdown supported