SkillAgentSearch skills...

swift-formatstyle

Formats and parses locale-aware numbers, decimals, currencies, percentages, dates, durations, measurements, names, lists, byte counts, and URLs with Foundation FormatStyle and ParseableFormatStyle

Install / Use

npx skills add dpearson2699/swift-ios-skills --skill swift-formatstyle

Installs into whichever agent you are using.

About this skill
๐Ÿ“„

SKILL.md

Installable skill definition

Quality Score

85/100

Supported Platforms

Universal

Our assessment of swift-formatstyle

swift-formatstyle scores 85/100 on our quality scale, 2713th of 4,698 Development & Engineering skills we index.

Its SKILL.md is 7.7 KB long, well organised into 11 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.

With 1,143 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
18/20
Description
15/15
Adoption
13/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-11-05 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 86/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit โ€” read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk โ€” read a skill before letting an agent act on it.

swift-formatstyle compared with similar skills

All 4 of these similar skills score higher than swift-formatstyle; compare them before choosing.

SkillScoreStarsUpdatedFormat
swift-formatstyle (this skill)by dpearson2699851.1k4mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md

Frequently asked questions

How do I install swift-formatstyle?
Run npx skills add dpearson2699/swift-ios-skills --skill swift-formatstyle. The install tabs above show the steps for each supported agent.
Which AI agents does swift-formatstyle work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is swift-formatstyle safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 86/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is swift-formatstyle still maintained?
The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

name: swift-formatstyle description: "Formats and parses locale-aware numbers, decimals, currencies, percentages, dates, durations, measurements, names, lists, byte counts, and URLs with Foundation FormatStyle and ParseableFormatStyle. Use when replacing legacy Formatter subclasses, designing reusable format APIs, using SwiftUI Text(_:format:), correcting availability, or testing user-facing formatted output across locales."

Swift FormatStyle

Use Foundation's type-safe FormatStyle APIs for user-facing display and ParseableFormatStyle when the same convention must accept input. Route String Catalogs, plurals, localized copy, bundles, and RTL layout to ios-localization; formatting still requires locale review even when no text is translated.

Contents

Workflow

  1. Identify the value's semantic type and whether output is display-only or must round-trip through parsing.
  2. Select the narrowest built-in style and keep the user's current locale unless a wire format explicitly requires another locale.
  3. Render the exact UI with representative locales such as en_US, de_DE, ar_SA, and ja_JP.
  4. Check separators, numbering systems, calendars, currency and unit conventions, text direction, and layout.
  5. If output or parsing fails, fix the style or surrounding copy, restore the input fixture, and rerun the same locale matrix.

Load FormatStyle Recipes when implementation needs concrete modifiers, date intervals, relative dates, duration patterns, measurements, names, lists, byte counts, or URL component controls.

Quick Reference

| Value | Default style | Important constraint | |---|---|---| | Int, Double | .number | Configure precision, rounding, grouping, notation, or sign only as required. | | Decimal | .number, .percent, .currency(code:) | Prefer for exact decimal display and parsing. | | Currency | .currency(code:) | Pass an ISO 4217 code; never hardcode a symbol. | | Percent | .percent | Confirm whether the input is a fraction (0.85) or whole percent (85). | | Date | .dateTime, .relative, .interval | Relative output should usually stand alone, not be embedded in a sentence. | | Duration | .time(pattern:), .units(allowed:width:) | Requires iOS 16+; choose compact clock output versus labeled units. | | Measurement | .measurement(width:usage:) | usage: controls locale-aware conversion policy. | | PersonNameComponents | .name(style:) | Do not manually concatenate name parts. | | Collections | .list(type:width:) | Let locale rules choose separators and conjunctions. | | Byte count | .byteCount(style:) | Choose file, memory, decimal, or binary semantics deliberately. | | URL | .url | Requires iOS 16+; query, port, and fragment are opt-in display components. |

