Blog Locale Audit

agricidaniel/claude-blog/brain/.raw/sources/claude-blog-skill/skills/blog-locale-audit

by agricidaniel2500d4c76503MIT2.3K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated yesterday

Audit a directory of multilingual blog content for completeness, consistency, hreflang correctness, meta-tag parity, and freshness. Builds a translation coverage matrix, flags stale translations, validates hreflang and schema, and emits a prioritized report with runnable fix commands. Use when user says "locale audit", "blog locale-audit", "check translations", "multilingual audit", "translation check", "hreflang check", "Uebersetzungen pruefen".

Instructions onlyMarketing & Sales Writing & Content

AI-generated overview

Audits multilingual blog directories for translation coverage, content parity, hreflang correctness, SEO parity and freshness.

What it does: It scans a blog content directory, groups posts by language, and builds a translation coverage matrix showing which posts exist in which locales. It then checks content parity across versions, SEO elements such as title tags, meta descriptions, canonicals and schema, hreflang relationships, and translation freshness. It produces a prioritized markdown report, optionally written as an HTML file inside the audited project root, with runnable fix commands.
When to use it: Use it when a multilingual blog needs a quality check before translation gaps or hreflang errors affect rankings. It fits requests such as locale audit, translation check, multilingual audit or hreflang check on a content directory.
Requirements: Instructions only, with no bundled scripts. It reads blog content files and optional hreflang-tags.html, hreflang-sitemap.xml or hreflang-map.json in the target directory. Deeper hreflang validation is suggested if the external seo-hreflang skill from claude-seo is installed.

Blog Locale Audit, Multilingual Quality Control

Audits a directory of multilingual blog content to ensure every language version is complete, consistent, correctly tagged, and SEO-optimized. Catches international content issues before they hurt rankings.

Adapted from claude-blog-multilingual by Chris Mueller (Pro Hub Challenge, March 2026). Original: https://github.com/Chriss54/multilingual-int

Workflow

Phase 1: Discovery

Resolve the target directory inside the project root/current working directory. Reject symlinked directories and traversal outside the root, then scan blog content and group posts by language using:
- Subdirectory names (en/, de/, fr/).
- Frontmatter lang and translatedFrom fields.
- hreflang-map.json if present.
Normalize detected language codes with the shared multilingual locale rules used by blog-translate, blog-localize, and blog-multilingual: ISO 639-1 language in lowercase, optional ISO 15924 script in title case, optional ISO 3166-1 Alpha-2 region in uppercase. Flag ambiguous language-only codes such as es, pt, and zh unless the content declares an explicit neutral mode.
Build a content matrix mapping which post exists in which languages. Use a stable translation-group key before comparing slugs: translationGroupId, sourceSlug, schema translationOfWork.url, or the IDs and URLs in hreflang-map.json. Fall back to normalized source slug only when no stable key exists.
Detect the source language (most common translatedFrom target, or the sourceLanguage field in hreflang-map.json if present).

Phase 2: Completeness Audit

Show which translations are missing:

### Translation coverage matrix
| Post (EN) | DE | FR | ES | JA ||-----------|----|----|----|----|| how-to-avoid-ai-slop | ok | ok | missing | missing || content-marketing-2026 | ok | missing | ok | missing |
Coverage: 60% (6 of 10 expected translations present)Missing: 4 translations needed

### Translation coverage matrix
| Post (EN) | DE | FR | ES | JA ||-----------|----|----|----|----|| how-to-avoid-ai-slop | ok | ok | missing | missing || content-marketing-2026 | ok | missing | ok | missing |
Coverage: 60% (6 of 10 expected translations present)Missing: 4 translations needed

Phase 3: Content Parity Audit

For every post that exists in multiple languages:

Check	What	Severity
Section count	Same number of H2 and H3 sections	Critical
FAQ count	Same number of FAQ items	High
Image count	Same number of images	High
Chart count	Same number of charts (SVG figures)	High
Word count ratio	Within expected band for language pair (DE +20% to +30%, JA -20%, ES +10%)	Medium
Link count	Similar internal and external link counts	Medium
Citation capsule count	Same number per H2 across versions	Medium
Frontmatter parity	All required fields present per version	High

