Jakość

Internationalisation

Makes front-end code ready for more than one language and region - lang and dir, right-to-left layout with logical properties, whole messages with ICU plurals, Intl for dates, numbers, prices and sorting, complete locale files. Use when adding a locale or translations, formatting dates or money, building a language switcher, or when asked "translate this" or "support Arabic".

fe-i18nkażdego projektu webowego9 regułładowane zawsze: 83 tokeny; przy użyciu: 1010 tokenów; w referencjach na żądanie: 1550 tokenów.

Instalacja

init instaluje ten skill, gdy projekt używa: każdego projektu webowego. Wybierz agenta, aby zobaczyć, gdzie trafią jego pliki.

npx github:dawidolko/frontend-skills init

Ten sposób nie był jeszcze testowany. npx i pnpm dlx są przetestowane; jeśli ten zawiedzie, użyj jednego z nich.

Bez --agents polecenie init rozpoznaje agentów po tym, co projekt już ma, a gdy nie znajdzie żadnego, pyta:

Po czym init rozpoznaje każdego z agentów (17)

Agent	Rozpoznawany po
Claude Code	`CLAUDE.md` `.claude` `CLAUDE.local.md`
OpenAI Codex	`.codex` `AGENTS.override.md`
Cursor	`.cursor` `.cursorrules`
GitHub Copilot	`.github/copilot-instructions.md` `.github/instructions` `.github/skills` `.github/prompts`
Gemini CLI	`GEMINI.md` `.gemini`
Antigravity CLI	`.agents/rules` `.agent/rules`
Devin / Windsurf	`.devin` `.windsurf` `.windsurfrules`
OpenCode	`opencode.json` `opencode.jsonc` `.opencode`
Cline	`.clinerules` `.cline`
Zed	`.rules` `.zed`
JetBrains Junie	`.junie`
Kiro	`.kiro`
Augment	`.augment` `.augment-guidelines`
Trae	`.trae`
Continue	`.continue`
Amazon Q Developer	`.amazonq`
Aider	`.aider.conf.yml` `CONVENTIONS.md`

Gdzie trafia fe-i18n dla: Claude Code

.claude/skills/fe-i18n/SKILL.mdskill
.claude/skills/fe-i18n/references/i18n.mdskill
.claude/rules/fe-i18n.mdplik reguł
CLAUDE.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

.claude/rules/fe-i18n.md

---
paths:
  - "**/*.html"
  - "**/*.jsx"
  - "**/*.tsx"
  - "**/*.js"
  - "**/*.vue"
  - "**/*.svelte"
  - "**/*.astro"
  - "**/*.css"
  - "**/*.scss"
  - "**/locales/**"
  - "**/messages/**"
  - "**/i18n/**"
---

# Internationalisation (frontend-skills)

Makes front-end code ready for more than one language and region - lang and dir, right-to-left layout with logical properties, whole messages with ICU plurals, Intl for dates, numbers, prices and sorting, complete locale files. Use when adding a locale or translations, formatting dates or money, building a language switcher, or when asked "translate this" or "support Arabic".

- `<html lang>` follows the active locale and every `lang` is a valid tag (a11y/html-lang, a11y/lang-valid).
- Right-to-left locales set `dir="rtl"` on `<html>`; user text gets `dir="auto"` (i18n/dir-rtl).
- One message per sentence with placeholders; never join translated fragments (i18n/no-string-concat).
- Plurals use ICU `plural` or `Intl.PluralRules`, never `count === 1 ?` (i18n/plural-rules).
- Dates, numbers and prices go through `Intl` formatters, never hand-built strings (i18n/intl-format).
- Pass the app's locale to every formatter; never rely on the runtime default (i18n/explicit-locale).
- Every locale has the same keys, placeholders and the plural categories its language needs (i18n/same-keys).
- With a right-to-left locale, layout uses logical properties (i18n/logical-properties).
- Keep text out of images, let boxes grow for longer translations, and sort user-visible lists with `Intl.Collator`.
- Use the one i18n library the framework already has; never add a second.

Before larger changes, read the full skill: `.claude/skills/fe-i18n/SKILL.md`. Explain any rule id with `npx github:dawidolko/frontend-skills explain <id>`.

