blog-translate
Skill0 starsChanged 3 months agoMITView on GitHub
Translate existing blog posts into one or more target languages with SEO-optimized localization. Produces native-quality translations that preserve markdown structure, frontmatter, schema JSON-LD, image and chart embeds, and citation capsules. Localizes keywords, meta tags, numbers, dates, currencies, and quote styles per locale. Flags machine-translation artifacts for review. Run BEFORE blog-localize: this handles language conversion; localize handles cultural adaptation after translation completes. Use when user says "translate blog", "blog translate", "uebersetzen", "traduire", "traducir", "translate post", "blog auf Deutsch", "blog en espanol".
2 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- gaznil/seo-skills-by-gaznilword for word, first seen Nov 16, 2026
- AgriciDaniel/claude-blogedited, first seen Oct 25, 2026
Other versions2 projects use a version of this.
Word for word · 1
- gaznil/seo-skills-by-gaznil★ 0100% same
Edited · 1
- AgriciDaniel/claude-blog★ 2.7k41% same
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository85 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/llms-full.txtllms.txt
- docs/llms.txtllms.txt
- llms-full.txtllms.txt
- llms.txtllms.txt
- ab-testingSkill
- accessibilitySkill
- ai-seoSkill
- analyticsSkill
- attributionSkill
- blog-analyzeSkill
- blog-audioSkill
- blog-auditSkill
- blog-brandSkill
- blog-briefSkill
- blog-calendarSkill
- blog-cannibalizationSkill
- blog-chartSkill
- blog-clusterSkill
- blog-discourseSkill
- blog-factcheckSkill
- blog-flowSkill
- blog-geoSkill
- blog-googleSkill
- blog-imageSkill
- blog-locale-auditSkill
- blog-localizeSkill
- blog-multilingualSkill
- blog-notebooklmSkill
- blog-outlineSkill
- blog-personaSkill
- blog-repurposeSkill
- blog-rewriteSkill
- blog-schemaSkill
- blog-seo-checkSkill
- blogSkill
- blog-strategySkill
- blog-taxonomySkill
- blog-writeSkill
- canonical-tagSkill
- competitorsSkill
- content-optimizationSkill
- content-strategySkill
- copywritingSkill
- core-web-vitalsSkill
- croSkill
- directory-submissionsSkill
- eeat-signalsSkill
- entity-seoSkill
- featured-snippetSkill
- google-search-consoleSkill
- heading-structureSkill
- indexingSkill
- indexnowSkill
- internal-linksSkill
- keyword-researchSkill
- local-seoSkill
- meta-descriptionSkill
- mobile-friendlySkill
- open-graphSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 6 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 49
Read the source file (markdown, MDX, or HTML).
- Distinctive: line 68
All headings (H1, H2, H3).
- Distinctive: line 97
If a local equivalent has real search behavior, swap to it.
- Distinctive: line 112
Run agents in parallel when translating into multiple languages.
- Distinctive: line 120
Add or update locale frontmatter:
- Distinctive: line 129
All images present with translated alt text.
- Very specific: line 130
All SVG charts present with translated text labels (length-adjusted: DE +30%, FR +15%, JA -20%, others see references/translation-rules.md).
- Very specific: line 139
When invoked from blog-multilingual, save into multilingual/{lang}/{localized-slug}.{ext} instead.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Blog Translate, SEO-Optimized Blog Translation
Translates an existing blog post into one or more target languages. Unlike generic translation, this skill produces SEO-optimized, publication-ready content with localized keywords, meta tags, and culturally correct formatting.
Adapted from
claude-blog-multilingualby Chris Mueller (Pro Hub Challenge, March 2026). Original: https://github.com/Chriss54/multilingual-int
Key References
Load on demand:
references/translation-rules.md, format preservation, number/date/currency formats per locale, quote handling, quality criteria.references/cultural-adaptation.md, cultural profiles per locale (DACH, Francophone, Hispanic, Japanese, custom). This file is shared withblog-localize(do not duplicate).
Workflow
Phase 1: Input Parsing
- Read the source file (markdown, MDX, or HTML).
- Auto-detect source language. Order of preference:
- Frontmatter
langfield. - HTML
langattribute. - Content analysis (script, common stop words).
- Frontmatter
- Parse target languages from
--toas comma-separated ISO 639-1 codes (de,fr,es,ja,pt-BR). If--tois missing, ask the user once: "Which languages should I translate to? Provide ISO 639-1 codes (e.g., de, fr, es, ja, pt-BR)." - Validate every code. Reject invalid ones with a suggestion (
jpbecomes "Did you meanjafor Japanese?"). If a target equals the source language, skip it with a notice.
Phase 2: Content Analysis
Extract the translatable surface:
- Frontmatter:
title,description,tags,author(only when translatable, e.g. role labels, not personal names). - All headings (H1, H2, H3).
- Body paragraphs.
- Image
alttext and<figcaption>content. - Chart
<text>and<tspan>content; preserve every SVG attribute (x,y,font-size,fill,transform). - FAQ questions and answers.
- Citation capsule text.
- Key Takeaways or summary box.
- CTA text.
- Internal-link zone anchor text.
Preserve unchanged:
- Markdown and HTML structure, tags, attributes.
- Image URLs, link URLs, frontmatter keys.
- Code blocks (translate inline comments only when meaningful).
- Internal-link zone markers (
[INTERNAL-LINK: ...]). - Source organization names in citations (Gartner, McKinsey, etc.).
- Person names.
- Schema JSON-LD blocks (translate only the user-facing string values).
Identify the primary and secondary keywords for Phase 3.
Phase 3: Keyword Localization
For each target language:
- Decide whether the source keyword is the established term in the target market. If yes (e.g., "Content Marketing" stays in German), keep it.
- If a local equivalent has real search behavior, swap to it.
- Apply the same logic to secondary keywords.
- Record the mapping. The translator agent uses it to update title, meta description, and H2 headings consistently.
Phase 4: Translation
Spawn the blog-translator agent (via Task) for each target language with:
- The source content.
- The keyword localization map from Phase 3.
- The target language code.
- Pointers to
references/translation-rules.mdand the cultural profile inreferences/cultural-adaptation.mdif one exists for the target locale.
Run agents in parallel when translating into multiple languages.
The agent returns the fully translated post in the same format as the input.
Phase 5: Post-Processing
For each translated version:
- Add or update locale frontmatter:
lang: "de" translatedFrom: "en" translatedDate: "YYYY-MM-DD" slug: "wie-man-ki-slop-vermeidet" - Verify structural integrity:
- Same number of H2 and H3 sections as the original.
- All images present with translated alt text.
- All SVG charts present with translated text labels (length-adjusted:
DE +30%, FR +15%, JA -20%, others see
references/translation-rules.md). - FAQ count matches.
- Citation capsules present in each H2.
- Save translated files:
When invoked fromtranslations/ {lang}/{localized-slug}.{ext}blog-multilingual, save intomultilingual/{lang}/{localized-slug}.{ext}instead.
Phase 6: Translation-Quality Guardrails
Scan the output for machine-translation artifacts before reporting done:
- Literal idioms (English idioms transliterated, not adapted).
- Unnatural word order (SOV translated as SVO into a non-SVO language, or the reverse).
- Mixed-language sentences (other than established loanwords).
- Number, date, or currency strings still in source format.
- Frontmatter strings still in the source language.
Flag every issue inline (file path, line number, fix suggestion). The translator agent should re-pass any flagged passage before delivery.
Phase 7: Delivery
## Translation complete: [Original title]
### Source
- Language: [source]
- File: [source path]
### Translations
| Language | File | Keywords adapted | Status |
|----------|------|------------------|--------|
| de | translations/de/{slug}.md | [N] | ok |
| fr | translations/fr/{slug}.md | [N] | ok |
### Quality checks
- Structural integrity: pass / fail per language
- Meta tags localized: pass / fail per language
- Numbers, dates, currencies formatted per locale: pass / fail
- Keywords localized: [N] keywords adapted
- Machine-translation artifacts flagged: [N] (see notes above)
### Next steps
- Run `/blog localize <file> --locale <code>` for cultural deep-adaptation.
- Run `/blog locale-audit translations/` to verify completeness.
- Use `/blog multilingual` to combine write, translate, localize, hreflang
in one command.Error Handling
| Scenario | Action |
| Unsupported language code | Suggest the correct ISO 639-1 code |
| Source equals a target | Skip with "Source is already in [lang]" |
| File not found | Report error with suggested path |
| Translator agent timeout | Retry once, then report partial results |
| Binary or non-text file | Report error, suggest correct file |
Cross-References
- Next step (cultural depth):
/blog localize <file> --locale <code> - QA sweep across all language versions:
/blog locale-audit <directory> - One-command pipeline:
/blog multilingual <topic> --languages <codes>
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

