Communitygithub.com

ComeOnOliver/skillshub

Añade soporte multilingüe a sitios web Next.js con la configuración SEO adecuada, incluyendo etiquetas hreflang, mapas del sitio localizados y contenido específico por idioma. Útil al agregar nuevos idiomas, configurar i18n, optimizar para SEO internacional, o cuando el usuario mencione localización, traducción, multilingüe o idiomas específicos como japonés, coreano, chino.

¿Qué es skillshub?

Esta habilidad proporciona un flujo de trabajo completo para internacionalizar sitios web construidos con Next.js, aplicando las mejores prácticas de SEO. Está diseñada para desarrolladores que necesitan añadir soporte multilingüe a sus proyectos, ya sea desde cero o ampliando un sitio existente. La habilidad soporta una amplia gama de idiomas, incluyendo inglés, japonés, chino, coreano, portugués, español, francés, alemán y muchos más. El flujo de trabajo guía al usuario a través de seis pasos principales: preparar archivos base de idioma, agregar nuevos idiomas mediante un script automatizado, verificar la configuración, añadir traducciones (con opciones de IA o manuales), configurar elementos SEO como etiquetas hreflang y metadatos localizados, y finalmente validar y probar todo el sitio. La habilidad también incluye notas importantes sobre estándares de códigos de idioma (ISO 639-1), implicaciones SEO, calidad de las traducciones y tareas posteriores a la internacionalización, como enviar el mapa del sitio a Google Search Console. Funciona principalmente con el enrutador `next-intl` de Next.js y utiliza scripts ubicados en el directorio `scripts/` para automatizar la adición de nuevos idiomas y datos estructurados.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Internacionalización de Sitios Web

Flujo de trabajo completo para añadir soporte multilingüe a sitios web Next.js con las mejores prácticas de SEO.

Cuándo usar esta habilidad

  • Agregar nuevas versiones de idioma a un sitio web existente
  • Configurar i18n (internacionalización) para un nuevo sitio web
  • Configurar SEO para múltiples idiomas
  • El usuario menciona: "agregar idioma", "traducción", "localización", "hreflang", "multilingüe"

Idiomas Soportados

Mercados objetivo comunes:

  • 🇺🇸 Inglés (en) - Mercado global
  • 🇯🇵 Japonés (ja) - Mercado asiático
  • 🇨🇳 Chino (zh) - Mercado chino

Soporte extendido disponible para:

  • Coreano (ko), Portugués (pt), Español (es), Francés (fr), Alemán (de)
  • Árabe (ar), Vietnamita (vi), Hindi (hi), Indonesio (id), Tailandés (th)
  • Chino tradicional (zh-hk), Italiano (it), Ruso (ru)

Flujo de Trabajo de Internacionalización

Copia esta lista de verificación y sigue tu progreso:

Progreso i18n:
- [ ] Paso 1: Preparar archivos base de idioma
- [ ] Paso 2: Agregar nuevos archivos de idioma
- [ ] Paso 3: Actualizar archivos de configuración
- [ ] Paso 4: Agregar traducciones
- [ ] Paso 5: Configurar elementos SEO
- [ ] Paso 6: Validar y probar

Paso 1: Preparar archivos base de idioma

Asegúrate de que los archivos en inglés (en.json) existan como plantillas:

Directorios requeridos:

  • i18n/messages/en.json - Traducciones principales
  • i18n/pages/landing/en.json - Traducciones de la página de inicio

Verifica la estructura:

# Comprueba si existen los archivos base
ls i18n/messages/en.json
ls i18n/pages/landing/en.json

Si faltan, créalos con las claves de traducción completas para tu sitio web.

Paso 2: Agregar nuevos archivos de idioma

Ejecuta el script de adición de idiomas:

node scripts/i18n-add-languages.mjs

Qué hace este script:

  • Copia en.json a todos los archivos de idioma destino
  • Actualiza i18n/locale.ts con los nuevos locales
  • Actualiza i18n/request.ts con los mapeos de idioma
  • Actualiza public/sitemap.xml con las nuevas URLs de idioma

Configuración del script (en i18n-add-languages.mjs):

  • Array languages - Lista de idiomas a agregar
  • Objeto languageNames - Nombres para mostrar de los idiomas
  • Array targetDirs - Directorios que contienen archivos de traducción

Consulta WORKFLOW.md para una guía detallada paso a paso.

Paso 3: Verificar las actualizaciones de configuración

Revisa i18n/locale.ts:

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

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

Revisa i18n/request.ts:

  • Mapeos de códigos de idioma configurados
  • Mapeos zh-CN → zh, zh-HK → zh-hk presentes

Revisa public/sitemap.xml:

  • Todas las versiones de idioma listadas
  • Etiquetas hreflang presentes para cada URL

Paso 4: Agregar traducciones

Opción A: Usar traducción con IA (más rápida pero necesita revisión):

# Agrega datos estructurados y traducciones de precios
node scripts/i18n-add-schema.js

Configura las traducciones en el objeto translations del script.

Opción B: Traducción manual (recomendada para calidad):

Edita cada archivo de idioma con las traducciones adecuadas:

# Abre el archivo de idioma
code i18n/messages/ja.json

Mejores prácticas de traducción:

  • Usa hablantes nativos cuando sea posible
  • Mantén las palabras clave SEO en el idioma de destino
  • Adapta el contenido a la cultura local, no solo traduzcas
  • Mantén el formato consistente (placeholders, variables)

Consulta reference/locale-codes.md para la referencia de códigos de idioma.

Paso 5: Configurar elementos SEO

Etiquetas hreflang - Automáticas mediante el mapa del sitio, pero verifica:

Consulta reference/hreflang-guide.md para una guía completa.

Metaetiquetas localizadas - Traduce en cada archivo de idioma:

{
  "metadata": {
    "title": "Título de tu sitio",
    "description": "Tu descripción SEO"
  }
}

Estructura de URL - Verifica el formato correcto:

  • Inglés: https://example.com/ o https://example.com/en/
  • Japonés: https://example.com/ja/
  • Chino: https://example.com/zh/

Paso 6: Validar y probar

Construye el proyecto:

npm run build

CRÍTICO: Corrige cualquier error antes de continuar.

Pruebas manuales:

  1. Selector de idioma:

    • Visita cada versión de idioma
    • Verifica que el selector de idioma muestre todos los idiomas
    • Haz clic en cada enlace de idioma, verifica que se cargue la página correcta
  2. Visualización de contenido:

    • Revisa que todas las páginas se rendericen correctamente en cada idioma
    • Verifica que no haya texto sin traducir (busca inglés en páginas que no son en inglés)
    • Prueba que los caracteres especiales se muestren correctamente (japonés, chino, árabe)
  3. Elementos SEO:

    • Inspecciona que el atributo <html lang="..."> coincida con el idioma de la página
    • Verifica que las etiquetas <link rel="alternate" hreflang="..."> estén presentes
    • Revisa que las metaetiquetas estén en el idioma correcto

Validación automatizada:

# Verifica el mapa del sitio
curl https://tu-sitio.com/sitemap.xml | grep hreflang

# Valida hreflang (usa herramienta en línea)
# Google Search Console > Internacionalización > hreflang

Lista de verificación SEO - Consulta reference/seo-checklist.md.

Si la validación falla:

  • Revisa los mensajes de error cuidadosamente
  • Verifica que los archivos de configuración no tengan errores tipográficos
  • Confirma que los códigos de idioma sean correctos
  • Vuelve al Paso 3 y corrige los problemas

Solo continúa cuando todas las validaciones pasen.

Notas Importantes

Estándares de Códigos de Idioma

Usa ISO 639-1 (códigos de dos letras) con variantes regionales opcionales:

  • en - Inglés
  • ja - Japonés
  • zh - Chino simplificado
  • zh-hk - Chino tradicional (Hong Kong)
  • pt - Portugués
  • pt-br - Portugués de Brasil

Consulta reference/locale-codes.md para la lista completa.

Implicaciones SEO

Una i18n correcta mejora el SEO al:

  • Dirigirse a usuarios en su idioma nativo
  • Evitar penalizaciones por contenido duplicado
  • Ayudar a los motores de búsqueda a servir la versión de idioma correcta

Errores SEO comunes a evitar:

  • ❌ Redirección automática basada en IP (impide que los motores de búsqueda rastreen todas las versiones)
  • ❌ Etiquetas hreflang faltantes (causa problemas de contenido duplicado)
  • ❌ Estructura de URL inconsistente entre idiomas
  • ❌ Metaetiquetas sin traducir

Calidad de las Traducciones

Traducción con IA vs Traducción humana:

  • ✅ IA: Rápida, rentable, buena para un borrador inicial
  • ⚠️ IA: Puede perder matices culturales, necesita revisión
  • ✅ Humana: Mejor calidad, adaptación cultural
  • ⚠️ Humana: Más lenta, más costosa

Enfoque recomendado:

  1. Usa IA para generar traducciones iniciales
  2. Solicita a un hablante nativo que revise y refine
  3. Prueba con usuarios del mercado objetivo
  4. Itera basándote en los comentarios

Enrutamiento i18n en Next.js

El sistema usa next-intl para el enrutamiento:

  • Detección automática de locale desde la URL
  • Componente selector de idioma
  • Navegación localizada

Configuración en i18n/locale.ts y i18n/request.ts.

Tareas Posteriores a la Internacionalización

Después de agregar idiomas:

  1. Envía el mapa del sitio actualizado a Google Search Console
  2. Crea propiedades separadas en Search Console para cada idioma/región
  3. Monitorea el tráfico orgánico internacional en Analytics
  4. Prueba A/B las traducciones si las tasas de conversión difieren por idioma
  5. Configura alertas para errores de rastreo internacional

Ubicación de los Scripts

Todos los scripts i18n están en el directorio scripts/:

  • i18n-add-languages.mjs - Agregar nuevos archivos de idioma
  • i18n-add-schema.js - Agregar traducciones de datos estructurados

Materiales de Referencia

Para solucionar problemas, consulta la sección de resolución de problemas en 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

Skills relacionados