Flag every significant deviation as an issue.

Phase 4: SEO Parity Audit

For every language version verify:

Element	Check	Severity
Title tag	Present, correct length for the language	Critical
Meta description	Present, correct length, localized and accurate summary; include a verified stat only when central to the article	Critical
`lang` attribute or frontmatter `lang`	Present, valid Google-compatible hreflang or BCP 47 language tag	Critical
Canonical URL	Points to the same-language page, not the source-language page or x-default	Critical
Schema `inLanguage`	Matches `lang`	High
Schema `translationOfWork`	Points to the source URL	High
Alt text	Translated (no English alt in non-EN posts)	High
Slug	Localized (no English slug in non-EN posts)	Medium
Tags	Localized	Medium
Keywords	Localized	Medium

Phase 5: Hreflang Audit

If hreflang-tags.html, hreflang-sitemap.xml, or hreflang-map.json exists in the directory:

Check	What	Severity
Self-referencing	Each page references itself	Critical
Return tags	Every relationship is bidirectional	Critical
Canonical consistency	Every hreflang page canonicalizes to its same-language URL	Critical
`x-default`	Present, points to the unmatched-language fallback such as a language selector or default market page	Critical
Language codes	Valid Google-compatible hreflang tags: ISO 639-1 language plus optional ISO 15924 script or ISO 3166-1 Alpha-2 region	High
URL consistency	Same protocol, same trailing-slash convention	Medium
Completeness	Every language version represented	High

If no hreflang files exist, report it as a critical gap and offer: "Run /blog multilingual <topic> --languages ... to regenerate, or create hreflang-tags.html manually."

If seo-hreflang from claude-seo is installed, suggest running it for deeper validation.

Phase 6: Freshness Audit

For posts with translatedDate in frontmatter:

Check	What	Severity
Source updated after translation	Source modified after `translatedDate`	Critical
Source content drift	Stored source hash or source `dateModified` differs from current source	Critical
Translation drift	Stored translation hash differs from current localized file	Medium
Translation older than 90 days	May need refresh	Medium
`lastUpdated` mismatch across versions	Versions out of sync	Medium
Git or file mtime newer than `translatedDate`	Content changed without frontmatter update	Warning

When available, store and compare sourceHash, source dateModified, translationHash, and Git mtime before relying only on translatedDate.

Emit actionable commands per stale file:

3 translations are stale:- de/ki-trends-2026.md (source updated 2 days ago)  -> Run: /blog translate en/ai-trends-2026.md --to de- fr/ki-trends-2026.md (source updated 2 days ago)  -> Run: /blog translate en/ai-trends-2026.md --to fr- es/tendencias-ia-2026.md (translation > 90 days old)  -> Run: /blog translate en/ai-trends-2026.md --to es

3 translations are stale:- de/ki-trends-2026.md (source updated 2 days ago)  -> Run: /blog translate en/ai-trends-2026.md --to de- fr/ki-trends-2026.md (source updated 2 days ago)  -> Run: /blog translate en/ai-trends-2026.md --to fr- es/tendencias-ia-2026.md (translation > 90 days old)  -> Run: /blog translate en/ai-trends-2026.md --to es

Phase 7: Report

Output as markdown by default. If the user passes --html, also write the report to locale-audit-report.html only inside the audited project root. Escape all dynamic filenames, titles, URLs, and issue text with html.escape(value, quote=True) before rendering HTML, and reject symlinked or outside-root report paths.

## Multilingual content audit report
### Summary- Posts audited: [N] across [N] languages- Overall health: [score] / 100- Critical issues: [N]- Warnings: [N]
### Translation coverage[Matrix from Phase 2]
### Issues found#### Critical- [Issue with file references]
#### Warnings- [Issue with file references]
#### Passed- [Checks that passed]
### Prioritized fixes1. [Highest-impact action]2. [...]
### Stale-translation alerts[Runnable commands from Phase 6]
### Quick fixes- Run `/blog translate <file> --to <missing-langs>` for [N] missing translations.- Run `/blog multilingual` to regenerate hreflang assets.- Run `/blog localize <file> --locale <code>` for weak cultural adaptations.