Prawdziwy plik

Gdzie trafia fe-i18n dla: OpenAI Codex

.agents/skills/fe-i18n/SKILL.mdskill
.agents/skills/fe-i18n/references/i18n.mdskill
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

OpenAI Codex nie ma plików reguł zawężonych do typów plików; czyta skille i blok instrukcji.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

AGENTS.md

## Front-end work (frontend-skills)

- Before front-end work, read `.frontend-skills/profile.json` (the stack) and `.frontend-skills/lessons.md` (confirmed conventions of this project; they win over any skill).
- Use the installed `fe-*` skill that matches the files you edit.
- After changing UI code, run `npx github:dawidolko/frontend-skills audit --changed --json` and fix findings at `serious` and above; `explain <rule id>` gives the reason, the source and the fix.
- Name rule ids (such as `a11y/img-alt`) in reviews and commit messages.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Cursor

.agents/skills/fe-i18n/SKILL.mdskill
.agents/skills/fe-i18n/references/i18n.mdskill
.cursor/rules/fe-i18n.mdcplik reguł
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

.cursor/rules/fe-i18n.mdc

---
description: Makes front-end code ready for more than one language and region - lang and dir, right-to-left layout with logical properties, whole messages with ICU plurals, Intl for dates, numbers, prices and sorting, complete locale files. Use when adding a locale or translations, formatting dates or money, building a language switcher, or when asked "translate this" or "support Arabic".
globs: **/*.html, **/*.jsx, **/*.tsx, **/*.js, **/*.vue, **/*.svelte, **/*.astro, **/*.css, **/*.scss, **/locales/**, **/messages/**, **/i18n/**
alwaysApply: false
---

# Internationalisation (frontend-skills)

- `<html lang>` follows the active locale and every `lang` is a valid tag (a11y/html-lang, a11y/lang-valid).
- Right-to-left locales set `dir="rtl"` on `<html>`; user text gets `dir="auto"` (i18n/dir-rtl).
- One message per sentence with placeholders; never join translated fragments (i18n/no-string-concat).
- Plurals use ICU `plural` or `Intl.PluralRules`, never `count === 1 ?` (i18n/plural-rules).
- Dates, numbers and prices go through `Intl` formatters, never hand-built strings (i18n/intl-format).
- Pass the app's locale to every formatter; never rely on the runtime default (i18n/explicit-locale).
- Every locale has the same keys, placeholders and the plural categories its language needs (i18n/same-keys).
- With a right-to-left locale, layout uses logical properties (i18n/logical-properties).
- Keep text out of images, let boxes grow for longer translations, and sort user-visible lists with `Intl.Collator`.
- Use the one i18n library the framework already has; never add a second.

Before larger changes, read the full skill: `.agents/skills/fe-i18n/SKILL.md`. Explain any rule id with `npx github:dawidolko/frontend-skills explain <id>`.

Prawdziwy plik

Gdzie trafia fe-i18n dla: GitHub Copilot

.agents/skills/fe-i18n/SKILL.mdskill
.agents/skills/fe-i18n/references/i18n.mdskill
.github/instructions/fe-i18n.instructions.mdplik reguł
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

.github/instructions/fe-i18n.instructions.md

---
applyTo: "**/*.html,**/*.jsx,**/*.tsx,**/*.js,**/*.vue,**/*.svelte,**/*.astro,**/*.css,**/*.scss,**/locales/**,**/messages/**,**/i18n/**"
description: "Makes front-end code ready for more than one language and region - lang and dir, right-to-left layout with logical properties, whole messages with ICU plurals, Intl for dates, numbers, prices and sorting, complete locale files. Use when adding a locale or translations, formatting dates or money, building a language switcher, or when asked \"translate this\" or \"support Arabic\"."
---

# Internationalisation (frontend-skills)

- `<html lang>` follows the active locale and every `lang` is a valid tag (a11y/html-lang, a11y/lang-valid).
- Right-to-left locales set `dir="rtl"` on `<html>`; user text gets `dir="auto"` (i18n/dir-rtl).
- One message per sentence with placeholders; never join translated fragments (i18n/no-string-concat).
- Plurals use ICU `plural` or `Intl.PluralRules`, never `count === 1 ?` (i18n/plural-rules).
- Dates, numbers and prices go through `Intl` formatters, never hand-built strings (i18n/intl-format).
- Pass the app's locale to every formatter; never rely on the runtime default (i18n/explicit-locale).
- Every locale has the same keys, placeholders and the plural categories its language needs (i18n/same-keys).
- With a right-to-left locale, layout uses logical properties (i18n/logical-properties).
- Keep text out of images, let boxes grow for longer translations, and sort user-visible lists with `Intl.Collator`.
- Use the one i18n library the framework already has; never add a second.

Before larger changes, read the full skill: `.agents/skills/fe-i18n/SKILL.md`. Explain any rule id with `npx github:dawidolko/frontend-skills explain <id>`.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Gemini CLI

.agents/skills/fe-i18n/SKILL.mdskill
.agents/skills/fe-i18n/references/i18n.mdskill
GEMINI.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Gemini CLI: Gemini CLI was replaced by Antigravity CLI for unpaid tiers on 2026-06-18; choose "antigravity" too if you use it.

Gemini CLI nie ma plików reguł zawężonych do typów plików; czyta skille i blok instrukcji.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

GEMINI.md

## Front-end work (frontend-skills)

- Before front-end work, read `.frontend-skills/profile.json` (the stack) and `.frontend-skills/lessons.md` (confirmed conventions of this project; they win over any skill).
- Use the installed `fe-*` skill that matches the files you edit.
- After changing UI code, run `npx github:dawidolko/frontend-skills audit --changed --json` and fix findings at `serious` and above; `explain <rule id>` gives the reason, the source and the fix.
- Name rule ids (such as `a11y/img-alt`) in reviews and commit messages.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Antigravity CLI

.agents/skills/fe-i18n/SKILL.mdskill
.agents/skills/fe-i18n/references/i18n.mdskill
.agents/rules/fe-i18n.mdplik reguł
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

.agents/rules/fe-i18n.md

---
trigger: glob
globs: "**/*.html, **/*.jsx, **/*.tsx, **/*.js, **/*.vue, **/*.svelte, **/*.astro, **/*.css, **/*.scss, **/locales/**, **/messages/**, **/i18n/**"
description: "Makes front-end code ready for more than one language and region - lang and dir, right-to-left layout with logical properties, whole messages with ICU plurals, Intl for dates, numbers, prices and sorting, complete locale files. Use when adding a locale or translations, formatting dates or money, building a language switcher, or when asked \"translate this\" or \"support Arabic\"."
---

# Internationalisation (frontend-skills)

- `<html lang>` follows the active locale and every `lang` is a valid tag (a11y/html-lang, a11y/lang-valid).
- Right-to-left locales set `dir="rtl"` on `<html>`; user text gets `dir="auto"` (i18n/dir-rtl).
- One message per sentence with placeholders; never join translated fragments (i18n/no-string-concat).
- Plurals use ICU `plural` or `Intl.PluralRules`, never `count === 1 ?` (i18n/plural-rules).
- Dates, numbers and prices go through `Intl` formatters, never hand-built strings (i18n/intl-format).
- Pass the app's locale to every formatter; never rely on the runtime default (i18n/explicit-locale).
- Every locale has the same keys, placeholders and the plural categories its language needs (i18n/same-keys).
- With a right-to-left locale, layout uses logical properties (i18n/logical-properties).
- Keep text out of images, let boxes grow for longer translations, and sort user-visible lists with `Intl.Collator`.
- Use the one i18n library the framework already has; never add a second.

Before larger changes, read the full skill: `.agents/skills/fe-i18n/SKILL.md`. Explain any rule id with `npx github:dawidolko/frontend-skills explain <id>`.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Devin / Windsurf

.agents/skills/fe-i18n/SKILL.mdskill
.agents/skills/fe-i18n/references/i18n.mdskill
.devin/rules/fe-i18n.mdplik reguł
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Devin / Windsurf: Devin CLI also reads .cursor/rules; with Cursor chosen too, the CLI sees both rule files of a skill.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

.devin/rules/fe-i18n.md

---
trigger: glob
globs: "**/*.html,**/*.jsx,**/*.tsx,**/*.js,**/*.vue,**/*.svelte,**/*.astro,**/*.css,**/*.scss,**/locales/**,**/messages/**,**/i18n/**"
---

# Internationalisation (frontend-skills)

Makes front-end code ready for more than one language and region - lang and dir, right-to-left layout with logical properties, whole messages with ICU plurals, Intl for dates, numbers, prices and sorting, complete locale files. Use when adding a locale or translations, formatting dates or money, building a language switcher, or when asked "translate this" or "support Arabic".

- `<html lang>` follows the active locale and every `lang` is a valid tag (a11y/html-lang, a11y/lang-valid).
- Right-to-left locales set `dir="rtl"` on `<html>`; user text gets `dir="auto"` (i18n/dir-rtl).
- One message per sentence with placeholders; never join translated fragments (i18n/no-string-concat).
- Plurals use ICU `plural` or `Intl.PluralRules`, never `count === 1 ?` (i18n/plural-rules).
- Dates, numbers and prices go through `Intl` formatters, never hand-built strings (i18n/intl-format).
- Pass the app's locale to every formatter; never rely on the runtime default (i18n/explicit-locale).
- Every locale has the same keys, placeholders and the plural categories its language needs (i18n/same-keys).
- With a right-to-left locale, layout uses logical properties (i18n/logical-properties).
- Keep text out of images, let boxes grow for longer translations, and sort user-visible lists with `Intl.Collator`.
- Use the one i18n library the framework already has; never add a second.

Before larger changes, read the full skill: `.agents/skills/fe-i18n/SKILL.md`. Explain any rule id with `npx github:dawidolko/frontend-skills explain <id>`.

Prawdziwy plik

Gdzie trafia fe-i18n dla: OpenCode

.agents/skills/fe-i18n/SKILL.mdskill
.agents/skills/fe-i18n/references/i18n.mdskill
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

OpenCode nie ma plików reguł zawężonych do typów plików; czyta skille i blok instrukcji.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

AGENTS.md

## Front-end work (frontend-skills)

- Before front-end work, read `.frontend-skills/profile.json` (the stack) and `.frontend-skills/lessons.md` (confirmed conventions of this project; they win over any skill).
- Use the installed `fe-*` skill that matches the files you edit.
- After changing UI code, run `npx github:dawidolko/frontend-skills audit --changed --json` and fix findings at `serious` and above; `explain <rule id>` gives the reason, the source and the fix.
- Name rule ids (such as `a11y/img-alt`) in reviews and commit messages.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Cline

.claude/skills/fe-i18n/SKILL.mdskill
.claude/skills/fe-i18n/references/i18n.mdskill
.clinerules/fe-i18n.mdplik reguł
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Cline: If .clinerules is a single file rather than a folder, Cline rule files are not written; skills still are.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

.clinerules/fe-i18n.md

---
paths:
  - "**/*.html"
  - "**/*.jsx"
  - "**/*.tsx"
  - "**/*.js"
  - "**/*.vue"
  - "**/*.svelte"
  - "**/*.astro"
  - "**/*.css"
  - "**/*.scss"
  - "**/locales/**"
  - "**/messages/**"
  - "**/i18n/**"
