Communitygithub.com

i18n & Lokalisierung

Workflow für Internationalisierung und Lokalisierung. Verwende diesen Skill, wenn der Nutzer Muster zur Internationalisierung und Lokalisierung benötigt: Erkennen von hartcodierten Zeichenfolgen, Verwalten von Übersetzungen, Lokalisierungsdateien, RTL-Unterstützung. Der Operator sollte den Upstream-Workflow, kopierte Support-Dateien und die Herkunft vor einem Merge oder einer Übergabe bewahren.

Was ist i18n & Lokalisierung?

Dieser Skill kapselt den i18n/L10n-Workflow aus dem Upstream-Repository `antigravity-awesome-skills` in eine native Omni-Skills-Form, ohne dessen Herkunft zu verbergen. Er ist perfekt für Entwickler, die mit Cursor, Claude Code oder anderen KI-Agenten arbeiten – er sorgt dafür, dass der Upstream-Workflow, vorhandene Support-Dateien und der Repository-Kontext intakt bleiben, während der öffentliche Validator und der private Enhancer ihren normalen Downstream-Fluss fortsetzen. Der Skill bewahrt die Herkunft durch einen `external_source`-Block in `metadata.json` und eine `ORIGIN.md`-Datei. Er bietet bewährte Verfahren, Implementierungsmuster (z. B. react-i18next, next-intl, gettext), eine empfohlene Dateistruktur, RTL-Unterstützung mit CSS Logical Properties, eine Checkliste vor der Auslieferung und ein Skript `scripts/i18n_checker.py`, um hartcodierte Zeichenfolgen und fehlende Übersetzungen zu erkennen. Der Skill ist plattformunabhängig und kann in Web-Apps, SaaS-Produkten und internen Tools eingesetzt werden; er sollte jedoch nicht als Ersatz für umgebungsspezifische Tests oder Expertenüberprüfungen dienen.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Gemini CLI✓OpenCode
npx skills add https://github.com/diegosouzapw/awesome-omni-skills/tree/HEAD/skills/i18n-localization-v2

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht i18n & Lokalisierung?

Überblick

Dieser öffentliche Intake-Kopie enthält plugins/antigravity-awesome-skills/skills/i18n-localization aus https://github.com/sickn33/antigravity-awesome-skills in der nativen Omni-Skills-Redaktionsform, ohne seine Herkunft zu verbergen.

Verwende ihn, wenn der Operator den Upstream-Workflow, die Support-Dateien und den Repository-Kontext intakt halten muss, während der öffentliche Validator und der private Enhancer ihren normalen Downstream-Fluss fortsetzen.

Dieser Intake bewahrt die kopierten Upstream-Dateien intakt und verwendet den external_source-Block in metadata.json sowie ORIGIN.md als Herkunftsanker für die Überprüfung.

i18n & Lokalisierung > Internationalisierung (i18n) und Lokalisierung (L10n) – Best Practices. ---

Importierte Quellabschnitte, die nicht sauber auf die öffentlichen Überschriften abgebildet werden konnten, sind unten oder in den Support-Dateien erhalten. Bemerkenswerte importierte Abschnitte: 1. Kernkonzepte, 3. Implementierungsmuster, 4. Dateistruktur, 6. Häufige Probleme, 7. RTL-Unterstützung, 8. Checkliste.

Wann dieser Skill verwendet werden sollte

Verwende diesen Abschnitt als Auslösefilter. Er sollte die Aktivierungsgrenze explizit machen, bevor der Operator Dateien lädt, Befehle ausführt oder einen Pull Request eröffnet.

  • Projekttyp – i18n erforderlich?
  • Öffentliche Web-App - ✅ Ja
  • SaaS-Produkt - ✅ Ja
  • Internes Tool - ⚠️ Vielleicht
  • Ein-Regionen-App - ⚠️ Zukunft bedenken
  • Persönliches Projekt - ❌ Optional

Betriebstabelle

SituationHier startenWarum es wichtig ist
Erste Nutzungmetadata.jsonBestätigt Repository, Branch, Commit und importierten Pfad durch den external_source-Block, bevor der kopierte Workflow berührt wird
HerkunftsprüfungORIGIN.mdGibt Prüfern einen Klartext-Prüfpfad für die importierte Quelle
Workflow-Ausführungscripts/i18n_checker.pyStartet mit der kleinsten kopierten Datei, die die Ausführung materiell verändert
Unterstützender Kontextscripts/i18n_checker.pyFügt die nächstrelevanteste kopierte Quelldatei hinzu, ohne das gesamte Paket zu laden
Übergabeentscheidung## Verwandte SkillsHilft dem Operator, zu einem stärkeren nativen Skill zu wechseln, wenn die Aufgabe abweicht

