Communitygithub.com

ComeOnOliver/skillshub

Fügt Next.js-Websites mehrsprachige Unterstützung mit korrekter SEO-Konfiguration hinzu, einschließlich hreflang-Tags, lokalisierter Sitemaps und sprachspezifischer Inhalte. Zu verwenden beim Hinzufügen neuer Sprachen, Einrichten von i18n, Optimieren für internationales SEO oder wenn der Benutzer Lokalisierung, Übersetzung, Mehrsprachigkeit oder bestimmte Sprachen wie Japanisch, Koreanisch, Chinesisch erwähnt.

Was ist skillshub?

Dieses Skill automatisiert den gesamten Workflow zur Internationalisierung (i18n) von Next.js-Websites, von der initialen Einrichtung bis zur SEO-Optimierung. Es unterstützt die effiziente Verwaltung mehrerer Sprachen durch vorgefertigte Skripte, die Sprachdateien kopieren, Konfigurationen aktualisieren und Sitemaps generieren. Der Fokus liegt auf internationalen SEO-Best-Practices, einschließlich der korrekten Implementierung von hreflang-Tags, lokalisierten Metadaten und URL-Strukturen. Das Skill richtet sich an Entwickler, die Next.js mit next-intl verwenden, und umfasst sowohl automatisierte als auch manuelle Übersetzungsoptionen. Es wird eine Schritt-für-Schritt-Prüfliste zur Validierung bereitgestellt, die Tests der Sprachumschalter, der Inhaltsanzeige und der SEO-Elemente umfasst. Ziel ist es, eine nahtlose mehrsprachige Benutzererfahrung zu gewährleisten und häufige Fehler wie fehlende hreflang-Tags oder inkonsistente URLs zu vermeiden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/zhanlincui/internationalizing-websites

In Ihrer bevorzugten KI fragen

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

Dokumentation

Internationalisierung von Websites

Komplette Arbeitsablauf für die Integration mehrsprachiger Unterstützung in Next.js-Websites mit SEO-Best-Practices.

Wann dieses Skill verwendet werden sollte

  • Hinzufügen neuer Sprachversionen zu einer bestehenden Website
  • Einrichten von i18n (Internationalisierung) für eine neue Website
  • Konfigurieren von SEO für mehrere Sprachen
  • Benutzer erwähnt: "Sprache hinzufügen", "Übersetzung", "Lokalisierung", "hreflang", "mehrsprachig"

Unterstützte Sprachen

Häufige Zielmärkte:

  • 🇺🇸 Englisch (en) - Globaler Markt
  • 🇯🇵 Japanisch (ja) - Asiatischer Markt
  • 🇨🇳 Chinesisch (zh) - Chinesischer Markt

Erweiterte Unterstützung verfügbar für:

  • Koreanisch (ko), Portugiesisch (pt), Spanisch (es), Französisch (fr), Deutsch (de)
  • Arabisch (ar), Vietnamesisch (vi), Hindi (hi), Indonesisch (id), Thailändisch (th)
  • Traditionelles Chinesisch (zh-hk), Italienisch (it), Russisch (ru)

Internationalisierungs-Workflow

Kopieren Sie diese Checkliste und verfolgen Sie Ihren Fortschritt:

i18n-Fortschritt:
- [ ] Schritt 1: Basis-Sprachdateien vorbereiten
- [ ] Schritt 2: Neue Sprachdateien hinzufügen
- [ ] Schritt 3: Konfigurationsdateien aktualisieren
- [ ] Schritt 4: Übersetzungen hinzufügen
- [ ] Schritt 5: SEO-Elemente konfigurieren
- [ ] Schritt 6: Validieren und testen

Schritt 1: Basis-Sprachdateien vorbereiten

Stellen Sie sicher, dass englische (en.json) Dateien als Vorlagen vorhanden sind:

Erforderliche Verzeichnisse:

  • i18n/messages/en.json - Hauptübersetzungen
  • i18n/pages/landing/en.json - Landingpage-Übersetzungen

Struktur überprüfen:

# Prüfen, ob Basisdateien existieren
ls i18n/messages/en.json
ls i18n/pages/landing/en.json