---

# Internationalisation (frontend-skills)

Makes front-end code ready for more than one language and region - lang and dir, right-to-left layout with logical properties, whole messages with ICU plurals, Intl for dates, numbers, prices and sorting, complete locale files. Use when adding a locale or translations, formatting dates or money, building a language switcher, or when asked "translate this" or "support Arabic".

- `<html lang>` follows the active locale and every `lang` is a valid tag (a11y/html-lang, a11y/lang-valid).
- Right-to-left locales set `dir="rtl"` on `<html>`; user text gets `dir="auto"` (i18n/dir-rtl).
- One message per sentence with placeholders; never join translated fragments (i18n/no-string-concat).
- Plurals use ICU `plural` or `Intl.PluralRules`, never `count === 1 ?` (i18n/plural-rules).
- Dates, numbers and prices go through `Intl` formatters, never hand-built strings (i18n/intl-format).
- Pass the app's locale to every formatter; never rely on the runtime default (i18n/explicit-locale).
- Every locale has the same keys, placeholders and the plural categories its language needs (i18n/same-keys).
- With a right-to-left locale, layout uses logical properties (i18n/logical-properties).
- Keep text out of images, let boxes grow for longer translations, and sort user-visible lists with `Intl.Collator`.
- Use the one i18n library the framework already has; never add a second.

