Communitygithub.com

JantonioFC/skillsbank

Cette compétence est utilisée pour configurer, auditer ou appliquer l'internationalisation/localisation dans des codebases d'interface utilisateur (React/TS, i18next ou similaire, locales JSON), y compris l'installation/configuration du framework i18n, le remplacement des chaînes codées en dur, et la couverture en-US/zh-CN.

Qu'est-ce que skillsbank ?

Cette compétence, dédiée à l'internationalisation (i18n) et à la localisation, vous guide dans la configuration complète d'un framework i18n, l'audit et le remplacement des chaînes de texte visibles par l'utilisateur par des clés de traduction, et la validation de la parité entre les locales (par défaut en-US et zh-CN). Elle supporte les frameworks modernes comme React, Next.js et Vue, et propose un workflow structuré en trois étapes : Audit → Correction → Validation. Vous pourrez notamment installer la bibliothèque appropriée (react-i18next, next-intl, vue-i18n), organiser les fichiers de locales, générer des traductions (IA, professionnelles ou manuelles), gérer la détection de langue et le routage localisé, et valider les règles de pluriel et de formatage. La compétence inclut des garde-fous importants (ne jamais exposer de messages d'erreur bruts dans l'interface, ne pas ajouter de locales non demandées, utiliser des espaces de noms structurés) et fournit des scripts d'audite automatisés (scripts/i18n_audit.py). Elle est idéale pour les développeurs front-end qui souhaitent professionnaliser la localisation de leur application et garantir une couverture complète des locales cibles.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JantonioFC/skillsbank/tree/HEAD/skills/localization-toolkit

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Expert I18n

Vue d'ensemble

Livrer une configuration i18n complète + un audit : configurer le framework i18n, remplacer les chaînes visibles par l'utilisateur par des clés, assurer la parité entre les locales, et valider les pluriels et le formatage pour en-US et zh-CN.

Capacités principales

  • Sélection et configuration de bibliothèques (React, Next.js, Vue).
  • Architecture des clés et organisation des fichiers de locale.
  • Génération de traductions et stratégie de qualité (IA, professionnelle, manuelle).
  • Routage et détection/changement de langue.
  • Localisation SEO et des métadonnées (le cas échéant).
  • Support RTL (uniquement si les locales RTL sont dans le périmètre).

Entrées de périmètre (demander si ambigu)

  • Framework et style de routage.
  • État i18n existant (aucun, partiel, hérité).
  • Locales cibles (par défaut : en-US + zh-CN).
  • Besoins en qualité de traduction (IA vs professionnelle vs manuelle).
  • Formats de locale utilisés (JSON, YAML, PO, XLIFF).
  • Exigences de formalité/culturelles (le cas échéant).

