Localize Es

Spanish Translation Rules (es / Español)

Distilled from the production translation prompts (es.ts, es-es.ts, es-419.ts, es-mx.ts). Follow these rules verbatim — they are model-agnostic and produce consistent native-quality Spanish output.

Mindset

> Eres un escritor nativo extremadamente exigente que detesta las traducciones literales del inglés y las construcciones poco naturales.

Reject literal English calques. Preserve original meaning while restructuring fully into natural Spanish. Common English terms (API, token, cloud) are acceptable when no native equivalent exists.

Variant Selection (run FIRST)

Spanish has multiple variants with directly conflicting rules (vosotros vs ustedes, ordenador vs computadora, EUR vs USD/MXN, pretérito perfecto vs indefinido, coger vulgarity). Applying the wrong variant produces visibly wrong output.

If the user has not specified the variant, before translating call AskUserQuestion with:

• Question: Which Spanish variant should I target?
• Header: ES variant
• Options:

1. European Spanish (es-ES / Spain) — vosotros, ordenador/móvil/coche, EUR, pretérito perfecto for recent past, ¡Venga!/Vale.
2. Latin American neutral (es-419) — ustedes only, computadora/celular/auto, pretérito indefinido, no regional slang, avoids ahorita/orale/che. Recommended for any pan-LatAm product.
3. Mexican (es-MX) — ustedes, Mexico vocab (camión for bus, chamaco, platicar), MXN ($ with disambiguation), warm tone, diminutives OK, ¡Ándale!/¡Órale!.

If the user picks es-ES, apply the Universal Spanish base + es-ES Deltas section. Do NOT apply LATAM deltas.

If the user picks es-419, apply the Universal Spanish base + es-419 Deltas section. Do NOT apply Spain or Mexico-specific deltas.

If the user picks es-MX, apply the Universal Spanish base + es-419 Deltas (as foundation) + es-MX additional deltas on top.

Pre-Translation Setup

Lock in before translating:

1. Variant — confirmed above.
2. Formality — tú (informal) vs usted (formal). Default to usted for B2B/professional UI; tú for consumer apps. NEVER mix within a file.
3. Two genders — el (masc), la (fem). Articles, adjectives, participles all agree.
4. Word order — SVO; most adjectives FOLLOW the noun.
5. Opening punctuation marks — ¿ and ¡ are MANDATORY (universal Spanish, not optional).
6. Placeholders — Preserve {variables} and ICU plural syntax exactly.

Register Auto-Detection (run after Variant Selection + Pre-Translation Setup, before translating)

If the user has NOT specified tú or usted, infer from source text register. Match output to source — formal source → usted; informal source → tú. The plural form is ALREADY locked by variant (vosotros = Spain only; ustedes = all other variants).

Formal source signals → output usted / su / sus

• Hedging / polite modals: "please", "kindly", "we recommend", "could you", "would you mind"
• Passive / impersonal: "users are advised", "it is recommended", "applicants must"
• No contractions: "do not", "cannot", "we will"
• Domain vocabulary: legal, financial, healthcare, regulatory, enterprise B2B, government, insurance
• Third-person / distance: "the user must", "customers should"
• Long sentences, formal connectors
• Brand voice: bank, insurance, government, B2B SaaS, healthcare, legal tech
• No exclamations or emojis

Informal source signals → output tú / tu / tus

• Contractions: "don't", "you'll", "it's", "we're"
• Casual greetings: "hey", "hi there", "yo", "hi 👋"
• Second-person directness, exclamations, emoji (🎉 😎 🚀 ✨)
• Slang: "cool", "awesome", "no worries", "kinda"
• Consumer-app voice: gaming, social, lifestyle, dating, fitness, kids
• Sentence fragments and conversational filler

Mixed / ambiguous source → default to usted (formal)

Usted reads slightly distant but professional; tú can read as disrespectful in B2B/government contexts. When in doubt, stay formal.

Variant interaction

• es-ES + informal plural: uses vosotros. e.g., vosotros podéis cambiar vuestras configuraciones. Buttons stay infinitive — Guardar works for both tú and vosotros.
• es-419 / es-MX + plural (any formality): uses ustedes. e.g., ustedes pueden cambiar sus configuraciones. vosotros is forbidden.
• es-MX informal-tú: warmer tone allowed (diminutives cafecito, expressions ¡Ándale!), but stay professional in B2B.

Explicit user override

If the user says "use tú" / "use usted" / "formal" / "casual" / "voseo for Argentina", their instruction wins.

Worked examples (all using es-419 as the default; substitute per variant)

| Source | Detected | Spanish output | |----------------|----------|----------------| | "Please review the terms of service before proceeding." | formal | Por favor, revise los términos del servicio antes de continuar. | | "Hey! Tap here to get started — it's super quick 🚀" | informal | ¡Hola! Toca aquí para empezar — es súper rápido 🚀 | | "Submit your application by the deadline." | formal | Envíe su solicitud antes de la fecha límite. | | "Don't forget to save your work!" | informal | ¡No olvides guardar tu trabajo! |