Before larger changes, read the full skill: `.claude/skills/fe-i18n/SKILL.md`. Explain any rule id with `npx github:dawidolko/frontend-skills explain <id>`.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Zed

.agents/skills/fe-i18n/SKILL.mdskill
.agents/skills/fe-i18n/references/i18n.mdskill
CLAUDE.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Zed: Zed reads only the first instruction file of its list; the block is placed in that file.

Zed nie ma plików reguł zawężonych do typów plików; czyta skille i blok instrukcji.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

CLAUDE.md

## Front-end work (frontend-skills)

- Before front-end work, read `.frontend-skills/profile.json` (the stack) and `.frontend-skills/lessons.md` (confirmed conventions of this project; they win over any skill).
- Use the installed `fe-*` skill that matches the files you edit.
- After changing UI code, run `npx github:dawidolko/frontend-skills audit --changed --json` and fix findings at `serious` and above; `explain <rule id>` gives the reason, the source and the fix.
- Name rule ids (such as `a11y/img-alt`) in reviews and commit messages.

Prawdziwy plik

Gdzie trafia fe-i18n dla: JetBrains Junie

.agents/skills/fe-i18n/SKILL.mdskill
.agents/skills/fe-i18n/references/i18n.mdskill
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

JetBrains Junie: Junie reads .agents/skills only in a trusted project.

