CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

blog-localize

Deep cultural adaptation of an already translated blog post for one target market: local examples, CTAs, legal references, statistic sources, and formality (Sie/du, tu/vous). Built-in profiles for DACH, Francophone, Hispanic, and Japanese markets. Use when the user says "localize blog", "cultural adaptation", "adapt for Germany", "lokalisieren", "localiser", "adaptar" and a translation already exists. Not for translating (use blog-translate), auditing a folder of translations (use blog-locale-audit), or the full write-translate-localize pipeline (use blog-multilingual).

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, largely actionable phased workflow with strong validation and feedback loops, path-safety rules, and an untrusted-data contract. Main deductions are the duplicated substitution table, a few abstract adaptation directives, and heavy inline detail (delivery contract) in a bundle with no reference files of its own.

Suggestions

Remove the §3f quick-map table (or reduce it to two illustrative rows with a pointer) since it duplicates the substitution tables in ../blog-translate/references/cultural-adaptation.md that the body itself says not to duplicate.

Add one concrete before/after example to §3c (e.g., an aggressive US CTA and its informational DACH rewrite) so 'use culturally appropriate action verbs' and 'adapt urgency framing' are actionable without loading the external profile.

Move the ~60-line standalone delivery-contract procedure (steps 2 in Phase 5) into a bundled reference file with a short summary and gate list in SKILL.md, which would also give this skill its own reference layer.

DimensionReasoningScore

Conciseness

The body is dense operational guidance (audit table, locale parsing rules, SSRF policy, delivery gates) with almost no explanation of concepts Claude already knows. Not 5: the §3f quick-map table ('Walmart | MediaMarkt | Carrefour ...') duplicates the shared 'cultural-adaptation.md' substitution tables despite 'Do not duplicate this file', and the ~60-line delivery-contract subsection could be tightened or moved to a reference.

4 / 5

Actionability

Most guidance is executable: exact commands ('python3 "$BLOG_SCRIPT_DIR/blog_render.py" --md <localized-file> --out-dir <locale-delivery-dir>', 'blog_preflight.py --strict --slug <localized-slug>'), concrete gates ('Require 90+/100, zero P0'), output naming ('{slug}-localized.{ext}'), and an error-handling table with specific actions. Not 5: a few §3c/3d directives are high-level without inline examples ('Use culturally appropriate action verbs', 'Adapt urgency framing', 'Match local content-style conventions') and fully depend on a referenced profile file not present in this bundle.

4 / 5

Workflow Clarity

Five clearly sequenced phases with explicit validation: Phase 4 is a verification checklist, and the delivery contract defines a feedback loop — 'After ANY later change to the file, hero, HTML, or PDF, re-render, re-init the nonce, and re-review (max 3 iterations). On failure, retain the file as draft-blocked'. Writes are protected by path checks, timestamped backups before overwrite, and preflight gates.

5 / 5

Progressive Disclosure

References are clearly signaled and one level deep ('${CLAUDE_SKILL_DIR}/../blog-translate/references/cultural-adaptation.md, the shared cultural profiles file ... Do not duplicate this file', plus 'Read the main reference orchestration-details.md before loading project context'). Not 5: this bundle ships no references/ or scripts/ files of its own, the body inlines substantial content (the §3f substitution table and the long delivery-contract procedure) that belongs in a separate reference, and none of the referenced external files can be verified from the bundle.

4 / 5

Total

17

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete capability enumeration, multilingual trigger phrases with an explicit precondition, and explicit negative boundaries against all three sibling skills. Third-person voice throughout, with no fluff or over-claims.

DimensionReasoningScore

Specificity

The description enumerates concrete capability areas — 'local examples, CTAs, legal references, statistic sources, and formality (Sie/du, tu/vous)' — plus 'Built-in profiles for DACH, Francophone, Hispanic, and Japanese markets', giving comprehensive, non-abstract coverage of what the skill does. Not 4: no meaningful gaps remain in the 'what' for this skill's scope; it lists five specific adaptation domains rather than 'several with minor gaps'.

5 / 5

Completeness

It answers both questions explicitly: 'what' via the enumerated adaptation domains, and 'when' via 'Use when the user says ... and a translation already exists', including the precondition that a translation already exists. Not 4: the 'when' clause is fully explicit with concrete trigger phrases and a stated precondition, not merely present-but-imprecise.

5 / 5

Trigger Term Quality

Triggers include natural English phrases ('localize blog', 'cultural adaptation', 'adapt for Germany') plus target-market-language synonyms ('lokalisieren', 'localiser', 'adaptar'), matching how users in each supported market would actually phrase the request. Not 4: it goes beyond 'a few natural terms missing' by covering synonyms across all four supported market languages, not just English variants.

5 / 5

Distinctiveness Conflict Risk

Negative boundaries name each adjacent skill — 'Not for translating (use blog-translate), auditing a folder of translations (use blog-locale-audit), or the full write-translate-localize pipeline (use blog-multilingual)' — and triggers are distinct from translation triggers. Not 4: conflict risk is actively minimized by explicit disambiguation against every sibling skill, not just 'minor overlap risk'.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

AgriciDaniel/claude-blog

Path

skills/blog-localize/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.