Falls nicht vorhanden, erstellen Sie sie mit vollständigen Übersetzungsschlüsseln für Ihre Website.

Schritt 2: Neue Sprachdateien hinzufügen

Führen Sie das Skript zum Hinzufügen von Sprachen aus:

node scripts/i18n-add-languages.mjs

Was dieses Skript tut:

  • Kopiert en.json in alle Zielsprachdateien
  • Aktualisiert i18n/locale.ts mit neuen Locales
  • Aktualisiert i18n/request.ts mit Sprachzuordnungen
  • Aktualisiert public/sitemap.xml mit neuen Sprach-URLs

Skript-Konfiguration (in i18n-add-languages.mjs):

  • languages-Array - Liste der hinzuzufügenden Sprachen
  • languageNames-Objekt - Anzeigenamen der Sprachen
  • targetDirs-Array - Verzeichnisse mit Übersetzungsdateien

Siehe WORKFLOW.md für eine detaillierte Schritt-für-Schritt-Anleitung.

Schritt 3: Konfigurationsaktualisierungen überprüfen

Überprüfen Sie i18n/locale.ts:

export const locales = ["en", "ja", "zh", "ko", ...];

export const localeNames: any = {
  en: "English",
  ja: "日本語",
  zh: "中文",
  ko: "한국어",
  ...
};

Überprüfen Sie i18n/request.ts:

  • Sprachcode-Zuordnungen konfiguriert
  • zh-CN → zh, zh-HK → zh-hk Zuordnungen vorhanden

Überprüfen Sie public/sitemap.xml:

  • Alle Sprachversionen aufgeführt
  • hreflang-Tags für jede URL vorhanden

Schritt 4: Übersetzungen hinzufügen

Option A: Mittels KI-Übersetzung (schneller, aber Überprüfung erforderlich):

# Strukturierte Daten und Preisübersetzungen hinzufügen
node scripts/i18n-add-schema.js

Konfigurieren Sie Übersetzungen im translations-Objekt des Skripts.

Option B: Manuelle Übersetzung (für Qualität empfohlen):

Bearbeiten Sie jede Sprachdatei mit korrekten Übersetzungen:

# Sprachdatei öffnen
code i18n/messages/ja.json

Best Practices für Übersetzungen:

  • Verwenden Sie nach Möglichkeit Muttersprachler
  • Behalten Sie SEO-Keywords in der Zielsprache bei
  • Passen Sie Inhalte an die lokale Kultur an, übersetzen Sie nicht nur
  • Halten Sie die Formatierung konsistent (Platzhalter, Variablen)

Siehe reference/locale-codes.md für die Referenz der Sprachcodes.

Schritt 5: SEO-Elemente konfigurieren

hreflang-Tags - Automatisch über Sitemap, aber überprüfen:

Siehe reference/hreflang-guide.md für die vollständige Anleitung.

Lokalisierte Meta-Tags - Übersetzen Sie in jeder Sprachdatei:

{
  "metadata": {
    "title": "Ihr Seitentitel",
    "description": "Ihre SEO-Beschreibung"
  }
}

URL-Struktur - Überprüfen Sie das korrekte Format:

  • Englisch: https://example.com/ oder https://example.com/en/
  • Japanisch: https://example.com/ja/
  • Chinesisch: https://example.com/zh/

Schritt 6: Validieren und testen

Projekt bauen:

npm run build

KRITISCH: Beheben Sie alle Fehler, bevor Sie fortfahren.

Manuelles Testen:

  1. Sprachumschalter:

    • Besuchen Sie jede Sprachversion
    • Überprüfen Sie, ob der Sprachumschalter alle Sprachen anzeigt
    • Klicken Sie auf jeden Sprachlink, überprüfen Sie, ob die richtige Seite geladen wird
  2. Inhaltsanzeige:

    • Überprüfen Sie, ob alle Seiten in jeder Sprache korrekt dargestellt werden
    • Stellen Sie sicher, dass kein unübersetzter Text vorhanden ist (prüfen Sie auf Englisch in nicht-englischen Seiten)
    • Testen Sie die korrekte Anzeige von Sonderzeichen (Japanisch, Chinesisch, Arabisch)
  3. SEO-Elemente:

    • Überprüfen Sie, ob das Attribut <html lang="..."> mit der Seitensprache übereinstimmt
    • Stellen Sie sicher, dass <link rel="alternate" hreflang="...">-Tags vorhanden sind
    • Überprüfen Sie, ob die Meta-Tags in der korrekten Sprache sind