JetBrains Junie nie ma plików reguł zawężonych do typów plików; czyta skille i blok instrukcji.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

AGENTS.md

## Front-end work (frontend-skills)

- Before front-end work, read `.frontend-skills/profile.json` (the stack) and `.frontend-skills/lessons.md` (confirmed conventions of this project; they win over any skill).
- Use the installed `fe-*` skill that matches the files you edit.
- After changing UI code, run `npx github:dawidolko/frontend-skills audit --changed --json` and fix findings at `serious` and above; `explain <rule id>` gives the reason, the source and the fix.
- Name rule ids (such as `a11y/img-alt`) in reviews and commit messages.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Kiro

.kiro/skills/fe-i18n/SKILL.mdskill
.kiro/skills/fe-i18n/references/i18n.mdskill
.kiro/steering/fe-i18n.mdplik reguł
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

.kiro/steering/fe-i18n.md

---
inclusion: fileMatch
fileMatchPattern: ["**/*.html", "**/*.jsx", "**/*.tsx", "**/*.js", "**/*.vue", "**/*.svelte", "**/*.astro", "**/*.css", "**/*.scss", "**/locales/**", "**/messages/**", "**/i18n/**"]
---

# Internationalisation (frontend-skills)

Makes front-end code ready for more than one language and region - lang and dir, right-to-left layout with logical properties, whole messages with ICU plurals, Intl for dates, numbers, prices and sorting, complete locale files. Use when adding a locale or translations, formatting dates or money, building a language switcher, or when asked "translate this" or "support Arabic".

- `<html lang>` follows the active locale and every `lang` is a valid tag (a11y/html-lang, a11y/lang-valid).
- Right-to-left locales set `dir="rtl"` on `<html>`; user text gets `dir="auto"` (i18n/dir-rtl).
- One message per sentence with placeholders; never join translated fragments (i18n/no-string-concat).
- Plurals use ICU `plural` or `Intl.PluralRules`, never `count === 1 ?` (i18n/plural-rules).
- Dates, numbers and prices go through `Intl` formatters, never hand-built strings (i18n/intl-format).
- Pass the app's locale to every formatter; never rely on the runtime default (i18n/explicit-locale).
- Every locale has the same keys, placeholders and the plural categories its language needs (i18n/same-keys).
- With a right-to-left locale, layout uses logical properties (i18n/logical-properties).
- Keep text out of images, let boxes grow for longer translations, and sort user-visible lists with `Intl.Collator`.
- Use the one i18n library the framework already has; never add a second.

Before larger changes, read the full skill: `.kiro/skills/fe-i18n/SKILL.md`. Explain any rule id with `npx github:dawidolko/frontend-skills explain <id>`.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Augment

