Communitygithub.com

100x-localize

Localiza un texto publicitario/guion a una versión en español mexicano por defecto, no como traducción literal sino con compresión activa y ajuste al registro real del corpus.

¿Qué es 100x-localize?

100x-localize es un skill dentro del sistema 100x, ubicado en la capa de generación creativa L2, diseñado específicamente para la localización de textos publicitarios a español mexicano (por defecto) o latinoamericano genérico. A diferencia de una traducción palabra por palabra, este skill aplica compresión activa del texto para ajustarse a las duraciones naturales del speech oral, basándose en distribuciones de longitud extraídas de corpus reales. El skill valida rigurosamente la consistencia de persona (usando siempre 'tú'), evita la invención de afirmaciones de autoridad (como FDA, Harvard, OMS) no presentes en el original, y por defecto utiliza un perfil de registro alineado con la intensidad real del corpus, en lugar de listas de prohibición conservadoras. Soporta plataformas como Claude Code, Cursor o Codex, y su flujo de tres fases incluye validación de entrada, generación localizada con autoverificación, y opciones de retrabajo por parte del usuario. El skill es independiente: no requiere que el usuario ejecute otros skills primero, y rechaza entradas de audio/video, solo acepta texto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kezd088/100x-skill-tiktok/tree/main/skills/100x-localize

Preguntar en tu IA favorita

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

Documentación

¿Qué hace 100x-localize?

Descripción general

Introduce un texto fuente (en cualquier idioma original) y obtén una versión localizada en español mexicano por defecto. No es una traducción literal, sino que comprime activamente la longitud, ajustándose a la distribución real de intensidad del corpus auténtico. Pertenece a la capa de generación creativa L2 del sistema 100x, correspondiente al paso "2c: localización de textos publicitarios".

Cuándo activarlo

El usuario dice:

  • "Localiza este texto publicitario al español" / "Localízalo a español mexicano" / "Traduce este guion al español" / "Adapta esto para el mercado hispano"
  • "Localize this ad copy" / "Translate this script into Spanish" / "Adapt this for the Spanish market" / "Mexican Spanish localization"
  • O simplemente proporciona un texto fuente (en cualquier idioma, normalmente inglés o chino) solicitando la versión localizada en español

Entrada

Entrada mínima (categoría A, obligatoria): source_script — texto completo del guion original en texto plano (idioma original cualquiera). Este skill no acepta archivos de video/audio, solo texto.

Entrada complementaria opcional (categoría B, todas con valores predeterminados documentados, ver workflow.md Fase 1):

  • target_region (por defecto "mx", solo acepta mx/generic-latam; cualquier otro valor se degrada a generic-latam y se registra en meta.warnings)
  • register_profile (por defecto "default", alineado con la intensidad real del corpus, no es una opción conservadora; ver axioma 2 de las restricciones principales)

Salida opcional de skills anteriores (categoría C): si faltan, se ignoran silenciosamente sin bloquear ni requerir que el usuario ejecute primero otros skills:

  • Tarjetas de personaje/escenario de 100x-persona
  • Resultados de términos de búsqueda de 100x-search-query

Salida

La estructura se define en schema.json:

  • source_script (eco del texto original)
  • target_region
  • register_profile
  • localized_script (texto localizado en español)
  • meta (obligatorio: generated_by, warnings; campo opcional: compression_ratio)