## Multilingual content audit report
### Summary- Posts audited: [N] across [N] languages- Overall health: [score] / 100- Critical issues: [N]- Warnings: [N]
### Translation coverage[Matrix from Phase 2]
### Issues found#### Critical- [Issue with file references]
#### Warnings- [Issue with file references]
#### Passed- [Checks that passed]
### Prioritized fixes1. [Highest-impact action]2. [...]
### Stale-translation alerts[Runnable commands from Phase 6]
### Quick fixes- Run `/blog translate <file> --to <missing-langs>` for [N] missing translations.- Run `/blog multilingual` to regenerate hreflang assets.- Run `/blog localize <file> --locale <code>` for weak cultural adaptations.

Error Handling

Scenario	Action
Empty directory	"No blog posts found in [path]"
Only one language present	Report coverage, suggest target languages
No hreflang files	Flag as critical gap, offer regeneration
Unrecognized file format	Skip with a warning

Cross-References

Fill missing translations: /blog translate <file> --to <missing-codes>
Deepen weak adaptations: /blog localize <file> --locale <code>
Regenerate hreflang assets: /blog multilingual <topic> --languages <codes>

Source and attribution

Source:agricidaniel/claude-bloginbrain/.raw/sources/claude-blog-skill/skills/blog-locale-auditat commit2500d4c

License: MIT

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from agricidaniel/claude-blog

Blog Taxonomy

agricidaniel

Suggests, audits and syncs blog tags and categories across WordPress, Shopify, Ghost, Strapi and Sanity CMS platforms.

Marketing & Sales2.3Kupdated yesterday

Blog Cannibalization

agricidaniel

Detect keyword cannibalization across blog posts by extracting primary keywords from titles and headings, clustering semantically similar targets, and flagging posts competing for the same search intent. Supports local-only mode (grep-based) and DataForSEO API mode (Page Intersection endpoint at ~$0.01/call). Outputs severity-scored report with merge or differentiate recommendations. Use when user says "cannibalization", "keyword overlap", "competing pages", "duplicate keywords", "cannibalize".

Awaiting classification2.3Kupdated yesterday

Blog Rewrite

agricidaniel

Rewrites existing blog posts for Google SEO and AI citation visibility, replacing unsourced statistics and adding structured elements.

Marketing & Sales2.3Kupdated yesterday

Blog Translate

agricidaniel

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".

Awaiting classification2.3Kupdated yesterday

Blog Write

agricidaniel

Write new blog articles from scratch optimized for Google rankings and AI citations. Generates full articles with template selection, answer-first formatting, Key Takeaways summary box, information gain markers, citation capsules, sourced statistics, Pixabay/Unsplash images, built-in SVG chart generation, optional FAQ sections, internal linking zones, and proper heading hierarchy. Supports MDX, markdown, and HTML output. Use when user says "write blog", "new blog post", "create article", "write about", "draft blog", "generate blog post".

Awaiting classification2.3Kupdated yesterday

Blog Schema

agricidaniel

Generate complete JSON-LD schema markup for blog posts with Article/BlogPosting, Person, Organization, BreadcrumbList, ImageObject, and optional FAQPage. Validates against Google requirements and warns about deprecated types. Use when user says "schema", "blog schema", "json-ld", "structured data", "schema markup", "generate schema".

Awaiting classification2.3Kupdated yesterday

Blog Locale Audit

Blog Locale Audit, Multilingual Quality Control

Workflow

Phase 1: Discovery

Phase 2: Completeness Audit

Phase 3: Content Parity Audit

Phase 4: SEO Parity Audit

Phase 5: Hreflang Audit

Phase 6: Freshness Audit

Phase 7: Report

Error Handling

Cross-References

Source and attribution

More from agricidaniel/claude-blog

Blog Taxonomy

Blog Cannibalization

Blog Rewrite

Blog Translate

Blog Write

Blog Schema

More in Marketing & Sales

Deal Sourcing

Investment Proposal

Content Strategy

Call List

Lead Triage

Draft Outreach