Automatisierte Validierung:

# Sitemap überprüfen
curl https://ihre-site.com/sitemap.xml | grep hreflang

# hreflang validieren (Online-Tool verwenden)
# Google Search Console > Internationalisierung > hreflang

SEO-Checkliste - Siehe reference/seo-checklist.md.

Wenn die Validierung fehlschlägt:

  • Überprüfen Sie die Fehlermeldungen sorgfältig
  • Prüfen Sie die Konfigurationsdateien auf Tippfehler
  • Stellen Sie sicher, dass die Sprachcodes korrekt sind
  • Kehren Sie zu Schritt 3 zurück und beheben Sie die Probleme

Fahren Sie erst fort, wenn alle Validierungen bestanden sind.

Wichtige Hinweise

Sprachcode-Standards

Verwenden Sie ISO 639-1 (zweistellige Codes) mit optionalen regionalen Varianten:

  • en - Englisch
  • ja - Japanisch
  • zh - Vereinfachtes Chinesisch
  • zh-hk - Traditionelles Chinesisch (Hongkong)
  • pt - Portugiesisch
  • pt-br - Brasilianisches Portugiesisch

Siehe reference/locale-codes.md für die vollständige Liste.

SEO-Auswirkungen

Korrekte i18n verbessert SEO durch:

  • Ansprechen von Benutzern in ihrer Muttersprache
  • Vermeidung von Duplicate-Content-Strafen
  • Hilfe für Suchmaschinen, die richtige Sprachversion auszuliefern

Häufige SEO-Fehler, die vermieden werden sollten:

  • ❌ Automatische Weiterleitung basierend auf IP (verhindert das Crawlen aller Versionen durch Suchmaschinen)
  • ❌ Fehlende hreflang-Tags (verursacht Duplicate-Content-Probleme)
  • ❌ Inkonsistente URL-Struktur über Sprachen hinweg
  • ❌ Unübersetzte Meta-Tags

Übersetzungsqualität

KI-Übersetzung vs. menschliche Übersetzung:

  • ✅ KI: Schnell, kostengünstig, gut für den ersten Entwurf
  • ⚠️ KI: Kann kulturelle Nuancen übersehen, erfordert Überprüfung
  • ✅ Mensch: Bessere Qualität, kulturelle Anpassung
  • ⚠️ Mensch: Langsamer, teurer

Empfohlener Ansatz:

  1. KI verwenden, um erste Übersetzungen zu generieren
  2. Muttersprachler überprüfen und verfeinern lassen
  3. Mit Benutzern des Zielmarktes testen
  4. Basierend auf Feedback iterieren

Next.js i18n Routing

Das System verwendet next-intl für das Routing:

  • Automatische Erkennung des Locales aus der URL
  • Sprachumschalter-Komponente
  • Lokalisierte Navigation

Konfiguration in i18n/locale.ts und i18n/request.ts.

Aufgaben nach der Internationalisierung

Nach dem Hinzufügen von Sprachen:

  1. Aktualisierte Sitemap bei Google Search Console einreichen
  2. Separate Search Console-Eigenschaften für jede Sprache/Region erstellen
  3. Internationalen organischen Traffic in Analytics überwachen
  4. Übersetzungen A/B-testen, wenn die Conversion-Raten sprachabhängig variieren
  5. Benachrichtigungen für internationale Crawl-Fehler einrichten

Skript-Standorte

Alle i18n-Skripte befinden sich im scripts/-Verzeichnis:

  • i18n-add-languages.mjs - Neue Sprachdateien hinzufügen
  • i18n-add-schema.js - Strukturierte Datenübersetzungen hinzufügen

Referenzmaterialien

Zur Fehlerbehebung siehe den Abschnitt zur Fehlerbehebung in WORKFLOW.md.

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Verwandte Skills