Format numbers
Format numbers using the formatNumber function from Shade whenever someone edits a TSX file.
How do I install this agent skill?
npx skills add https://github.com/tryghost/ghost --skill format-numbersIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides instructions for formatting numbers in TSX files using a specific utility library from the same vendor. It poses no security risk.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/1 file flagged
What does this agent skill do?
Format Numbers
When editing .tsx files, ensure all user-facing numbers are formatted using the formatNumber utility from @tryghost/shade/utils.
Import
import { formatNumber } from '@tryghost/shade/utils';
When to use formatNumber
Use formatNumber() when rendering any numeric value that is displayed to the user, including:
- Member counts, visitor counts, subscriber counts
- Email engagement metrics (opens, clicks, bounces)
- Revenue amounts (combine with
centsToDollars()for monetary values) - Post analytics (views, link clicks)
- Any count or quantity shown in UI
Correct usage
<span>{formatNumber(totalMembers)}</span>
<span>{formatNumber(link.count || 0)}</span>
<span>{`${currencySymbol}${formatNumber(centsToDollars(mrr))}`}</span>
<span>{post.members > 0 ? `+${formatNumber(post.members)}` : '0'}</span>
Antipatterns to avoid
Do NOT use any of these patterns for formatting numbers in TSX files:
// BAD: raw .toLocaleString()
<span>{count.toLocaleString()}</span>
// BAD: manual Intl.NumberFormat
<span>{new Intl.NumberFormat('en-US').format(count)}</span>
// BAD: raw number without formatting
<span>{memberCount}</span>
// BAD: manual regex formatting
<span>{count.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',')}</span>
Related utilities
formatPercentage()- for percentages (e.g., open rates, click rates)abbreviateNumber()- for compact notation (e.g., 1.2M, 50k)centsToDollars()- convert cents to dollars before passing toformatNumber
All are imported from @tryghost/shade/utils.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tryghost/ghost/format-numbers">View Format numbers on skillZs</a>