{"id":"9dda8a65-579b-46bb-bc31-caf206c1d745","shortId":"P8p4s5","kind":"skill","title":"blog-localize","tagline":"Cultural adaptation for translated content. Run AFTER blog-translate completes. Adjusts brand examples, CTAs, legal references, and formality for the target market (German, French, Japanese, Spanish, etc.). Deep cultural adaptation of translated blog posts. Goes beyond translatio","description":"# Blog Localize, Cultural Deep-Adaptation\n\nTakes a translated blog post and performs cultural adaptation so the result\nfeels like it was written for the target market, not translated into it.\nThis is the layer above `blog-translate`: it replaces examples, adjusts\ntone, swaps references, and localizes the entire reading experience.\n\n> Adapted from `claude-blog-multilingual` by Chris Mueller (Pro Hub Challenge,\n> March 2026). Original: https://github.com/Chriss54/multilingual-int\n\n## Key References\n\n- `../blog-translate/references/cultural-adaptation.md`, the shared cultural\n  profiles file with substitution tables for DACH, Francophone, Hispanic,\n  Japanese, and a custom template. Do not duplicate this file.\n\n## When to Use\n\n- Right after `blog-translate` produces a base translation.\n- When existing translated content reads like \"translated from English\".\n- When targeting a specific market, not just a language.\n- When content needs local statistics, examples, and brand references.\n\n## Workflow\n\n### Phase 1: Locale Understanding\n\n1. Parse the locale code. Accept full codes (`de-DE`, `fr-CA`, `es-MX`,\n   `pt-BR`, `zh-TW`) or plain language codes (`de`, `fr`).\n2. Load the cultural profile from\n   `../blog-translate/references/cultural-adaptation.md`.\n   - If the locale has a profile, use it.\n   - If not, follow the \"Custom-locale template\" section in that reference\n     to build a minimal profile inline.\n3. Read the translated post and identify adaptation targets.\n\n### Phase 2: Cultural Audit\n\nScan for elements that signal foreign origin:\n\n| Element | What to look for |\n|---------|------------------|\n| Brand examples | US or UK brands with no relevance locally |\n| Statistics sources | US-only studies and surveys |\n| CTAs | American-style aggressive calls-to-action |\n| Idioms | Literally translated English expressions |\n| Legal references | Foreign laws (CCPA, FTC) where local law applies (DSGVO, RGPD) |\n| Cultural references | Foreign holidays, events, customs |\n| Currency and pricing | USD without conversion or context |\n| Tone | Too casual or too formal for the target market |\n| Address form | Inconsistent Sie/du, tu/vous, formal/informal |\n\nOutput an audit report listing every target with severity (critical,\nrecommended, optional).\n\n### Phase 3: Adaptation\n\n#### 3a. Example Substitution\n\nSwap foreign examples for local equivalents:\n\n- Use WebSearch to find local case studies, brands, or scenarios.\n- Replace inline, preserving the same argument and structure.\n- If no local equivalent exists, keep the original but add local context\n  (\"In the German market, the equivalent dynamic is X\").\n\n#### 3b. Statistics Localization\n\n- Search for equivalent local statistics (`[topic] statistik [country] 2025\n  2026`).\n- If local data exists, swap the source and the figure together. Keep one\n  named source per claim.\n- If not, keep the original stat but mark its geographic scope (\"In the\n  US, ...\").\n- Never strip source attribution.\n\n#### 3c. CTA Adaptation\n\nRewrite calls-to-action per the cultural profile:\n\n- Adjust aggressiveness level (DACH and JA prefer informational, US prefers\n  imperative).\n- Use culturally appropriate action verbs.\n- Adapt urgency framing.\n\n#### 3d. Tone Calibration\n\n- Match formality per profile (DACH defaults to Sie for B2B, du for B2C\n  lifestyle; FR defaults to vous; JA shifts register sharply by audience).\n- Ensure consistent formal or informal address throughout the entire\n  document.\n- Match local content-style conventions.\n\n#### 3e. Legal and Regulatory Context\n\n- Replace references to foreign laws with local equivalents (CCPA becomes\n  DSGVO in DE, RGPD in FR, LGPD in BR).\n- Add local compliance notes where they help the reader.\n- Remove irrelevant foreign regulatory references.\n\n#### 3f. Brand Example Swaps (Quick Map)\n\nProfiles in `../blog-translate/references/cultural-adaptation.md` provide\nsubstitution tables. Common examples:\n\n| Source (US) | DACH | FR | ES (Spain) | LATAM | JA |\n|-------------|------|----|----|-------|----|\n| Walmart | MediaMarkt | Carrefour | El Corte Ingles | Walmart MX | Aeon |\n| Target | Saturn | Auchan | Hipercor | Liverpool | Ito-Yokado |\n| FTC | Bundeskartellamt | DGCCRF | CNMC | Profeco (MX) | JFTC |\n| CCPA | DSGVO | RGPD | RGPD | LGPD (BR) | APPI |\n\n### Phase 4: Quality Verification\n\n- All critical adaptation targets addressed.\n- Tone is consistent throughout.\n- No remaining foreign-origin markers.\n- Statistics have valid sources (original or localized).\n- CTAs match cultural expectations.\n- Formal or informal address is consistent end to end.\n- Content still supports the same argument as the original.\n- SEO elements remain optimized (keywords, meta, headings).\n- Word count is within the expected ratio for the language pair.\n\n### Phase 5: Save and Report\n\n1. Save the localized version. Default: overwrite the translated file.\n   Optional: save as `{slug}-localized.{ext}` if the user wants to keep the\n   pre-localization version.\n\n2. Present the summary:\n\n   ```\n   ## Localization complete: [Title]\n\n   ### Target locale: [locale-code] ([locale-name])\n\n   ### Adaptations made\n   | Type | Count | Examples |\n   |------|-------|----------|\n   | Brand examples | [N] | Walmart -> MediaMarkt |\n   | Statistics | [N] | US survey -> DACH survey |\n   | CTAs | [N] | \"Buy now\" -> \"Jetzt entdecken\" |\n   | Tone adjustments | [N] | Casual -> Sie |\n   | Legal references | [N] | CCPA -> DSGVO |\n   | Cultural references | [N] | Thanksgiving -> Weihnachtsgeschaeft |\n\n   ### Cultural fit score\n   - Naturalness: [1-10]\n   - Market relevance: [1-10]\n   - Tone match: [1-10]\n   - Overall: [N]/30\n\n   ### Remaining recommendations\n   - [Optional adaptations not applied]\n   ```\n\n## Error Handling\n\n| Scenario | Action |\n|----------|--------|\n| No cultural profile for the locale | Build a minimal profile from the custom-locale template, proceed |\n| File is not in the expected language | Warn the user, offer to translate first |\n| No local statistics available | Keep the original stat with a geographic-scope note |\n| Locale code ambiguous (e.g., `pt`) | Ask: \"Did you mean `pt-BR` (Brazil) or `pt-PT` (Portugal)?\" |\n\n## Cross-References\n\n- Pre-step (translation): `/blog translate <file> --to <code>`\n- QA across language versions: `/blog locale-audit <directory>`\n- One-command pipeline: `/blog multilingual <topic> --languages <codes>`","tags":["blog","localize","claude","agricidaniel","agent-skills","ai-citations","ai-content","ai-marketing","ai-marketing-hub","blog-writing","claude-code","claude-code-skill"],"capabilities":["skill","source-agricidaniel","skill-blog-localize","topic-agent-skills","topic-ai-citations","topic-ai-content","topic-ai-marketing","topic-ai-marketing-hub","topic-blog","topic-blog-writing","topic-claude-code","topic-claude-code-skill","topic-claude-plugin","topic-claude-skill","topic-content-creation"],"categories":["claude-blog"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AgriciDaniel/claude-blog/blog-localize","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AgriciDaniel/claude-blog","source_repo":"https://github.com/AgriciDaniel/claude-blog","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 753 github stars · SKILL.md body (6,369 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:53:30.539Z","embedding":null,"createdAt":"2026-05-18T12:54:53.481Z","updatedAt":"2026-05-18T18:53:30.539Z","lastSeenAt":"2026-05-18T18:53:30.539Z","tsv":"'-10':773,777,781 '/30':784 '/blog':865,872,880 '/blog-translate/references/cultural-adaptation.md':114,216,573 '/chriss54/multilingual-int':111 '1':178,181,689,772,776,780 '2':210,253,716 '2025':416 '2026':107,417 '3':243,355 '3a':357 '3b':405 '3c':453 '3d':484 '3e':527 '3f':565 '4':619 '5':685 'accept':186 'across':869 'action':294,460,479,794 'adapt':5,34,47,56,94,250,356,455,481,624,731,788 'add':393,551 'address':336,516,626,651 'adjust':15,84,465,754 'aeon':595 'aggress':290,466 'ambigu':842 'american':288 'american-styl':287 'appi':617 'appli':309,790 'appropri':478 'argument':381,662 'ask':845 'attribut':452 'auchan':598 'audienc':510 'audit':255,344,875 'avail':829 'b2b':496 'b2c':499 'base':147 'becom':541 'beyond':40 'blog':2,12,37,42,51,79,98,143 'blog-loc':1 'blog-transl':11,78,142 'br':200,550,616,851 'brand':16,174,268,273,373,566,736 'brazil':852 'build':238,801 'bundeskartellamt':605 'buy':749 'ca':194 'calibr':486 'call':292,458 'calls-to-act':291,457 'carrefour':589 'case':371 'casual':328,756 'ccpa':304,540,611,761 'challeng':105 'chris':101 'claim':434 'claud':97 'claude-blog-multilingu':96 'cnmc':607 'code':185,188,207,727,841 'command':878 'common':577 'complet':14,721 'complianc':553 'consist':512,629,653 'content':8,152,168,524,657 'content-styl':523 'context':325,395,531 'convent':526 'convers':323 'cort':591 'count':674,734 'countri':415 'critic':351,623 'cross':859 'cross-refer':858 'cta':454 'ctas':18,286,644,747 'cultur':4,33,44,55,117,213,254,312,463,477,646,763,768,796 'currenc':318 'custom':130,230,317,808 'custom-local':229,807 'dach':124,468,491,581,745 'data':420 'de':190,191,208,544 'de-d':189 'deep':32,46 'deep-adapt':45 'default':492,502,694 'dgccrf':606 'document':520 'dsgvo':310,542,612,762 'du':497 'duplic':134 'dynam':402 'e.g':843 'el':590 'element':258,263,667 'end':654,656 'english':157,298 'ensur':511 'entdecken':752 'entir':91,519 'equival':365,387,401,410,539 'error':791 'es':196,583 'es-mx':195 'etc':31 'event':316 'everi':347 'exampl':17,83,172,269,358,362,567,578,735,737 'exist':150,388,421 'expect':647,678,817 'experi':93 'express':299 'ext':704 'feel':60 'figur':427 'file':119,136,698,812 'find':369 'first':825 'fit':769 'follow':227 'foreign':261,302,314,361,535,562,634 'foreign-origin':633 'form':337 'formal':22,331,488,513,648 'formal/informal':341 'fr':193,209,501,547,582 'fr-ca':192 'frame':483 'francophon':125 'french':28 'ftc':305,604 'full':187 'geograph':444,837 'geographic-scop':836 'german':27,398 'github.com':110 'github.com/chriss54/multilingual-int':109 'goe':39 'handl':792 'head':672 'help':557 'hipercor':599 'hispan':126 'holiday':315 'hub':104 'identifi':249 'idiom':295 'imper':475 'inconsist':338 'inform':472,515,650 'ingl':592 'inlin':242,377 'irrelev':561 'ito':602 'ito-yokado':601 'ja':470,505,586 'japanes':29,127 'jetzt':751 'jftc':610 'keep':389,429,437,710,830 'key':112 'keyword':670 'languag':166,206,682,818,870,882 'latam':585 'law':303,308,536 'layer':76 'legal':19,300,528,758 'level':467 'lgpd':548,615 'lifestyl':500 'like':61,154 'list':346 'liter':296 'liverpool':600 'load':211 'local':3,43,89,170,179,184,219,231,277,307,364,370,386,394,407,411,419,522,538,552,643,692,703,714,720,724,726,729,800,809,827,840,874 'locale-audit':873 'locale-cod':725 'locale-nam':728 'look':266 'made':732 'map':570 'march':106 'mark':442 'marker':636 'market':26,68,162,335,399,774 'match':487,521,645,779 'mean':848 'mediamarkt':588,740 'meta':671 'minim':240,803 'mueller':102 'multilingu':99,881 'mx':197,594,609 'n':738,742,748,755,760,765,783 'name':431,730 'natur':771 'need':169 'never':449 'note':554,839 'offer':822 'one':430,877 'one-command':876 'optim':669 'option':353,699,787 'origin':108,262,391,439,635,641,665,832 'output':342 'overal':782 'overwrit':695 'pair':683 'pars':182 'per':433,461,489 'perform':54 'phase':177,252,354,618,684 'pipelin':879 'plain':205 'portug':857 'post':38,52,247 'pre':713,862 'pre-loc':712 'pre-step':861 'prefer':471,474 'present':717 'preserv':378 'price':320 'pro':103 'proceed':811 'produc':145 'profeco':608 'profil':118,214,222,241,464,490,571,797,804 'provid':574 'pt':199,844,850,855,856 'pt-br':198,849 'pt-pt':854 'qa':868 'qualiti':620 'quick':569 'ratio':679 'read':92,153,244 'reader':559 'recommend':352,786 'refer':20,87,113,175,236,301,313,533,564,759,764,860 'regist':507 'regulatori':530,563 'relev':276,775 'remain':632,668,785 'remov':560 'replac':82,376,532 'report':345,688 'result':59 'rewrit':456 'rgpd':311,545,613,614 'right':140 'run':9 'saturn':597 'save':686,690,700 'scan':256 'scenario':375,793 'scope':445,838 'score':770 'search':408 'section':233 'seo':666 'sever':350 'share':116 'sharpli':508 'shift':506 'sie':494,757 'sie/du':339 'signal':260 'skill' 'skill-blog-localize' 'slug':702 'sourc':279,424,432,451,579,640 'source-agricidaniel' 'spain':584 'spanish':30 'specif':161 'stat':440,833 'statist':171,278,406,412,637,741,828 'statistik':414 'step':863 'still':658 'strip':450 'structur':383 'studi':283,372 'style':289,525 'substitut':121,359,575 'summari':719 'support':659 'survey':285,744,746 'swap':86,360,422,568 'tabl':122,576 'take':48 'target':25,67,159,251,334,348,596,625,723 'templat':131,232,810 'thanksgiv':766 'throughout':517,630 'titl':722 'togeth':428 'tone':85,326,485,627,753,778 'topic':413 'topic-agent-skills' 'topic-ai-citations' 'topic-ai-content' 'topic-ai-marketing' 'topic-ai-marketing-hub' 'topic-blog' 'topic-blog-writing' 'topic-claude-code' 'topic-claude-code-skill' 'topic-claude-plugin' 'topic-claude-skill' 'topic-content-creation' 'translat':7,13,36,50,70,80,144,148,151,155,246,297,697,824,864,866 'translatio':41 'tu/vous':340 'tw':203 'type':733 'uk':272 'understand':180 'urgenc':482 'us':270,281,448,473,580,743 'us-on':280 'usd':321 'use':139,223,366,476 'user':707,821 'valid':639 'verb':480 'verif':621 'version':693,715,871 'vous':504 'walmart':587,593,739 'want':708 'warn':819 'websearch':367 'weihnachtsgeschaeft':767 'within':676 'without':322 'word':673 'workflow':176 'written':64 'x':404 'yokado':603 'zh':202 'zh-tw':201","prices":[{"id":"d9e51fd7-210a-48fb-8f3a-27777bcac9de","listingId":"9dda8a65-579b-46bb-bc31-caf206c1d745","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AgriciDaniel","category":"claude-blog","install_from":"skills.sh"},"createdAt":"2026-05-18T12:54:53.481Z"}],"sources":[{"listingId":"9dda8a65-579b-46bb-bc31-caf206c1d745","source":"github","sourceId":"AgriciDaniel/claude-blog/blog-localize","sourceUrl":"https://github.com/AgriciDaniel/claude-blog/tree/main/skills/blog-localize","isPrimary":false,"firstSeenAt":"2026-05-18T12:54:53.481Z","lastSeenAt":"2026-05-18T18:53:30.539Z"}],"details":{"listingId":"9dda8a65-579b-46bb-bc31-caf206c1d745","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AgriciDaniel","slug":"blog-localize","github":{"repo":"AgriciDaniel/claude-blog","stars":753,"topics":["agent-skills","ai","ai-citations","ai-content","ai-marketing","ai-marketing-hub","blog","blog-writing","claude-code","claude-code-skill","claude-plugin","claude-skill","content-creation","content-optimization","content-strategy","eeat","geo","multilingual","open-source","seo"],"license":"mit","html_url":"https://github.com/AgriciDaniel/claude-blog","pushed_at":"2026-05-15T04:45:18Z","description":"Claude Code blog skill suite: 30 sub-skills, 5 agents, 5-gate v1.9.0 Blog Delivery Contract, dual-optimized for Google rankings and AI citations. Active development at AI-Marketing-Hub/claude-blog (AI Marketing Hub Pro community); public releases ship here.","skill_md_sha":"39e4d77f885ee3ecbce25dc2c2751b94668bb004","skill_md_path":"skills/blog-localize/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AgriciDaniel/claude-blog/tree/main/skills/blog-localize"},"layout":"multi","source":"github","category":"claude-blog","frontmatter":{"name":"blog-localize","license":"MIT","description":"Cultural adaptation for translated content. Run AFTER blog-translate completes. Adjusts brand examples, CTAs, legal references, and formality for the target market (German, French, Japanese, Spanish, etc.). Deep cultural adaptation of translated blog posts. Goes beyond translation to swap brand examples, adapt CTAs, substitute legal references, localize statistic sources where possible, and adjust formality (Sie/du, tu/vous, formal/informal). Built-in profiles for DACH, Francophone, Hispanic, and Japanese markets, plus a custom-locale template. Makes content feel locally authored, not translated. Use when user says \"localize blog\", \"blog localize\", \"cultural adaptation\", \"adapt for Germany\", \"adapt for France\", \"lokalisieren\", \"localiser\", \"adaptar\".","compatibility":"Standalone within claude-blog. Invoked by blog-multilingual."},"skills_sh_url":"https://skills.sh/AgriciDaniel/claude-blog/blog-localize"},"updatedAt":"2026-05-18T18:53:30.539Z"}}