internationalization

How to add or edit localized UI copy in agent-native apps. Use when adding, removing, or changing user-visible interface text, prompts, toasts, labels, empty states, or date/number/list formatting. Apps opt in to additional locales from `agent-native.config.ts`.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

93%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.

An efficient, actionable, well-structured instruction skill with concrete commands, APIs, and a validation guard. The only minor gap is an implicit rather than explicit validate->fix->retry loop in the workflow.

Dimension	Reasoning	Score
Conciseness	Lean and well-organized with no padding or explanation of concepts Claude already knows; every line conveys project-specific rules (config keys, BCP-47 set, plural suffixes, RTL utilities) that earn their tokens.	5 / 5
Actionability	Highly executable: concrete commands ('pnpm guard:i18n-catalogs', 'pnpm typecheck'), specific APIs ('useT()', 'useFormatters()', 'AppProviders i18n={...}', 'openAgentSettings()'), exact file paths, and a named supported-locale set leave no ambiguity for the common cases.	5 / 5
Workflow Clarity	The Rule section sequences the work (English source first, then only listed locales, then run the guard) with a validation checkpoint in Verification, but the error-recovery feedback loop (guard fails -> fix -> re-run) is implicit rather than explicit.	4 / 5
Progressive Disclosure	A single self-contained file with clear, well-signaled sections (Rule, Catalogs, UI Pattern, Plurals And Placeholders, RTL, Verification) and no nested references; no external bundle files are needed.	5 / 5
	Total	19 / 20 Passed

Description

92%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, third-person description that pairs a concrete capability statement with explicit usage triggers and a clear niche. The only gap is that a few natural synonyms ('translations', 'locales', 'i18n') are not listed as trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'add or edit localized UI copy', 'adding, removing, or changing user-visible interface text, prompts, toasts, labels, empty states, or date/number/list formatting' — covering the i18n copy domain comprehensively.	5 / 5
Completeness	Explicitly answers both 'what' (add/edit localized UI copy in agent-native apps) and 'when' ('Use when adding, removing, or changing user-visible interface text...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Strong natural terms ('interface text', 'prompts', 'toasts', 'labels', 'empty states', 'date/number/list formatting') that users would say, but a few obvious synonyms/triggers like 'translations', 'locales', or 'i18n' are not surfaced as trigger phrases.	4 / 5
Distinctiveness Conflict Risk	Scoped to 'agent-native apps' with specific UI-copy triggers and a project-specific config hook, giving it a clear niche with minimal overlap against generic i18n or document skills.	5 / 5
	Total	19 / 20 Passed

Validation

81%

Warnings & errors only

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

Validation — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	13 / 16 Passed

Repository: BuilderIO/agent-native
Path: .agents/skills/internationalization/SKILL.md
Commit: bb282b1

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.