# Localize It

> Use when translating or localizing UI strings, marketing copy, documentation, or any source text into Italian (it). Enforces Lei/tu consistency, le/la/lo gender + number agreement, article contractions (al, del, nel), e→ed before e-vowels, subjunctive after doubt/necessity, postnominal adjectives, anglicism-verb avoidance (caricare not uploadare), and `Senza X` patterns over English `Zero X` calq…

- **Type:** Skill
- **Install:** `agentstack add skill-i18n-agent-i18nstack-localize-it`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [i18n-agent](https://agentstack.voostack.com/s/i18n-agent)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [i18n-agent](https://github.com/i18n-agent)
- **Source:** https://github.com/i18n-agent/i18nstack/tree/main/localize-it
- **Website:** https://i18nagent.ai

## Install

```sh
agentstack add skill-i18n-agent-i18nstack-localize-it
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Italian Translation Rules (it / italiano)

Distilled from the production translation prompts. Follow these rules verbatim — they are model-agnostic and produce consistent native-quality Italian output.

## Mindset

> Sei uno scrittore italiano estremamente esigente che detesta le costruzioni poco naturali in italiano, come le traduzioni letterali dall'inglese o le formulazioni maldestre.

Reject literal English calques and verbed anglicisms. Restructure fully into natural Italian. Common English noun loanwords (file, computer, link, mouse, software) are tolerated; Italianized verb forms (`uploadare`, `settare`, `linkare`) are NOT.

## Pre-Translation Setup

Lock in before translating:

1. **Formality (Lei vs tu)** — Default to `tu` for consumer/casual; default to `Lei` for B2B/professional. NEVER mix within a file. (`voi` plural formal is out-of-scope — stick to Lei or tu.)
2. **Two genders** — il/lo/la/l' (singular), i/gli/le (plural). Article choice depends on what follows.
3. **SVO word order** — most adjectives FOLLOW the noun (BAGS adjectives like `bello, grande, alto, vecchio` precede).
4. **No French-style NBSP** — Italian uses standard ASCII spacing around `: ; ? !` (don't apply French rules).
5. **Placeholders** — Preserve `{variables}` and ICU plural syntax exactly.

## Register Auto-Detection (run after Pre-Translation Setup, before translating)

If the user has NOT specified Lei or tu, infer from source text register. Match output to source — formal source → Lei; informal source → tu.

### Formal source signals → output Lei / La / Le / Suo / Sua / Suoi / Sue (all capitalized)
- 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, luxury, automotive
- Third-person / distance: "the user must", "customers should"
- Long sentences, formal connectors ("inoltre", "tuttavia", "pertanto")
- Brand voice: bank, insurance, government, B2B SaaS, healthcare, legal tech, luxury retail
- No exclamations or emojis

### Informal source signals → output tu / tuo / tua / tuoi / tue (lowercase)
- Contractions: "don't", "you'll", "it's", "we're"
- Casual greetings: "hey", "hi there", "yo", "hi 👋", "ciao!"
- Second-person directness, exclamations, emoji (🎉 😎 🚀 ✨)
- Slang: "cool", "awesome", "no worries", "kinda"
- Consumer-app voice: gaming, social, lifestyle, dating, fitness, kids, casual e-commerce, food delivery
- Sentence fragments and conversational filler

### Mixed / ambiguous source → default to Lei
Lei reads slightly distant but professional; tu can read as overly familiar in B2B/government/luxury contexts. When in doubt, stay formal — most Italian B2B and many consumer brands still use Lei. Italian consumer-app trend toward tu is more recent than in other Romance languages.

### Explicit user override
If the user says "use tu" / "use Lei" / "formal" / "casual" / "give me the dài-form" (rare), their instruction wins.

### Worked examples

| Source | Detected | Italian output |
|----------------|----------|----------------|
| "Please review the terms of service before proceeding." | formal | La preghiamo di leggere i termini di servizio prima di procedere. |
| "Hey! Tap here to get started — it's super quick 🚀" | informal | Ciao! Tocca qui per iniziare — è super veloce 🚀 |
| "Submit your application by the deadline." | formal | Invii la Sua candidatura entro la scadenza. |
| "Don't forget to save your work!" | informal | Non dimenticare di salvare il tuo lavoro! |

After detection: keep the chosen form consistent. NEVER mix Lei/tu across pronouns, possessives, OR imperatives.

### Voi (plural formal) — out-of-scope
`voi` as 2nd-person plural formal is historical/southern Italian usage (still common in Naples, parts of Sicily, older formal correspondence). For modern standard Italian software UI, **stick to Lei (singular formal) and tu (singular informal)**. Plural is rendered as `voi` (informal plural) or `Loro` (very formal plural, archaic — avoid). For UI strings addressing multiple users, prefer recasting to singular or using neutral infinitives (`Salvare`, `Eliminare`).

## Critical Accuracy Rules

### 1. Gender of common IT nouns (memorize)

| Masculine | Feminine |
|-----------|----------|
| **il** problema | **la** soluzione |
| **il** sistema | **la** piattaforma |
| **il** programma | **l'**applicazione |
| **il** tema | **l'**interfaccia |
| **il** file | **la** pagina |
| **il** software | **la** rete |
| **il** server | **la** connessione |
| **il** browser | **la** configurazione |
| **il** link | **la** validazione |
| **il** plugin | **la** versione |
| **il** database | **la** cartella |
| **il** documento | **l'**email (also `la mail`) |
| **il** messaggio | **la** password |

**-ma Greek-origin nouns are MASCULINE** (despite ending in -a): `il problema, il sistema, il programma, il tema, lo schema`.
**-zione / -sione / -tà / -tù → ALWAYS feminine**: `la soluzione, la connessione, la qualità, la gioventù`.

**Foreign tech brands default to MASCULINE**: `il OneSky, il Slack, il Teams`. Exception: `l'Apple` (company, fem implied by "ditta/azienda").

Common errors: `la problema` → `il problema`; `il soluzione` → `la soluzione`; `la sistema` → `il sistema`.

### 2. Acronym gender inheritance (CRITICAL, severity 2.0)

Acronyms inherit gender from the expanded form. Translate English acronyms too.

| Acronym | Expansion | Gender |
|---------|-----------|--------|
| **l'IA** | Intelligenza Artificiale | feminine |
| **l'API** | Interfaccia di Programmazione | feminine |
| **la CPU** | Unità Centrale | feminine |
| **l'URL** | Localizzatore | masculine |
| **il PDF** | Formato Documento | masculine |

| Wrong | Correct |
|-------|---------|
| il nostro AI | **la nostra IA** (translate + correct gender) |
| il nostro IA | **la nostra IA** |

### 3. Article selection — `il / lo / la / l'`

| Use | Before |
|-----|--------|
| `il` | masc + consonant: `il file`, `il computer` |
| `lo` | masc before **s+consonant, z, gn, ps, x, y**: `lo spirito`, `lo psicologo`, `lo zaino`, `lo gnomo`, `lo xilofono` |
| `la` | fem + consonant: `la pagina` |
| `l'` | any vowel: `l'utente` (m), `l'applicazione` (f) |

Plurals: `i` (masc + cons) / `gli` (masc + vowel/s+cons/z/etc.) / `le` (fem all).

| Wrong | Correct |
|-------|---------|
| il utente | **l'utente** |
| il psicologo | **lo psicologo** |
| il spirito | **lo spirito** |

### 4. Apostrophe / elision — `un'` is FEMININE ONLY

| Wrong | Correct |
|-------|---------|
| un'utente (masc) | **un utente** (no apostrophe for masc) |
| una applicazione | **un'applicazione** (fem: apostrophe) |
| il utente | **l'utente** |
| dell utente | **dell'utente** |
| nell applicazione | **nell'applicazione** |

`un'` ONLY for feminine before vowel. Masculine before vowel = `un` with no apostrophe.

### 5. Preposition contractions (mandatory, severity 1.0)

| Combine | → |
|---------|---|
| a + il | **al** |
| a + la | alla |
| a + l' | all' |
| a + i | ai |
| a + gli | agli |
| a + le | alle |
| di + il | **del** |
| di + la | della |
| in + il | **nel** |
| in + la | nella |
| su + il | **sul** |
| da + il | **dal** |

| Wrong | Correct |
|-------|---------|
| di il progetto | **del progetto** |
| a la piattaforma | **alla piattaforma** |
| in il sistema | **nel sistema** |

### 6. Article completeness in noun phrases (CRITICAL, severity 1.5)

Specific known nouns require articulated prepositions. Exception: generic classifiers (`errore di sistema` = type of error).

| Wrong | Correct |
|-------|---------|
| Errore di applicazione | **Errore dell'applicazione** |
| Configurazione di account | **Configurazione dell'account** |
| Stato di connessione | **Stato della connessione** |
| Dettagli di transazione | **Dettagli della transazione** |
| variabile di ambiente manca | **la variabile di ambiente manca** / `manca la variabile di ambiente` |

### 7. Conjunction `e → ed` (euphonic rule, CRITICAL, severity 1.5)

Use `ed` ONLY before a word starting with `e`. Use `e` everywhere else (including before other vowels).

| Wrong | Correct |
|-------|---------|
| e ecco | **ed ecco** |
| e elegante | **ed elegante** |
| ed API (starts with /a/) | **e API** |
| ed italiano (starts with /i/) | **e italiano** |

Modern Italian uses `ed` only before `e-` (older usage extended to all vowels — avoid it).

### 8. Accents — distinguish meaning

| Wrong | Correct | Why |
|-------|---------|-----|
| perche | **perché** | acute on closed `e` |
| citta | **città** | grave on stressed final |
| caffe | **caffè** | grave on open `e` |
| e importante | **è importante** | `è` = is; `e` = and |
| pero (= pear tree) | **però** (= but) | accent disambiguates |
| pò | **po'** (= a bit) | uses apostrophe, NOT accent |
| si (reflexive) | **sì** (= yes) | accent on "yes" |
| da (preposition) | **dà** (= gives) | accent on the verb |

### 9. Double consonants (severity 1.5)

| Wrong | Correct |
|-------|---------|
| applicatione | **applicazione** |
| conessione | **connessione** |
| programare | **programmare** |
| comunicazione (this is correct) | comunicazione |
| professionale (correct) | professionale |

### 10. Subjunctive (congiuntivo) — required after doubt / necessity / emotion

Triggers: `È necessario che`, `È possibile che`, `Bisogna che`, `Sembra che`, `Credo che`, `Penso che`, `Spero che`, and conjunctions: `sebbene, nonostante, affinché, benché, purché, prima che, senza che`.

| Wrong (indicative) | Correct (subjunctive) |
|--------------------|----------------------|
| È possibile che il file è corrotto | **È possibile che il file sia corrotto** |
| Bisogna che l'utente salva | **Bisogna che l'utente salvi** |
| nonostante il sistema funziona | **nonostante il sistema funzioni** |
| È necessario che il campo è compilato | **È necessario che il campo sia compilato** |

### 11. Past participle agreement (severity 2.0)

- With **essere**: agrees with subject (gender + number).
- With **avere**: agrees with preceding direct object.

| Wrong | Correct |
|-------|---------|
| Le opzioni sono stato attivato | **Le opzioni sono state attivate** (fem plural) |
| I file sono stato salvato | **I file sono stati salvati** (masc plural) |

### 12. Number / loanword agreement (CRITICAL, severity 2.0)

English loanwords are typically invariable (no plural -s in Italian), but Italian adjectives must still agree in gender/number.

| Wrong | Correct |
|-------|---------|
| i file nuovo | **i file nuovi** |
| il software aggiornata | **il software aggiornato** (software is masc) |
| le feature nuovo | **le feature nuove** |
| i plugin aggiornato | **i plugin aggiornati** |
| le soluzione | **le soluzioni** |

### 13. Adjective position

- Most adjectives FOLLOW the noun: `coerenza perfetta`, `qualità superiore`, `servizio personalizzato`.
- BAGS adjectives (Beauty, Age, Goodness, Size) PRECEDE: `un bell'esempio, un grande progetto, una nuova versione, una piccola azienda`.
- Position can change meaning: `un uomo grande` (tall) vs `un grand'uomo` (great).

| Wrong | Correct |
|-------|---------|
| con perfetta coerenza | **con una coerenza perfetta** / `in modo perfettamente coerente` |
| di superiore qualità | **di qualità superiore** / `di alta qualità` |
| qualità umana (in tech) | **qualità a livello umano** / `qualità professionale` |

## BAGS Adjectives (prenominal)

Most Italian adjectives FOLLOW the noun. BAGS adjectives PRECEDE the noun.

- **B**eauty: `bello, bellissimo, brutto, carino`
- **A**ge: `giovane, vecchio, antico, nuovo, anziano`
- **G**oodness/quality: `buono, ottimo, cattivo, pessimo, grande, grandioso`
- **S**ize: `grande, piccolo, lungo, breve, alto, basso, vasto`

These adjectives can ALSO follow the noun, but the meaning shifts:
- `un grand'uomo` (a great man) vs `un uomo grande` (a tall man)
- `un vecchio amico` (a long-time friend) vs `un amico vecchio` (an elderly friend)
- `un povero ragazzo` (poor / unfortunate) vs `un ragazzo povero` (poor / financially)
- `un caro amico` (dear friend) vs `un amico caro` (expensive friend — rare meaning)
- `un certo modo` (a certain way) vs `un modo certo` (a sure way)

Article elision before BAGS: `un bel film` (NOT `un bello film`); `un buon caffè` (NOT `un buono caffè`); `un gran lavoro` (NOT `un grande lavoro`).

Reference table:

| Adjective | Before noun (idiomatic) | After noun (literal) |
|-----------|--------------------------|----------------------|
| grande | un grand'uomo (great) | un uomo grande (tall) |
| vecchio | un vecchio amico (long-time) | un amico vecchio (elderly) |
| povero | un povero ragazzo (unfortunate) | un ragazzo povero (poor) |
| caro | un caro amico (dear) | un caro amico (also OK) |
| certo | un certo libro (some) | un libro certo (certain) |
| diverso | diverse opinioni (various) | opinioni diverse (different) |
| nuovo | un nuovo modello (new release) | un modello nuovo (brand-new condition) |

### 14. FOR vs PER (CRITICAL, severity 2.0)

Both use `per` — disambiguate with quantifier placement.

| English | Wrong | Correct |
|---------|-------|---------|
| for 5 languages (total) | per lingua | **per 5 lingue** |
| per language (rate) | per 5 lingue | **per lingua** / `a lingua` |

### 15. Domain terminology — IT meaning

| English | Wrong | Correct |
|---------|-------|---------|
| build (software) | costruzione | **sviluppare / creare / realizzare** |
| deploy | dispiegare (military) | **distribuire / rilasciare / mettere in produzione** |
| support (feature) | (ambiguous `supportare`) | **supportare** (accepted in tech) / `essere compatibile con` / `includere il supporto per` |
| sync with [Platform] | sincronizzare con il/la Platform | **sincronizzare con [Platform]** (no article for destinations) |
| listings (app store) | liste, elenchi | **schede dell'app / pagine dell'applicazione** |
| architecture (software) | architettura (costruzione) | **architettura (software)** |
| pipeline (CI/CD) | tubatura | **pipeline (CI/CD)** |
| source of truth | fonte della verità | **fonte di riferimento / fonte autoritativa** |

## UI Conventions

### Buttons — infinitive form (neutral, works with Lei AND tu)

| Wrong | Correct |
|-------|---------|
| Fare il salvataggio | **Salvare** / `Salva` (tu) |
| Effettuare l'eliminazione | **Eliminare** / `Elimina` |
| Salvi (Lei imperative) | **Salvare** (avoids formality complexity) |

### Status messages — nominalized noun form

| Wrong | Correct |
|-------|---------|
| Sta salvando... | **Salvataggio...** |
| Sta caricando... | **Caricamento...** |
| Sta elaborando... | **Elaborazione in corso...** |

### Completion messages — participial (NOT `riuscito`)

| Wrong (calque) | Correct |
|----------------|---------|
| Pagamento riuscito | **Pagamento effettuato** / `Pagamento completato` |
| Caricamento riuscito | **Caricamento completato** / `File caricato` / `Fatto!` |
| Download completo | **Download completato** / `Download terminato` |
| Operazione riuscita | **Operazione completata** / `Fatto!` |

For failures:

| Wrong | Correct |
|-------|---------|
| Operazione fallita | **Errore durante [Noun]** / `Non è stato possibile completare [Noun]` |

### Empty state — `Nessun(o/a) X` or `Non ci sono X`

| Wrong | Correct |
|-------|---------|
| Niente risultati | **Nessun risultato** / `Non ci sono risultati` |
| Niente file selezionato | **Nessun file selezionato** |
| Senza dati | **Nessun dato disponibile** / `Non ci sono dati disponibili` |
| Vuoto | **Nessun elemento presente** |

`Nessun/Nessuno/Nessuna` requires gender agreement.

### Drag and drop

| English | Italian |
|---------|---------|
| drag | trascinare |
| drop | rilasciare |
| **release** (let go) | **rilasciare** — NOT `permettere` (= permit) |
| **browse** (file picker) | **selezionare / scegliere** — NOT `sfogliare` |

…

## 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](https://github.com/i18n-agent)
- **Source:** [i18n-agent/i18nstack](https://github.com/i18n-agent/i18nstack)
- **License:** MIT
- **Homepage:** https://i18nagent.ai

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-i18n-agent-i18nstack-localize-it
- Seller: https://agentstack.voostack.com/s/i18n-agent
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.