blog-localize

Files (1)

• SKILL.md

SKILL.md (first lines)

# Blog Localize, Cultural Deep-Adaptation

Takes a translated blog post and performs cultural adaptation so the result
feels like it was written for the target market, not translated into it.
This is the layer above `blog-translate`: it replaces examples, adjusts
tone, swaps references, and localizes the entire reading experience.

## Key References

- `../blog-translate/references/cultural-adaptation.md`, the shared cultural
  profiles file with substitution tables for DACH, Francophone, Hispanic,
  Japanese, and a custom template. Do not duplicate this file.

## When to Use

- Right after `blog-translate` produces a base translation.
- When existing translated content reads like "translated from English".
- When targeting a specific market, not just a language.
- When content needs local statistics, examples, and brand references.

## Workflow

### Phase 1: Locale Understanding

1. Parse the locale code. Accept full codes (`de-DE`, `fr-CA`, `es-MX`,
   `pt-BR`, `zh-TW`) or plain language codes (`de`, `fr`).
2. Load the cultural profile from
   `../blog-translate/references/cultural-adaptation.md`.
   - If the locale has a profile, use it.
   - If not, follow the "Custom-locale template" section in that reference
     to build a minimal profile inline.
3. Read the translated post and identify adaptation targets.

### Phase 2: Cultural Audit

Scan for elements that signal foreign origin:

| Element | What to look for |
|---------|------------------|
| Brand examples | US or UK brands with no relevance locally |
| Statistics sources | US-only studies and surveys |
| CTAs | American-style aggressive calls-to-action |
| Idioms | Literally translated English expressions |
| Legal references | Foreign laws (CCPA, FTC) where local law applies (DSGVO, RGPD) |
| Cultural references | Foreign holidays, events, customs |
| Currency and pricing | USD without conversion or context |
| Tone | Too casual or too formal for the target market |
| Address form | Inconsistent Sie/du, tu/vous, formal/informal |

Output an audit report listing every target with severity (critical,
recommended, optional).

### Phase 3: Adaptation

#### 3a. Example Substitution

Swap foreign examples for local equivalents:

- Use WebSearch to find local case studies, brands, or scenarios.
- Replace inline, preserving the same argument and structure.
- If no local equivalent exists, keep the original but add local context
  ("In the German market, the equivalent dynamic is X").

#### 3b. Statistics Localization

- Search for equivalent local statistics (`[topic] statistik [country] 2025
  2026`).
- If local data exists, swap the source and the figure together. Keep one
  named source per claim.
- If not, keep the original stat but mark its geographic scope ("In the
  US, ...").
- Never strip source attribution.

#### 3c. CTA Adaptation

Rewrite calls-to-action per the cultural profile:

- Adjust aggressiveness level (DACH and JA prefer informational, US prefers
  imperative).
- Use culturally appropriate action verbs.
- Adapt urgency framing.

#### 3d. Tone Calibration

- Match formality per profile (DACH defaults to Sie for B2B, du for B2C
  lifestyle; FR defaults to vous; JA shifts register sharply by audience).
- Ensure consistent formal or informal address throughout the entire
  document.
- Match local content-style conventions.

#### 3e. Legal and Regulatory Context

- Replace references to foreign laws with local equivalents (CCPA becomes
  DSGVO in DE, RGPD in FR, LGPD in BR).
- Add local compliance notes where they help the reader.
- Remove irrelevant foreign regulatory references.

#### 3f. Brand Example Swaps (Quick Map)

Profiles in `../blog-translate/references/cultural-adaptation.md` provide
substitution tables. Common examples:

| Source (US) | DACH | FR | ES (Spain) | LATAM | JA |
|-------------|------|----|----|-------|----|
| Walmart | MediaMarkt | Carrefour | El Corte Ingles | Walmart MX | Aeon |
| Target | Saturn | Auchan | Hipercor | Liverpool | Ito-Yokado |
| FTC | Bundeskartellamt | DGCCRF | CNMC | Profeco (MX) | JFTC |
| CCPA | DSGVO | RGPD | RGPD | LGPD (BR) | APPI |

### Phase 4: Quality Verification

- All critical adaptation targets addressed.
- Tone is consistent throughout.
- No remaining foreign-origin markers.
- Statistics have valid sources (original or localized).
- CTAs match cultural expectations.
- Formal or informal address is consistent end to end.
- Content still supports the same argument as the original.
- SEO elements remain optimized (keywords, meta, headings).

From Infrasity-Labs/dev-gtm-claude-skills, MIT.

More from Infrasity-Labs/dev-gtm-claude-skills