After detection: keep the chosen form consistent. NEVER mix tú/usted across pronouns, possessives, AND imperatives.

Universal Spanish Base (apply to ALL variants)

1. Gender of common IT nouns (memorize)

| Masculine (el) | Feminine (la) | |----------------|---------------| | el problema | la solución | | el sistema | la plataforma | | el programa | la aplicación | | el tema | la página | | el idioma | la conexión | | el mapa | la integridad | | el día | la red | | el archivo / fichero | la pantalla / ecrã | | el software | la interfaz | | el servidor | la tabla | | el navegador | la consulta | | el PDF | la API | | el URL | la IA | | el OneSky / Slack / Teams (foreign tech) | la Apple (company) |

Patterns:

• -ción / -sión / -dad / -tad → always feminine
• -ma (Greek origin) → usually masculine
• Acronyms inherit gender from expanded form (CRITICAL): la IA (Inteligencia Artificial), la API (Interfaz), el PDF (Formato).

Common errors: una problema → un problema; el plataforma → la plataforma; la sistema → el sistema; nuestro IA → nuestra IA.

2. Opening punctuation marks (MANDATORY)

| Wrong | Correct | |-------|---------| | Desea continuar? | ¿Desea continuar? | | Error! | ¡Error! |

The opening ¿ and ¡ are NOT optional and NOT errors to be removed.

3. Conjunction y → e (euphonic rule, CRITICAL)

Use e instead of y before words starting with i- or hi- sound. Use y everywhere else.

| Wrong | Correct | |-------|---------| | padre y hijo | padre **e** hijo | | Francia y Italia | Francia **e** Italia | | gestión y integración | gestión **e** integración | | e almacenamiento | **y** almacenamiento (starts with a) | | e API | **y** API (starts with /a/ sound) |

Same rule for o → u before o- or ho- sound: siete u ocho, not siete o ocho.

4. Article contractions (mandatory)

| Combine | → | |---------|---| | a + el | al | | de + el | del |

ir a el sistema → ir al sistema. cerca de el servidor → cerca del servidor.

5. Article completeness in noun phrases (CRITICAL)

Specific known nouns require definite articles in prepositional phrases. Exception: generic classifiers (error de sistema = type, vs error del sistema = specific).

| Wrong | Correct | |-------|---------| | Error de aplicación | Error de la aplicación | | Configuración de cuenta | Configuración de la cuenta | | Estado de conexión | Estado de la conexión | | Detalles de transacción | Detalles de la transacción | | variable de entorno falta | la variable de entorno falta / falta la variable de entorno |

6. FOR vs PER — never confuse (CRITICAL)

| English | Wrong | Correct | |---------|-------|---------| | for 5 languages (total) | por idioma | para 5 idiomas | | per language (rate) | para idioma | por idioma |

7. Loanword adjective agreement (CRITICAL)

English loanwords in Spanish text: adjectives still agree in gender + number (foreign nouns default to perceived gender or masculine).

| Wrong | Correct | |-------|---------| | Services tradicional | Services tradicionales | | los plugins actualizado | los plugins actualizados | | las features nuevo | las features nuevas | | el dashboard actualizada | el dashboard actualizado |

8. UI button labels — infinitive form (industry standard)

| Wrong (imperative) | Correct (infinitive) | |--------------------|----------------------| | Guarda / Guarde | Guardar | | Cancela / Cancele | Cancelar | | Elimina / Elimine | Eliminar | | Regístrate / Regístrese | Registrarse |

Avoids tú/usted complexity in buttons.

9. Status messages — gerund

| Wrong | Correct | |-------|---------| | Guardar... | Guardando... | | Cargar... | Cargando... | | Procesar... | Procesando... |

10. Completion messages — participial / verbal (NOT "exitoso")

| Wrong (calque) | Correct | |----------------|---------| | Pago exitoso | Pago realizado / Pago completado / ¡Listo! | | Carga exitosa | Carga completada / Archivo subido / ¡Hecho! | | Descarga completa | Descarga completada / Descarga finalizada | | Operación exitosa | Operación completada / ¡Listo! |

exitoso is severity 1.5 in Spain (sounds clearly imported), 0.5 in LATAM (more tolerated) — but participial forms are universally better.

11. Empty state — No hay X (existential)

| Wrong | Correct | |-------|---------| | No se han seleccionado idiomas | No hay idiomas seleccionados | | No se han encontrado resultados | No hay resultados | | Sin datos disponibles | No hay datos disponibles | | Sin conexión | No hay conexión | | No se ha seleccionado ningún archivo | No hay archivos seleccionados (avoid double negative) |

12. Drag and drop

| English | Spanish | |---------|---------| | drag | arrastrar | | drop / release (let go) | soltar — NOT permitir | | browse (file picker) | Seleccionar archivo / Elegir archivo — NOT Explorar | | Standard phrase | Arrastrar y soltar |

13. Calques to avoid (universal)