Workflow

Dieser Workflow ist absichtlich redaktionell und operativ zugleich. Er hält die importierte Quelle für den Operator nützlich, während er gleichzeitig die öffentlichen Intake-Standards erfüllt, die den Downstream-Enhancer-Fluss speisen.

  1. Bestätige das Benutzerziel, den Umfang des importierten Workflows und ob dieser Skill noch der richtige Router für die Aufgabe ist.
  2. Lies die Übersichts- und Herkunftsdateien, bevor du kopierte Upstream-Support-Dateien lädst.
  3. Lade nur die Referenzen, Beispiele, Prompts oder Skripte, die das Ergebnis für die aktuelle Anfrage materiell verändern.
  4. Führe den Upstream-Workflow aus, während du die Herkunft und Quellgrenzen in den Arbeitsnotizen explizit hältst.
  5. Validiere das Ergebnis gegen die Upstream-Erwartungen und die Beweise, auf die du in den kopierten Dateien verweisen kannst.
  6. Eskaliere oder übergebe an einen verwandten Skill, wenn die Arbeit den Schwerpunkt dieses importierten Workflows verlässt.
  7. Vor dem Merge oder Abschluss dokumentiere, was verwendet wurde, was sich geändert hat und was der Prüfer noch überprüfen muss.

Importierte Workflow-Notizen

Importiert: 1. Kernkonzepte

BegriffBedeutung
i18nInternationalisierung – App übersetzbar machen
L10nLokalisierung – tatsächliche Übersetzungen
LocaleSprache + Region (en-US, tr-TR)
RTLRechts-nach-links-Sprachen (Arabisch, Hebräisch)

Beispiele

Beispiel 1: Direkt nach dem Upstream-Workflow fragen

Verwende @i18n-localization-v2, um <Aufgabe> zu erledigen. Starte mit dem kopierten Upstream-Workflow, lade nur die Dateien, die das Ergebnis ändern, und halte die Herkunft in der Antwort sichtbar.

Erklärung: Dies ist der sicherste Startpunkt, wenn der Operator den importierten Workflow, aber nicht das gesamte Repository benötigt.

Beispiel 2: Um eine herkunftsbasierte Überprüfung bitten

Überprüfe @i18n-localization-v2 anhand von metadata.json und ORIGIN.md und erkläre dann, welche kopierten Upstream-Dateien du zuerst laden würdest und warum.

Erklärung: Verwende dies vor einer Überprüfung oder Fehlersuche, wenn du eine präzise, prüfbare Erklärung zur Herkunft und Dateiauswahl benötigst.

Beispiel 3: Die kopierten Support-Dateien vor der Ausführung eingrenzen

Verwende @i18n-localization-v2 für <Aufgabe>. Lade nur die kopierten Referenzen, Beispiele oder Skripte, die das Ergebnis ändern, und nenne die Dateien explizit, bevor du fortfährst.

Erklärung: Dies hält den Skill auf progressive Offenlegung ausgerichtet, anstatt standardmäßig das gesamte kopierte Paket zu laden.

Beispiel 4: Ein Prüfpaket erstellen

Überprüfe @i18n-localization-v2 unter Verwendung der kopierten Upstream-Dateien sowie der Herkunft und fasse dann etwaige Lücken vor dem Merge zusammen.

Erklärung: Dies ist nützlich, wenn der PR auf eine menschliche Überprüfung wartet und du ein wiederholbares Prüfprotokoll haben möchtest.


Best Practices

Behandle den generierten öffentlichen Skill als eine überprüfbare Verpackungsschicht um das Upstream-Repository. Das Ziel ist es, die Herkunft explizit zu halten und nur das kopierte Quellmaterial zu laden, das die Ausführung materiell verbessert.

  • Verwende Übersetzungsschlüssel, keinen Rohtext
  • Namespace-Übersetzungen nach Funktion
  • Unterstütze Pluralisierung
  • Behandle Datums-/Zahlenformate pro Locale
  • Plane RTL von Anfang an ein
  • Verwende ICU-Nachrichtenformat für komplexe Zeichenfolgen
  • Hardcodierte Zeichenfolgen in Komponenten