Selection and Availability

  • Prefer FormatStyle over legacy NumberFormatter, DateFormatter, DateComponentsFormatter, and manual interpolation for new iOS 15+ code.
  • Duration format styles and URL.FormatStyle require iOS 16+.
  • Date.AnchoredRelativeFormatStyle requires iOS 18+ and formats relative to a fixed anchor rather than the current moment.
  • Omit .locale(...) for normal UI so the style inherits the user's locale. Use a fixed locale only for an explicit protocol or test fixture.
  • Treat relative date output as standalone text unless the entire sentence is localized around it.

Docs: FormatStyle

Parsing

Use the matching parseable style when users edit or import formatted values:

let style = Decimal.FormatStyle.Currency(code: "USD")
    .locale(Locale(identifier: "en_US"))

let value = try Decimal("$3,500.63", format: style)
let display = value.formatted(style)

The fixed locale above is appropriate only because the input contract is explicitly en_US. For normal UI input, use the user's locale and test round trips with representative decimal separators, currency placement, calendars, and numbering systems.

SwiftUI Integration

Prefer Text(_:format:) so SwiftUI owns the formatted value:

Text(price, format: .currency(code: currencyCode))
Text(date, format: .dateTime.month().day().year())
Text(duration, format: .units(allowed: [.minutes, .seconds]))

For every user-facing formatted Text, preview or test the exact screen across the locale matrix. Use Text(.now, style: .timer), Text(.now, style: .relative), or Text(timerInterval:) for live-updating time displays rather than manually scheduling string refreshes.

Custom FormatStyle

Create a custom style only when built-in composition cannot express the domain convention. FormatStyle refines Codable and Hashable; keep styles as reusable values and add ParseableFormatStyle only when input must round-trip.

struct AbbreviatedCountStyle: FormatStyle {
    func format(_ value: Int) -> String {
        switch value {
        case ..<1_000: "\(value)"
        case 1_000..<1_000_000: String(format: "%.1fK", Double(value) / 1_000)
        default: String(format: "%.1fM", Double(value) / 1_000_000)
        }
    }
}

extension FormatStyle where Self == AbbreviatedCountStyle {
    static var abbreviatedCount: Self { .init() }
}

Custom styles still need locale and accessibility review; a compact English suffix may not be suitable for every locale.

Common Mistakes

| Mistake | Fix | |---|---| | Manual formatting or legacy formatter allocation in view code | Use the matching FormatStyle and Text(_:format:). | | Hardcoded currency symbol or locale | Pass an ISO currency code and inherit the user locale unless the contract says otherwise. | | Binary floating-point for exact decimal input | Use Decimal.FormatStyle and its matching parse strategy. | | Assuming URL.formatted() preserves every component | Opt in to .port(.always), .query(.always), or .fragment(.always) only when those components should display. | | Relative date output embedded in a larger sentence | Keep it standalone or localize the complete sentence. | | Clock-style duration used for prose | Use .units(allowed:width:) for labeled output. | | Measurement conversion left implicit | Select a usage: appropriate to the UI. | | One-locale spot check | Run the same exact-screen fixture across representative locales and fix/rerun failures. |

Review Checklist

  • [ ] Semantic value type and display-versus-parse requirement identified
  • [ ] Built-in FormatStyle used where it can express the convention
  • [ ] Availability gated beside iOS 16+ and iOS 18+ APIs
  • [ ] Currency uses an ISO 4217 code; exact decimal values use Decimal
  • [ ] User locale inherited unless a protocol explicitly fixes it
  • [ ] Relative date text stands alone or the full sentence is localized
  • [ ] URL components and measurement usage: are deliberate
  • [ ] SwiftUI uses Text(_:format:) for formatted values
  • [ ] Exact rendered UI and parse round trips pass the representative-locale matrix

References

Related Skills

View on GitHub
GitHub Stars1.1k
CategoryDevelopment
Updated3mo ago
Forks58

Languages

Python

Trust signals

86/100

From repository metadata: license, adoption, age and documentation. Not a code audit โ€” see the Safety scan above for what the skill file itself contains.

1 medium1 info
swift-formatstyle โ€” Universal Skill: Install & Safety Check | SkillAgent