Workflow (Auditer → Corriger → Valider)

  1. Confirmer le périmètre et les locales cibles
  • Identifier le framework i18n et les emplacements des fichiers de locale.
  • Confirmer les locales ; par défaut en-US + zh-CN lorsqu'elles sont spécifiées.
  1. Configurer la base i18n (si manquante)
  • Choisir une bibliothèque adaptée au framework (ex. React : react-i18next ; Next.js : next-intl ; Vue : vue-i18n).
  • Installer les packages et créer le fichier d'entrée/configuration i18n.
  • Connecter le fournisseur (provider) à la racine de l'application et charger les ressources de locale.
  • Ajouter un sélecteur de langue et la persistance (route/param/localStorage) selon le besoin.
  • Établir la structure des fichiers de locale et les espaces de noms.
  • Si le routage est sensible à la locale, définir tôt la stratégie de segment de locale (sous-chemin, sous-domaine, paramètre de requête).
  • Si les métadonnées sont visibles par l'utilisateur, inclure la traduction des titres/descriptions.
  1. Auditer l'utilisation des clés et la parité des locales
  • Exécuter :
    python scripts/i18n_audit.py --src <src-root> --locale <path/to/en-US.json> --locale <path/to/zh-CN.json>
    
  • Traiter les clés manquantes/les écarts de parité comme des bloqueurs.
  • Vérifier manuellement les clés dynamiques (t(var)).
  1. Trouver les chaînes brutes visibles par l'utilisateur
  • Rechercher :
    rg -n --glob '<src>/**/*.{ts,tsx,js,jsx}' "<[^>]+>[^<{]*[A-Za-z][^<{]*<"
    rg -n --glob '<src>/**/*.{ts,tsx,js,jsx}' "aria-label=\"[^\"]+\"|title=\"[^\"]+\"|placeholder=\"[^\"]+\""
    
  • Localiser les libellés d'accessibilité.
  1. Remplacer les chaînes par des clés
  • Utiliser t('espace_de_noms.clé') pour le texte d'interface.
  • Pour les pluriels, utiliser t('clé', { count }) + les clés _one/_other.
  • Utiliser les formatteurs Intl/application pour les dates, heures et nombres.
  1. Localiser la gestion des erreurs (critique)
  • Mapper les codes d'erreur à des clés localisées ; n'afficher que l'interface localisée.
  • Journaliser les détails bruts de l'erreur uniquement.
  • Fournir une solution de repli localisée pour les codes inconnus.
  1. Mettre à jour les fichiers de locale
  • Ajouter les clés manquantes dans les deux locales.
  • Rester cohérent avec les espaces réservés ; éviter les renommages sauf demande explicite.
  • Générer les traductions selon la méthode convenue ; préserver les espaces réservés et les règles de pluriel.
  1. Valider
  • Relancer l'audit jusqu'à ce qu'il n'y ait plus de clés manquantes ni d'écarts.
  • Valider le JSON (ex. python -m json.tool <fichier>).
  • Mettre à jour les tests qui vérifient le texte visible.

Garde-fous

  • Ne jamais exposer error.message brut dans l'interface ; n'afficher que des chaînes localisées.
  • Ne pas ajouter de locales supplémentaires sauf demande explicite.
  • Privilégier les espaces de noms structurés (ex. errors.*, buttons.*, workspace.*).
  • Garder les traductions concises et cohérentes.
  • Certains termes techniques/marques doivent rester non traduits (ex. nom du produit, API, MCP, Bash).

Livrables (sorties attendues)

  • Configuration/fournisseur i18n.
  • Fichiers de locale pour chaque langue cible.
  • Chaînes d'interface remplacées par des clés stables.
  • Sélecteur de langue et persistance (le cas échéant).
  • Tests mis à jour pour le texte visible.

Directives d'architecture (garder concises)

  • Structure des clés : privilégier les espaces de noms imbriqués par zone (ex. common.buttons.save, pricing.tier.pro).
  • Organisation des fichiers : un fichier par locale ou des espaces de noms par locale ; maintenir la synchronisation des clés entre les locales.
  • Espaces réservés : préserver exactement {nom}/{{nom}} ; valider les pluriels selon les règles de la locale.
  • Formatage : utiliser les aides Intl/application pour le formatage des dates, heures, nombres et listes.
  • SEO/métadonnées : localiser les titres et descriptions si l'application les expose.
  • RTL : uniquement nécessaire pour les locales RTL ; utiliser les propriétés CSS logiques et tester la mise en page.
  • Les surfaces non-web (boîtes de dialogue du processus principal Electron, invites CLI, menus natifs) nécessitent également une localisation.

Notes de performance (courtes)

  • Charger paresseusement les bundles de locale lorsque l'application le supporte.
  • Diviser les gros fichiers de locale par espace de noms.

Modes d'échec (liste de surveillance)

  • Traductions manquantes : revenir à la locale par défaut et journaliser les avertissements.
  • Problèmes de mise en page RTL : vérifier le CSS logique et tester les pages.
  • SEO manquant : s'assurer que les alternatives et métadonnées sont localisées le cas échéant.

Liste de validation (courte)

  • Aucune clé manquante et aucune chaîne brute dans l'interface.
  • Le changement de locale fonctionne et persiste.
  • Pluriels et formatage vérifiés dans les deux locales.
  • Locale de repli configurée.

Ressources

scripts/

  • scripts/i18n_audit.py : Extrait l'utilisation de t('clé') et compare avec les fichiers JSON de locale.

Déclencheurs d'activation

Mapper les codes d'erreur à des messages localisés, et valider la parité des clés, les pluriels et le formatage.

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

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

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

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.

Skills associés