Communitygithub.com

JantonioFC/skillsbank

Patterns für Internationalisierung und Lokalisierung. Erkennung von hartcodierten Zeichenketten, Verwaltung von Übersetzungen, Locale-Dateien und RTL-Unterstützung.

Was ist skillsbank?

Diese Fähigkeit (Skill) bietet einen umfassenden Leitfaden zu Best Practices für Internationalisierung (i18n) und Lokalisierung (L10n) in Softwareentwicklungsprojekten. Sie ist nützlich für Entwickler, die Anwendungen mehrsprachig und für verschiedene Regionen anpassbar machen möchten, einschließlich Unterstützung für Rechts-nach-Links-Sprachen (RTL). Der Skill beschreibt Kernkonzepte wie Locale und RTL, zeigt Implementierungsmuster für gängige Frameworks wie React (react-i18next), Next.js (next-intl) und Python (gettext) sowie empfohlene Dateistrukturen für Lokalisierungsdateien. Er enthält eine Checkliste zur Sicherstellung der i18n-Bereitschaft und ein Skript (`scripts/i18n_checker.py`), um hartcodierte Zeichenketten und fehlende Übersetzungen zu erkennen. Die beschriebenen Patterns sind plattformunabhängig und können in Web-Apps, SaaS-Produkten und anderen Projekten angewendet werden, jedoch nicht für rein interne oder persönliche Vorhaben ohne Mehrsprachigkeitsbedarf.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JantonioFC/skillsbank/tree/HEAD/plugins/antigravity-awesome-skills-claude/skills/i18n-localization

In Ihrer bevorzugten KI fragen

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

Dokumentation

i18n & Lokalisierung

Internationalisierung (i18n) und Lokalisierung (L10n) – Best Practices.


1. Kernkonzepte

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

2. Wann i18n verwenden

Projekttypi18n erforderlich?
Öffentliche Web-App✅ Ja
SaaS-Produkt✅ Ja
Internes Tool⚠️ Eventuell
Einregionen-App⚠️ Zukunft bedenken
Persönliches Projekt❌ Optional

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(_("Willkommen in unserer App"))

4. Dateistruktur

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

5. Best Practices

TUN ✅

  • Übersetzungsschlüssel verwenden, keinen Rohtext
  • Übersetzungen nach Feature gruppieren (Namespaces)
  • Pluralisierung unterstützen
  • Datums-/Zahlenformate pro Locale handhaben
  • RTL von Anfang an einplanen
  • ICU-Nachrichtenformat für komplexe Zeichenketten nutzen

NICHT TUN ❌

  • Zeichenketten in Komponenten hartcodieren
  • Übersetzte Zeichenketten verketten
  • Textlänge als gegeben annehmen (Deutsch ist 30 % länger)
  • RTL-Layout vergessen
  • Sprachen in derselben Datei mischen

6. Häufige Probleme

ProblemLösung
Fehlende ÜbersetzungFallback auf Standardsprache
Hartcodierte ZeichenkettenLinter-/Prüfskript verwenden
DatumsformatIntl.DateTimeFormat nutzen
ZahlenformatIntl.NumberFormat nutzen
PluralisierungICU-Nachrichtenformat nutzen

7. RTL-Unterstützung

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

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

8. Checkliste

Vor der Auslieferung:

  • Alle benutzersichtbaren Zeichenketten 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 Zeichenketten in Komponenten

Skript

SkriptZweckBefehl
scripts/i18n_checker.pyHartcodierte Zeichenketten & fehlende Übersetzungen erkennenpython scripts/i18n_checker.py <projekt_pfad>

Verwendung

Dieser Skill ist anwendbar, um den im Überblick beschriebenen Workflow oder die beschriebenen Aktionen auszuführen.

Einschränkungen

  • Verwenden Sie diesen Skill nur, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
  • Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
  • Fragen Sie nach und bitten Sie um 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.

JantonioFC/skillsbank

AI-powered image editing with style transfer and object removal

JantonioFC/skillsbank

Analise e auditoria de editais de leilao judicial e extrajudicial. Riscos ocultos, clausulas perigosas, debitos, ocupante e classificacao da oportunidade.

JantonioFC/skillsbank

Embed Photopea in web apps using photopea.js. Covers embedding, file I/O, scripting, exporting, layers, text, filters, and the full Photoshop-compatible API.

JantonioFC/skillsbank

Best practices for Remotion - Video creation in React

JantonioFC/skillsbank

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

JantonioFC/skillsbank

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

JantonioFC/skillsbank

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.

JantonioFC/skillsbank

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

JantonioFC/skillsbank

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

JantonioFC/skillsbank

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

JantonioFC/skillsbank

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

JantonioFC/skillsbank

Tool lifecycle UI components for React/Next.js from ui.inference.sh. Display tool calls: pending, progress, approval required, results. Capabilities: tool status, progress indicators, approval flows, results display. Use for: showing agent tool calls, human-in-the-loop approvals, tool output. Triggers: tool ui, tool calls, tool status, tool approval, tool results, agent tools, mcp tools ui, function calling ui, tool lifecycle, tool pending

JantonioFC/skillsbank

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

JantonioFC/skillsbank

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,'...

JantonioFC/skillsbank

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, expla...

JantonioFC/skillsbank

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awarene...

JantonioFC/skillsbank

Generate AI videos with Google Veo, Seedance, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 1.5 Pro, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, lipsync, avatar animation, video upscaling, fole...

JantonioFC/skillsbank

Production-ready CI/CD configurations for Playwright — GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins, Docker, parallel sharding, reporting, code coverage, and global setup/teardown.

JantonioFC/skillsbank

Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.

JantonioFC/skillsbank

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.

Verwandte Skills