Restricciones principales (4 axiomas, ver axioms.md)

  1. Axioma de compresión: El número de caracteres del texto en español no debe superar 1.10 veces ni ser inferior a 0.5 veces el número de caracteres del texto original. Esto se basa en la distribución de longitudes de transcripción del corpus de referencia: el español requiere naturalmente más caracteres para expresar la misma información; una traducción literal excedería sistemáticamente el presupuesto de duración oral, por lo que se debe comprimir y reescribir activamente, no traducir palabra por palabra (los valores 1.10/0.5 son juicios de ingeniería, ver axioma 1 en axioms.md).

  2. Axioma de registro de intensidad por defecto: Por defecto, se alinea con la distribución real de intensidad del corpus auténtico. La lista de prohibiciones conservadoras del documento normativo 07 (07_西语口播风格规范.md) §5 se degrada a un perfil opcional profiles/compliance-conservative.md, no es el valor por defecto (dicho documento en su §1 declara que "no son conclusiones prácticas extraídas de muestras exitosas del corpus español"; por lo tanto, este skill no toma sus recomendaciones conservadoras como conclusiones de verificación obligatorias por defecto).

  3. Axioma de consistencia de persona: Todo el texto debe usar uniformemente el tratamiento de tú, sin mezclar usted/vosotros (limitación conocida: actualmente solo se admiten las regiones mx/generic-latam, no se admite el registro formal de España con usted/vosotros ni la conjugación argentina vos; esto es una limitación de alcance; si se solicitan estas regiones, se degradarán a generic-latam con un aviso, no se simulará soporte. Además, el corpus de referencia contiene casos donde aparece usted mezclado con tú; este axioma es un estándar de calidad que el skill se impone a sí mismo, no una descripción de la realidad del corpus (ver axioma 3 en axioms.md). El mecanismo actual ya cubre estas técnicas de evasión: mayúsculas totales, eliminación de acentos, inserción de caracteres invisibles de ancho cero e inserción de signos diacríticos combinados (la capa de verificación manual aplica doble normalización para caracteres invisibles y signos diacríticos combinados en los axiomas 2/3; la detección de familias terminológicas autorizadas del axioma 4 también elimina caracteres invisibles). Aún existen brechas conocidas: el patrón ajv en schema.json carece de capacidad de preprocesamiento (limitación estructural del esquema JSON Schema), y la lista de puntos de código de caracteres invisibles (6) no es exhaustiva según la categoría de formato de caracteres Unicode (ver TODO en axiomas 2/3/4 de axioms.md).

  4. Axioma de prevención de afirmaciones falsas de autoridad: No se deben introducir afirmaciones de autoridad/certificación que no estén presentes en el texto original (familia de términos cerrada: FDA/Harvard/OMS/expresiones de validación clínica). Limitación conocida: esto solo bloquea la incorporación de palabras clave dentro de la familia cerrada (ya se normalizan variantes como eliminación de acentos, combinación de mayúsculas/minúsculas, abreviaturas con puntos); aún no se puede bloquear la invención de un nombre de institución/persona ficticia que no esté en la familia cerrada (ver axioma 4 en axioms.md).

Flujo de tres fases

Ver workflow.md:

  • Fase 1: Recepción y validación (categorías A/B/C, degradación/relleno de target_region/register_profile)
  • Fase 2: Decisión de intensidad de registro → reescritura natural del lenguaje → compresión de longitud → autoverificación frase por frase → autoverificación por lotes
  • Fase 3: Retrabajo iniciado por el usuario (L1: compresión de una sola ronda; L2: cambio de perfil o región; L3: rehacer todo; no hay ruta de retrabajo para persona/registro — v1 solo admite tú, ver axioma 3 de restricciones principales)

Garantía de invocación independiente

  • Si falta la categoría A (source_script) o el usuario envía un archivo de video/audio → respuesta fija solicitando el texto, no se adivina ni se escribe el guion.
  • Si faltan las categorías B (target_region/register_profile) → se usan directamente los valores predeterminados documentados, no se pregunta ni se bloquea.
  • Si falta la categoría C (salida de 100x-persona/100x-search-query) → se ignora silenciosamente, nunca se exige al usuario que ejecute primero otros skills.

Términos prohibidos

  • "Déjame" / "Espero" / "Quizás" / "Probablemente" / "Puede" / "Tal vez" / "Permíteme"
  • Tono de asistente AI ("as an AI" / "I'd be happy to" / "feel free to")
  • Cuando register_profile=="compliance-conservative", lista específica de términos prohibidos en profiles/compliance-conservative.md
  • No inventar efectos, certificaciones o testimonios de usuarios que no estén en el texto original (ver axioma 4, limitaciones conocidas arriba)
  • No codificar diccionarios de categorías de clientes
  • No fingir soporte para regiones/personas no implementadas en v1 (ver limitaciones conocidas del axioma 3)

Enrutamiento (recomendado, no dependencia estricta)

  • Si ya existe un personaje/escenario definido y se desea que el tono localizado se ajuste a una personalidad específica → skill de personaje/escenario (si ya está creado, su salida puede usarse como referencia de categoría C)
  • Si aún no se han definido palabras clave de búsqueda y se desea encontrar material de referencia antes de localizar → skill de palabras clave de búsqueda (si ya está creado)
  • Si después de localizar se desea generar una línea de tiempo de doblaje/subtítulos → skill de doblaje/subtítulos (si ya está creado)
  • Si se desea volver a la entrada principal para rediagnóstico → entrada principal del sistema 100x (si ya está creado)

Todo lo anterior son recomendaciones posteriores a la salida, no dependencias previas; si los skills correspondientes aún no están construidos, esto no afecta el funcionamiento independiente de este skill.

Autoverificación de fábrica

Ejecute node scripts/validate.js --selftest para verificar. Las restricciones estructurales declaradas en schema.json (required/additionalProperties/enum/pattern, incluidas las verificaciones condicionales if/then+pattern de los axiomas 2/3) son ejecutadas realmente por ajv (validador real de JSON Schema draft-07, devDependency declarado en package.json, ejecutar npm install primero). Los axiomas 1 (relación de compresión) y 4 (prevención de afirmaciones falsas de autoridad) son reglas de comparación entre campos que no pueden expresarse estructuralmente en JSON Schema puro (no se puede comparar la longitud o el contenido de dos campos de cadena), y se complementan con código manual en scripts/validate.js:

npm install                                                   # Primera vez: instalar ajv
node scripts/validate.js <bundle.json> [bundle2.json ...]   # Validar salida
node scripts/validate.js --selftest                          # Ejecutar pruebas de regresión integradas

Fuentes

Este skill se ha construido a partir de los siguientes materiales:

  • 07_西语口播风格规范.md (fuente directa de reglas de registro/naturalización, se conserva su declaración de "no son conclusiones prácticas extraídas de corpus")
  • Corpus de referencia (proporciona datos base para el axioma de compresión y el axioma de registro por defecto)
  • CSV de biblioteca de módulos T7 (proporciona referencia estructural para el esqueleto del módulo)

Para la justificación de las modificaciones frase por frase y los criterios, ver sources.md.

Individual skills in this repo

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

Skills relacionados