.agents/skills/fe-i18n/SKILL.mdskill
.agents/skills/fe-i18n/references/i18n.mdskill
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Augment nie ma plików reguł zawężonych do typów plików; czyta skille i blok instrukcji.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

AGENTS.md

## Front-end work (frontend-skills)

- Before front-end work, read `.frontend-skills/profile.json` (the stack) and `.frontend-skills/lessons.md` (confirmed conventions of this project; they win over any skill).
- Use the installed `fe-*` skill that matches the files you edit.
- After changing UI code, run `npx github:dawidolko/frontend-skills audit --changed --json` and fix findings at `serious` and above; `explain <rule id>` gives the reason, the source and the fix.
- Name rule ids (such as `a11y/img-alt`) in reviews and commit messages.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Trae

.trae/skills/fe-i18n/SKILL.mdskill
.trae/skills/fe-i18n/references/i18n.mdskill
.trae/rules/fe-i18n.mdplik reguł
AGENTS.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Trae: Trae reads AGENTS.md only after it is enabled in its settings.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

.trae/rules/fe-i18n.md

---
description: "Makes front-end code ready for more than one language and region - lang and dir, right-to-left layout with logical properties, whole messages with ICU plurals, Intl for dates, numbers, prices and sorting, complete locale files. Use when adding a locale or translations, formatting dates or money, building a language switcher, or when asked \"translate this\" or \"support Arabic\"."
globs: **/*.html,**/*.jsx,**/*.tsx,**/*.js,**/*.vue,**/*.svelte,**/*.astro,**/*.css,**/*.scss,**/locales/**,**/messages/**,**/i18n/**
alwaysApply: false
---

# Internationalisation (frontend-skills)

- `<html lang>` follows the active locale and every `lang` is a valid tag (a11y/html-lang, a11y/lang-valid).
- Right-to-left locales set `dir="rtl"` on `<html>`; user text gets `dir="auto"` (i18n/dir-rtl).
- One message per sentence with placeholders; never join translated fragments (i18n/no-string-concat).
- Plurals use ICU `plural` or `Intl.PluralRules`, never `count === 1 ?` (i18n/plural-rules).
- Dates, numbers and prices go through `Intl` formatters, never hand-built strings (i18n/intl-format).
- Pass the app's locale to every formatter; never rely on the runtime default (i18n/explicit-locale).
- Every locale has the same keys, placeholders and the plural categories its language needs (i18n/same-keys).
- With a right-to-left locale, layout uses logical properties (i18n/logical-properties).
- Keep text out of images, let boxes grow for longer translations, and sort user-visible lists with `Intl.Collator`.
- Use the one i18n library the framework already has; never add a second.

Before larger changes, read the full skill: `.trae/skills/fe-i18n/SKILL.md`. Explain any rule id with `npx github:dawidolko/frontend-skills explain <id>`.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Continue

.frontend-skills/skills/fe-i18n/SKILL.mdskill
.frontend-skills/skills/fe-i18n/references/i18n.mdskill
.continue/rules/fe-i18n.mdplik reguł

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

.continue/rules/fe-i18n.md

---
name: "Internationalisation"
description: "Makes front-end code ready for more than one language and region - lang and dir, right-to-left layout with logical properties, whole messages with ICU plurals, Intl for dates, numbers, prices and sorting, complete locale files. Use when adding a locale or translations, formatting dates or money, building a language switcher, or when asked \"translate this\" or \"support Arabic\"."
globs: ["**/*.html", "**/*.jsx", "**/*.tsx", "**/*.js", "**/*.vue", "**/*.svelte", "**/*.astro", "**/*.css", "**/*.scss", "**/locales/**", "**/messages/**", "**/i18n/**"]
alwaysApply: false
---

# Internationalisation (frontend-skills)

- `<html lang>` follows the active locale and every `lang` is a valid tag (a11y/html-lang, a11y/lang-valid).
- Right-to-left locales set `dir="rtl"` on `<html>`; user text gets `dir="auto"` (i18n/dir-rtl).
- One message per sentence with placeholders; never join translated fragments (i18n/no-string-concat).
- Plurals use ICU `plural` or `Intl.PluralRules`, never `count === 1 ?` (i18n/plural-rules).
- Dates, numbers and prices go through `Intl` formatters, never hand-built strings (i18n/intl-format).
- Pass the app's locale to every formatter; never rely on the runtime default (i18n/explicit-locale).
- Every locale has the same keys, placeholders and the plural categories its language needs (i18n/same-keys).
- With a right-to-left locale, layout uses logical properties (i18n/logical-properties).
- Keep text out of images, let boxes grow for longer translations, and sort user-visible lists with `Intl.Collator`.
- Use the one i18n library the framework already has; never add a second.

Before larger changes, read the full skill: `.frontend-skills/skills/fe-i18n/SKILL.md`. Explain any rule id with `npx github:dawidolko/frontend-skills explain <id>`.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Amazon Q Developer

.frontend-skills/skills/fe-i18n/SKILL.mdskill
.frontend-skills/skills/fe-i18n/references/i18n.mdskill
.amazonq/rules/frontend-skills.mdblok instrukcji

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Amazon Q Developer: Amazon Q Developer IDE plugins reach end of support on 2027-04-30; AWS points to Kiro.

Amazon Q Developer nie ma plików reguł zawężonych do typów plików; czyta skille i blok instrukcji.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

.amazonq/rules/frontend-skills.md

## Front-end work (frontend-skills)

- Before front-end work, read `.frontend-skills/profile.json` (the stack) and `.frontend-skills/lessons.md` (confirmed conventions of this project; they win over any skill).
- Use the installed `fe-*` skill that matches the files you edit.
- After changing UI code, run `npx github:dawidolko/frontend-skills audit --changed --json` and fix findings at `serious` and above; `explain <rule id>` gives the reason, the source and the fix.
- Name rule ids (such as `a11y/img-alt`) in reviews and commit messages.

### Skills

- `fe-i18n` (Internationalisation): when editing `**/*.html`, `**/*.jsx`, `**/*.tsx`, `**/*.js`, `**/*.vue`, `**/*.svelte`, `**/*.astro`, `**/*.css`, `**/*.scss`, `**/locales/**`, `**/messages/**`, `**/i18n/**`, first read `.frontend-skills/skills/fe-i18n/SKILL.md`.

Prawdziwy plik

Gdzie trafia fe-i18n dla: Aider

.frontend-skills/skills/fe-i18n/SKILL.mdskill
.frontend-skills/skills/fe-i18n/references/i18n.mdskill
CONVENTIONS.mdblok instrukcji
.aider.conf.ymlkonfiguracja

Dla każdego agenta także: .frontend-skills/profile.json, .frontend-skills/lessons.md i .frontend-skills/install.json.

Aider nie ma plików reguł zawężonych do typów plików; czyta skille i blok instrukcji.

Zaplanowane przez sam instalator dla przykładowego projektu React z repozytorium.

CONVENTIONS.md

## Front-end work (frontend-skills)

- Before front-end work, read `.frontend-skills/profile.json` (the stack) and `.frontend-skills/lessons.md` (confirmed conventions of this project; they win over any skill).
- Use the installed `fe-*` skill that matches the files you edit.
- After changing UI code, run `npx github:dawidolko/frontend-skills audit --changed --json` and fix findings at `serious` and above; `explain <rule id>` gives the reason, the source and the fix.
- Name rule ids (such as `a11y/img-alt`) in reviews and commit messages.

### Skills

- `fe-i18n` (Internationalisation): when editing `**/*.html`, `**/*.jsx`, `**/*.tsx`, `**/*.js`, `**/*.vue`, `**/*.svelte`, `**/*.astro`, `**/*.css`, `**/*.scss`, `**/locales/**`, `**/messages/**`, `**/i18n/**`, first read `.frontend-skills/skills/fe-i18n/SKILL.md`.

Prawdziwy plik

Jak go używać

Po instalacji agent sam ładuje skill, gdy zadanie pasuje do jego opisu. Możesz też poprosić o niego własnymi słowami, na przykład:

Frazy z opisu skilla, po których agent go wybiera (po angielsku, jak w skillu):

translate this
support Arabic

A żeby sprawdzić i poprawić pracę:

Użyj skilla fe-i18n na tym pliku.
Uruchom audyt front-endu na moich zmianach i popraw wszystko, co poważne.
Wyjaśnij a11y/html-lang i popraw to tutaj.

Reguły, których uczy

a11y/html-lang
The html element names the language of the page in a non-empty lang attribute.
poważnastatyczneWCAG 3.1.1
a11y/lang-valid
Every lang value is a valid BCP 47 language tag ("en", "en-GB", "pl"), never "en_US" or a language name.
poważnastatyczneWCAG 3.1.1, 3.1.2
i18n/dir-rtl
Pages in right-to-left languages (Arabic, Hebrew, Persian, Urdu) set dir="rtl" on html together with lang.
poważnastatyczne
i18n/no-string-concat
User-facing sentences are one message with placeholders, never joined from translated fragments and values.
umiarkowanastatyczne
i18n/plural-rules
Plurals use the locale's plural rules (ICU plural or Intl.PluralRules), never count === 1 ? singular : plural.
umiarkowanastatyczne
i18n/intl-format
Dates, times, numbers and prices are formatted with Intl for the user's locale, never assembled from parts.
umiarkowanastatyczne
i18n/explicit-locale
Intl formatters and toLocale*String() receive the app's active locale instead of relying on the runtime default.
drobnastatyczne
i18n/same-keys
Every locale file has the same keys and placeholders as the source locale, and the plural forms its language needs.
poważnaręczne
i18n/logical-properties
In projects with a right-to-left locale, layout uses logical properties (margin-inline-start, inset-inline-end, text-align start).
umiarkowanaręczne

Skrót reguł

Ta część jest kopiowana do zawężonego pliku reguł każdego agenta, więc musi być zrozumiała sama w sobie:

<html lang> follows the active locale and every lang is a valid tag (a11y/html-lang, a11y/lang-valid).
Right-to-left locales set dir="rtl" on <html>; user text gets dir="auto" (i18n/dir-rtl).
One message per sentence with placeholders; never join translated fragments (i18n/no-string-concat).
Plurals use ICU plural or Intl.PluralRules, never count === 1 ? (i18n/plural-rules).
Dates, numbers and prices go through Intl formatters, never hand-built strings (i18n/intl-format).
Pass the app's locale to every formatter; never rely on the runtime default (i18n/explicit-locale).
Every locale has the same keys, placeholders and the plural categories its language needs (i18n/same-keys).
With a right-to-left locale, layout uses logical properties (i18n/logical-properties).
Keep text out of images, let boxes grow for longer translations, and sort user-visible lists with Intl.Collator.
Use the one i18n library the framework already has; never add a second.

Kroki, które wykonuje agent

Find the i18n setup: the profile's i18n entry, a locales/ or messages/ folder, next-intl, @nuxtjs/i18n, vue-i18n, Paraglide, react-intl, i18next, Angular $localize.
Add every new user-visible string as a message key in the source locale, with a translator comment when the context is unclear, then the same key in every other locale.
Format values with the library's formatters or Intl, passing the active locale; keep ISO strings for machines.
For a new locale: add it to the routing config, <html lang dir>, hreflang (fe-seo-metadata), the language switcher (links with hreflang and lang), and check plural categories with Intl.PluralRules.
Test long and right-to-left text: a pseudo-locale that lengthens strings by about 40%, and one RTL locale.

Jak agent sprawdza swoją pracę

npx github:dawidolko/frontend-skills audit --changed finds missing dir on RTL pages, concatenated messages, === 1 plurals, hand-built dates and prices, formatters without a locale and invalid lang values.
By hand: switch to each locale and to an RTL locale; look for raw keys, clipped text, wrong number and date formats, and icons that point the wrong way.

Sprawdzane audytem

Testy statyczne tych reguł działają w audit; to prawdziwa sesja na przykładowym projekcie:

Nagranie terminala: audit wypisuje znaleziska według wagi z identyfikatorami reguł i miejscem plik:linia i kończy się błędem od progu serious. — `audit`: liczby według wagi, każda reguła z pierwszym miejscem, kod wyjścia.

Pliki referencyjne

references/i18n.md1550 tokenów

SKILL.md na GitHubie