react-admin-i18n

Guidelines for internationalizing a react-admin or shadcn admin kit application. Use when adding i18n support, creating translation files, translating hardcoded English strings in JSX, or reviewing i18n PRs in a react-admin project. Covers namespace conventions, interpolation, pluralization, locale-aware formatting, and the full workflow for converting an English-only app to multi-language. Trigger this skill whenever the user mentions i18n, internationalization, translation, localization, locale switching, or multi-language in a react-admin or shadcn admin kit context — even if they just say "translate this component" or "add French support".

Quality

94%

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

88%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 thorough, actionable, and well-sequenced skill with executable code, explicit validation checklists, and deep react-admin-specific guidance. Its main weaknesses are minor verbosity in a few explanatory passages and a monolithic single-file structure that underuses progressive disclosure for a skill of this length.

Suggestions

Tighten the introductory prose around Polyglot.js and the Intl formatting rationale to assume Claude's competence and trim tokens that do not add react-admin-specific information.

Move the full i18nProvider setup, Language Switcher component, and type-safe catalog machinery into a single referenced file (e.g. SETUP.md) so SKILL.md stays a lean overview pointing one level deep to detailed materials.

Consider extracting the 15 rules into a RULES.md reference with a short summary table in SKILL.md, improving navigability and progressive disclosure for this long skill.

Dimension	Reasoning	Score
Conciseness	Largely lean, domain-specific react-admin i18n knowledge Claude would not already know, with minor over-explanation (e.g. the Polyglot.js intro and the Intl formatting rationale) that could be trimmed; not a 5 because a few prose passages pad rather than add new information.	4 / 5
Actionability	Provides copy-paste ready, executable TS/TSX for the i18nProvider, language switcher, type-safe catalogs, component conversion, and tests, covering the common cases concretely.	5 / 5
Workflow Clarity	Clear 8-step high-level workflow plus a 6-step per-component conversion process, a pre-submit checklist, and a testing section supply explicit validation steps and checklists for a batch migration, satisfying the feedback-loop expectation.	5 / 5
Progressive Disclosure	Well-organized with clear section headers and logical navigation, but it is a 466-line monolithic file with no one-level-deep references; some deep-dive material (full i18nProvider/Language Switcher setups, the 15 rules) could be split into referenced files. Not a 5 because the overview does not point to detailed materials in separate files.	4 / 5
	Total	18 / 20 Passed

Description

100%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 highly specific, third-person description that clearly states capabilities, provides comprehensive natural trigger terms, and explicitly covers both what the skill does and when to invoke it. It is well-differentiated from generic skills by its react-admin/shadcn framing.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions ('adding i18n support', 'creating translation files', 'translating hardcoded English strings in JSX', 'reviewing i18n PRs') plus namespace conventions, interpolation, pluralization, and the full conversion workflow, giving comprehensive coverage rather than just 'minor gaps'.	5 / 5
Completeness	Explicitly answers both 'what' (internationalizing, namespace conventions, full conversion workflow) and 'when' with concrete trigger phrases ('Use when...', 'Trigger this skill whenever the user mentions...').	5 / 5
Trigger Term Quality	Comprehensive natural-term coverage including synonyms ('i18n', 'internationalization', 'translation', 'localization', 'locale switching', 'multi-language') and natural user phrases ('translate this component', 'add French support').	5 / 5
Distinctiveness Conflict Risk	Scoped to 'react-admin or shadcn admin kit context' with distinct triggers, giving a clear niche with minimal conflict risk against unrelated skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: marmelab/react-admin
Path: .agents/skills/i18n/SKILL.md
Commit: 838d05e

Reviewed: 2 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.