Importierte Betriebshinweise

Importiert: 5. Best Practices

TUN ✅

  • Verwende Übersetzungsschlüssel, keinen Rohtext
  • Namespace-Übersetzungen nach Funktion
  • Unterstütze Pluralisierung
  • Behandle Datums-/Zahlenformate pro Locale
  • Plane RTL von Anfang an ein
  • Verwende ICU-Nachrichtenformat für komplexe Zeichenfolgen

NICHT TUN ❌

  • Hardcodiere Zeichenfolgen in Komponenten
  • Verkette übersetzte Zeichenfolgen
  • Nimm Textlänge an (Deutsch ist 30 % länger)
  • Vergiss RTL-Layout
  • Mische Sprachen in derselben Datei

Fehlerbehebung

Problem: Der Operator hat den importierten Kontext übersprungen und zu allgemein geantwortet

Symptome: Das Ergebnis ignoriert den Upstream-Workflow in plugins/antigravity-awesome-skills/skills/i18n-localization, erwähnt keine Herkunft oder verwendet überhaupt keine kopierten Quelldateien. Lösung: Öffne metadata.json, ORIGIN.md und die relevantesten kopierten Upstream-Dateien erneut. Überprüfe zuerst den external_source-Block und gib dann die Herkunft erneut an, bevor du fortfährst.

Problem: Der importierte Workflow fühlt sich während der Überprüfung unvollständig an

Symptome: Prüfer sehen die generierte SKILL.md, können aber nicht schnell erkennen, welche Referenzen, Beispiele oder Skripte für die aktuelle Aufgabe wichtig sind. Lösung: Verweise auf die genauen kopierten Referenzen, Beispiele, Skripte oder Assets, die deinen gewählten Weg rechtfertigen. Wenn die Lücke real ist, dokumentiere sie im PR, anstatt sie zu verbergen.

Problem: Die Aufgabe ist in eine andere Spezialisierung abgedriftet

Symptome: Der importierte Skill beginnt an der richtigen Stelle, aber die Arbeit verwandelt sich in Debugging, Architektur, Design, Sicherheit oder Release-Orchestrierung, die ein nativer Skill besser handhabt. Lösung: Verwende den Abschnitt „Verwandte Skills“, um gezielt zu übergeben. Halte die importierte Herkunft sichtbar, sodass der nächste Skill den richtigen Kontext erbt, anstatt blind zu starten.


Verwandte Skills

  • @00-andruia-consultant – Verwende, wenn die Arbeit besser von dieser nativen Spezialisierung erledigt wird, nachdem dieser importierte Skill den Kontext hergestellt hat.
  • @00-andruia-consultant-v2 – Verwende, wenn die Arbeit besser von dieser nativen Spezialisierung erledigt wird, nachdem dieser importierte Skill den Kontext hergestellt hat.
  • @10-andruia-skill-smith – Verwende, wenn die Arbeit besser von dieser nativen Spezialisierung erledigt wird, nachdem dieser importierte Skill den Kontext hergestellt hat.
  • @10-andruia-skill-smith-v2 – Verwende, wenn die Arbeit besser von dieser nativen Spezialisierung erledigt wird, nachdem dieser importierte Skill den Kontext hergestellt hat.

Zusätzliche Ressourcen

Verwende diese Support-Matrix und die verlinkten Dateien unten als Operator-Paket für diesen importierten Skill. Sie sollten echtes kopiertes Quellmaterial widerspiegeln, keine generische Gerüste.

RessourcenfamilieWas sie dem Prüfer gibtBeispielpfad
referenceskopierte Referenznotizen, Anleitungen oder Hintergrundmaterial aus dem Upstreamreferences/n/a
examplesausgearbeitete Beispiele oder wiederverwendbare Prompts aus dem Upstreamexamples/n/a
scriptsUpstream-Hilfsskripte, die die Ausführung oder Validierung ändernscripts/i18n_checker.py
agentsRouting- oder Delegationsnotizen, die wirklich Teil des importierten Pakets sindagents/n/a
assetsunterstützende Assets oder Schemata aus dem Quellpaketassets/n/a

Importierte Referenznotizen

Importiert: 3. Implementierungsmuster

React (react-i18next)

import { useTranslation } from 'react-i18next';