| Wrong (literal) | Natural Spanish | |-----------------|------------------| | hace sentido / hacer sentido | tiene sentido | | aplicar para (a job) | solicitar / postularse / presentar solicitud | | Estar siendo + participio (overused) | active voice or simple passive | | tomar ventaja de | aprovechar / sacar provecho de | | en una base diaria/semanal | a diario / cada semana / diariamente | | en términos de | en cuanto a / respecto a | | desde la API / desde el servidor (abstract source) | de la API / del servidor (de = origin/belonging; desde = physical movement) |

14. False friends (universal)

| Wrong (English meaning) | Actual Spanish meaning | Correct Spanish | |--------------------------|------------------------|------------------| | actualmente (for "actually") | currently | en realidad | | eventualmente (for "eventually") | possibly | finalmente | | realizar (for "to realize") | to carry out | darse cuenta | | soportar (for "to support") | to tolerate | dar soporte / apoyar (tech "support" = admitir / ser compatible con) | | remover (for "to remove") | to stir | eliminar / quitar |

15. Marketing "Zero X" → "Sin X"

| Wrong | Correct | |-------|---------| | Cero tiempo de inactividad / Cero downtime | Sin tiempo de inactividad / Sin interrupciones | | Cero errores | Sin errores / Libre de errores | | Cero mantenimiento | Sin mantenimiento / No requiere mantenimiento | | Cero compromiso | Sin compromiso |

16. Adjective order — postnominal for abstract qualities

| Wrong | Correct | |-------|---------| | con perfecta coherencia | con una coherencia perfecta / de manera perfectamente coherente | | con completa confianza | con total confianza / con confianza total | | con absoluta precisión | con una precisión absoluta | | de superior calidad | de calidad superior | | calidad humana (tech) | calidad a nivel humano / calidad profesional |

17. Compound adjectives — natural construction

| English pattern | Wrong | Correct | |-----------------|-------|---------| | AI-powered / X-powered | IA-potenciado, impulsado por IA, traducción de IA | con IA / con tecnología de IA / potenciado con IA / traducción con IA | | context-aware / X-aware | contexto-consciente | contextual / sensible al contexto | | user-friendly | usuario-amigable | intuitivo / fácil de usar | | cloud-based | nube-basado / basado en nube | en la nube / basado en la nube | | supported formats | formatos soportados | formatos compatibles / formatos admitidos |

18. Business terminology — adjective forms

| Wrong (prepositional) | Correct (adjective) | |-----------------------|---------------------| | traducción para empresas | traducción empresarial | | solución para empresas | solución empresarial | | cliente para empresas | cliente empresarial | | traducción para negocios | traducción comercial / traducción empresarial |

19. Software terminology — IT meaning

| English | Wrong | Correct | |---------|-------|---------| | build (software) | construcción | desarrollar / crear / implementar | | deploy | despliegue (military) | implementar / poner en producción / lanzar | | support (feature) | soportar | admitir / ser compatible con / incluir soporte para | | sync seamlessly | sincronizar fácilmente | sincronizar automáticamente / mantener sincronizado | | listings (app store) | listados | fichas de la aplicación / fichas de app | | architecture (software) | arquitectura (construcción) | arquitectura de software | | pipeline (CI/CD) | tubería | pipeline (CI/CD) | | source of truth | fuente de la verdad | fuente de referencia / fuente autoritativa |

20. Structural calques — verb-first / impersonal SE

| Wrong (English subject-first passive) | Correct (Spanish verb-first / SE) | |---------------------------------------|------------------------------------| | [Subject] es necesario/requerido para [Purpose] | Se requiere [Subject] para [Purpose] | | [Subject] es obligatorio | Se requiere [Subject] / Es obligatorio [Subject] |

21. Prepositional-chain simplification (max 2 prepositions)

• Wrong: productos de cuidado de la piel de noche
• Correct: productos de cuidado nocturno / cuidado nocturno de la piel

Use adjective forms or merge concepts.

22. Compound descriptive nouns

| English | Wrong | Correct | |---------|-------|---------| | mom creators | creadoras madres | creadoras que son madres / mamás creadoras de contenido | | niche creators | (literal) | creadores de nicho / creadores especializados |

23. UI element reference in prose

| Wrong | Correct | |-------|---------| | el campo de nombre | el campo «Nombre» or el campo Nombre | | la pestaña de las cuentas | la pestaña «Cuentas» | | la barra de búsqueda | (generic — no quotes needed) |

24. Spatial metaphor prepositions

| English (figurative) | Use | Don't use | |---------------------|-----|-----------| | under [category] (browsing) | entre / en | debajo de | | on top of (in addition to) | además de | encima de | | behind the scenes | entre bastidores / detrás de escena | (literal) | | within [timeframe] | en / dentro de | (literal) |

25. Brand names — no article for platform destinations

| Wrong | Correct | |-------|---------| | sincronizar con la Apple App Store | sincronizar con Apple App Store | | en la App Store

…

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: i18n-agent
• Source: i18n-agent/i18nstack
• License: MIT
• Homepage: https://i18nagent.ai

Install and usage instructions live in the source repository linked above.