CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ios-localization

Implement, review, or improve localization and internationalization in iOS/macOS apps — String Catalogs (.xcstrings), generated localizable symbols, stable key naming, LocalizedStringKey, LocalizedStringResource, pluralization, FormatStyle for numbers/dates/measurements, right-to-left layout, Dynamic Type, and locale-aware formatting. Use when adding multi-language support, setting up String Catalogs, enabling generated symbols for compile-time-safe localization keys, handling plural forms, formatting dates/numbers/currencies for different locales, testing localizations, or making UI work correctly in RTL languages like Arabic and Hebrew.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is dpearson2699/swift-ios-skills

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-constructed reference skill: executable code for every topic, a decision table, explicit validation ordering for the SPM failure path, a thorough review checklist, and clean splitting of detail into two real, well-signaled reference files. Minor room to tighten a few explanatory sentences and to present an end-to-end implementation sequence.

DimensionReasoningScore

Conciseness

The body is largely efficient: compact code snippets, a string-type decision table, DO/DON'T rules, and locale-output comments that carry real information. A few sentences could be trimmed — e.g., the generated-symbols availability caveats ("they do not change the catalog's Xcode 15 availability") and some explanatory framing around symbol naming — so it fits the efficient-with-minor-trimmable-instances anchor rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

Guidance is fully executable: copy-paste Swift for every topic (extraction patterns, String(localized:), LocalizedStringResource in an App Intent, type-safe interpolation, plural categories, FormatStyle for dates/numbers/currency/measurements, RTL preview environments), plus a concrete decision table and exact Build Settings path ("Localization > Generate String Catalog Symbols → Yes"). The common cases are covered with executable examples, matching the top anchor.

5 / 5

Workflow Clarity

Multi-step processes are clearly sequenced where present, with an explicit validation checkpoint pattern ("answer with this explicit resource checklist before bundle debugging: 1... 2... 3... Only after those pass, debug lookup") and a 17-item review checklist for the overall process. It falls short of the top anchor because the guide is organized topically rather than as an end-to-end implementation sequence with checkpoints between steps, so a couple of validation points are implicit.

4 / 5

Progressive Disclosure

The body is a clear overview with a Contents TOC, and it appropriately pushes deep detail into two well-signaled, one-level-deep references that both exist and are substantial (references/string-catalogs.md, references/formatstyle-locale.md), each cited inline at the point of need ("Load references/formatstyle-locale.md for duration, names, lists, custom styles...") and again in a References section. This matches the clear-overview/well-signaled-references anchor exactly.

5 / 5

Total

18

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete verbs, a comprehensive technology inventory, third-person voice, and an explicit multi-trigger "Use when" clause. Its only weaknesses are a few missing common trigger synonyms (translation, i18n) and a mild overlap risk on FormatStyle coverage versus a sibling Swift formatting skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ("Implement, review, or improve localization and internationalization") and comprehensively enumerates the domain: "String Catalogs (.xcstrings), generated localizable symbols, stable key naming, LocalizedStringKey, LocalizedStringResource, pluralization, FormatStyle for numbers/dates/measurements, right-to-left layout, Dynamic Type, and locale-aware formatting". Coverage spans catalogs, symbols, string types, plurals, formatting, RTL, and Dynamic Type with no notable gaps, matching the comprehensive anchor rather than the minor-gaps anchor one level below.

5 / 5

Completeness

Both questions are explicitly answered: the "what" is the leading capability sentence with a concrete technology inventory, and the "when" is a full "Use when adding multi-language support, ... or making UI work correctly in RTL languages like Arabic and Hebrew" clause with concrete trigger phrases. This matches the top anchor exactly; the level-below anchor requires a weaker or less explicit "when", which is not the case here.

5 / 5

Trigger Term Quality

The "Use when..." clause covers many natural phrases users would say: "adding multi-language support", "setting up String Catalogs", "handling plural forms", "formatting dates/numbers/currencies for different locales", "testing localizations", "RTL languages like Arabic and Hebrew", plus the .xcstrings file extension. A few common natural terms are missing — most notably "translation(s)"/"translate" and "i18n" — which fits the good-coverage-with-a-few-missing anchor rather than the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a clear niche ("in iOS/macOS apps") with distinctive triggers (String Catalogs, .xcstrings, RTL/Arabic/Hebrew), so it is mostly distinct. However, claiming "FormatStyle for numbers/dates/measurements" and "locale-aware formatting" creates minor overlap risk with a closely related general Swift formatting skill — the body even routes standalone FormatStyle API work to "swift-formatstyle" — which fits the mostly-distinct-with-minor-overlap anchor better than the minimal-conflict anchor.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

dpearson2699/swift-ios-skills

Path

skills/ios-localization/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.