function Welcome() {
  const { t } = useTranslation();
  return <h1>{t('welcome.title')}</h1>;
}

Next.js (next-intl)

import { useTranslations } from 'next-intl';

export default function Page() {
  const t = useTranslations('Home');
  return <h1>{t('title')}</h1>;
}

Python (gettext)

from gettext import gettext as _

print(_("Welcome to our app"))

Importiert: 4. Dateistruktur

locales/
├── en/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
├── tr/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
└── ar/          # RTL
    └── ...

Importiert: 6. Häufige Probleme

ProblemLösung
Fehlende ÜbersetzungFallback auf Standardsprache
Hartcodierte ZeichenfolgenLinter/Checker-Skript verwenden
DatumsformatIntl.DateTimeFormat verwenden
ZahlenformatIntl.NumberFormat verwenden
PluralisierungICU-Nachrichtenformat verwenden

Importiert: 7. RTL-Unterstützung

/* CSS Logical Properties */
.container {
  margin-inline-start: 1rem;  /* Nicht margin-left */
  padding-inline-end: 1rem;   /* Nicht padding-right */
}

[dir="rtl"] .icon {
  transform: scaleX(-1);
}

Importiert: 8. Checkliste

Vor der Auslieferung:

  • Alle benutzerseitigen Zeichenfolgen verwenden Übersetzungsschlüssel
  • Locale-Dateien existieren für alle unterstützten Sprachen
  • Datums-/Zahlenformatierung verwendet Intl API
  • RTL-Layout getestet (falls zutreffend)
  • Fallback-Sprache konfiguriert
  • Keine hartcodierten Zeichenfolgen in Komponenten

Importiert: Skript

SkriptZweckBefehl
scripts/i18n_checker.pyHartcodierte Zeichenfolgen und fehlende Übersetzungen erkennenpython scripts/i18n_checker.py <Projektpfad>

Importiert: Einschränkungen

  • Verwende diesen Skill nur, wenn die Aufgabe klar mit dem oben beschriebenen Umfang übereinstimmt.
  • Betrachte die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
  • Halte inne und frage nach Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

diegosouzapw/awesome-omni-skills

AgentFolio workflow skill. Use this skill when the user needs Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

AgentFolio workflow skill. Use this skill when the user needs Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

AI UGC Ads workflow skill. Use this skill when the user needs When the user wants to create UGC ad campaigns, recruit UGC creators, generate AI UGC content, or scale with user-generated content. Also use when the user mentions 'UGC,' 'user-generated content,' 'creator ads,' 'Spark Ads,' 'whitelisting,' 'AI UGC,' 'Arcads,' 'Creatify,' 'creator brief,' or 'UGC testing.' This skill covers the UGC growth framework from creator recruitment through AI-powered scaling. Do NOT use for technical implementation, code review, or software architecture and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Astro Web Framework workflow skill. Use this skill when the user needs Build content-focused websites with Astro \u2014 zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Fal Image Edit workflow skill. Use this skill when the user needs AI-powered image editing with style transfer and object removal and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Fal Image Edit workflow skill. Use this skill when the user needs AI-powered image editing with style transfer and object removal and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

frontend-design workflow skill. Use this skill when the user needs Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications. Generates creative, polished code that avoids generic AI aesthetics. Do NOT use for design review or audit (use web-design-guidelines or web-quality-audit) and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Frontend Design (Distinctive, Production-Grade) workflow skill. Use this skill when the user needs You are a frontend designer-engineer, not a layout generator and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

i18n & Localization workflow skill. Use this skill when the user needs Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Landing Page Generator workflow skill. Use this skill when the user needs Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Landing Page Generator workflow skill. Use this skill when the user needs Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Paid Creative AI workflow skill. Use this skill when the user needs When the user wants to create AI-generated ad creative, test performance creative, manage creative fatigue, or optimize paid media with AI tools. Also use when the user mentions 'ad creative,' 'performance creative,' 'creative testing,' 'creative fatigue,' 'Meta ads,' 'Google ads,' 'TikTok ads,' 'AI ads,' 'ad budget,' 'ROAS,' 'Advantage+,' or 'Performance Max.' This skill covers AI-powered paid creative from generation through performance optimization. Do NOT use for technical implementation, code review, or software architecture and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

SEO-AEO Landing Page Writer workflow skill. Use this skill when the user needs Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

SEO-AEO Landing Page Writer workflow skill. Use this skill when the user needs Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

Verwandte Skills