blog-multilingual
One-command multilingual blog creation. Writes a blog post, translates it into user-specified languages, applies cultural adaptation, and emits hreflang tags, sitemap entries, and a CMS-ready language map. The complete write-to-publish pipeline for international content. Orchestrates blog-write, blo
By agricidaniel · 2,002 installs
npx skills add agricidaniel/claude-blog --skill blog-multilingual
Source repository · Upstream listing
Blog Multilingual, One Command International Publishing
The flagship multilingual orchestrator. Combines blog writing, translation,
cultural adaptation, and full international SEO into a single command.
Produces publication ready blog posts in every target language with hreflang
tags, localized JSON LD schema, and CMS integration metadata.
Adapted from claude blog multilingual by Chris Mueller (AI Marketing Hub
Pro Hub Challenge submission, March 2026, scored 85/100 Proficient).
Original: https://github.com/Chriss54/multilingual int
This port removes the original curl bash installer and credential
handling flagged in the audit, integrates as core skills, and uses the
shared cultural adaptation reference under blog translate/references/ .
Dependencies
Invoked internally by this orchestrator:
Component Source Required
blog write claude blog (this plugin) Yes
blog translate claude blog (this plugin) Yes
blog localize claude blog (this plugin) Yes (when localize is on, default)
seo hreflang claude seo (sibling plugin) No, falls back to a self contained generator
If seo hreflang is not installed, the orchestrator emits hreflang tags using
its own minimal generator (Phase 5 below) and notes the limitation in the
delivery summary. Hreflang validation in that case is structural only, not the
deeper validation seo hreflang provides.
Command Syntax
Argument Required Default Description
<topic Yes required Blog topic or working title
languages Yes required Comma separated Google compatible hreflang tags (e.g. de,fr,es MX,ja,pt BR )
source No en Source language to write the original in
no localize No off Skip cultural adaptation (translation only)
format No auto Output format: md , mdx , or html
If languages is missing, ask the user once before running anything:
"Which languages should the blog be published in? Provide hreflang tags
separated by commas (e.g., de,fr,es MX,ja,pt BR ). The post will be written
in <source first, then translated."
Workflow
Phase 1: Configuration
1. Parse arguments. Extract topic, target languages, source, format.
2. Validate each language code with the shared multilingual locale rules used
by blog translate , blog localize , and blog locale audit : ISO 639 1
language in lowercase, optional ISO 15924 script in title case, optional
ISO 3166 1 Alpha 2 region in uppercase. Require a region or explicit
neutral mode for ambiguous language only targets such as es , pt , and
zh .
3. Detect output format from the project (frontmatter convention, file
extensions, framework hints) or use format .
4. Resolve source language. If a target language equals source , drop it
from the translation list with a notice.
5. Create the output directory inside the current working directory:
Keep all output inside the project root; do not write outside the cwd.
Progress: Phase 1: Configuration complete, [N] languages selected ([codes])
Phase 2: Write Original Blog
Invoke the blog write sub skill (route through /blog write so all
existing rules apply: template auto selection, sourced statistics, citation
capsules, Article schema priority, FAQPage only as an entity signal when
visible FAQ content exists, internal link zones, charts, image embedding). Pass the
topic and any blog write parameters surfaced by the user.
Save the original to multilingual/{source lang}/{slug}.{ext} .
Progress: Phase 2: Original written, multilingual/{source lang}/{slug}.{ext}
Phase 3: Translate to All Target Languages
For each target language, invoke blog translate :
Input: the original blog post produced in Phase 2.
Target: the specific language code.
Run targets in parallel where the runtime supports it (one Task per
language) to reduce wall clock time.
Save translations to multilingual/{lang}/{localized slug}.{ext} .
Progress: Phase 3: Translating to [lang] ([X]/[N]) per language, then
Phase 3: All translations complete .
Phase 4: Cultural Adaptation
If no localize is NOT set, invoke blog localize for every translated
post:
Input: the translated blog post.
Locale: the target language or region code.
Run in parallel.
Apply the localized output only after resolving the generated path inside
multilingual/ , rejecting symlinks, and creating a backup when overwriting.
The localizer swaps brand examples, adapts CTAs, substitutes legal
references, and adjusts formality. See
../blog localize/SKILL.md for the full adaptation pass.
Progress: Phase 4: Cultural adaptation complete for [N] languages .
Phase 5: International SEO Generation
Generate three artifacts plus localized schema. If the seo hreflang skill
from claude seo is installed, delegate validation to it. Otherwise use the
self contained generator below.
5a. Hreflang Tags (HTML)
Copy paste ready tags for <head :
Rules (mirrored from seo hreflang ):
Every page references all alternates including itself (self referencing).
Every href , including x default , is a fully qualified absolute
https://... URL.
x default points to the unmatched language fallback, such as a global
language selector or default market page. It does not have to be the source
language version.
All URLs use the same protocol (HTTPS) and trailing slash convention.
Bidirectional: every relationship is reciprocal.
Save to multilingual/hreflang tags.html .
5b. Hreflang Sitemap Fragment
Generate one <url block per locale. Every block must contain the identical
complete set of <xhtml:link alternates for every locale, plus self and
optional x default , using fully qualified https://... URLs.
Save to multilingual/hreflang sitemap.xml .
5c. Hreflang Map (JSON)
Machine readable mapping for CMS integration:
Save to multilingual/hreflang map.json .
5d. Localized Article Schema (Required)
Attach or update Article/BlogPosting JSON LD on every language version with
inLanguage and translationOfWork fields:
Use the existing /blog schema sub skill for richer schema on each version.
Keep Article/BlogPosting, Person, Organization, and BreadcrumbList as the
priority stack. FAQPage is optional and only for visible FAQ content as an
entity and AI citation signal, not a Google rich result target.
Phase 6: Delivery Summary
Cross References
When Run
To regenerate or reword the source /blog write <topic
To translate one existing file only /blog translate <file to <codes
To deepen cultural fit on one file /blog localize <file locale <code
To audit a multilingual directory /blog locale audit <directory
For deeper hreflang validation /seo hreflang <directory (claude seo, optional)
Error Handling
Scenario Action
blog write missing Error: "This skill requires blog write . Reinstall claude blog."
One translation fails Complete the rest, report partial results, suggest a retry command
Source language equals a target Skip that target, log a notice
10 or more target languages Stop before writing. Explain scaled content abuse risk and require reviewed batches of at most 9 target languages
seo hreflang not installed Use the self contained generator, note it in the summary
Commands Recap
Command Purpose
/blog multilingual <topic languages de,fr,es Write source, translate, localize, emit hreflang assets
/blog translate <file to de,fr,es Translate one file into target languages
/blog localize <file locale de DE Cultural deep adaptation of one translated file
/blog locale audit <directory Multilingual QA across a directory