Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Bilingual-Doc-Sync — parallele Sprachfassungen synchron halten · ellmos-ai | DecimalAI

documentationby ellmos-ai

Bilingual-Doc-Sync — parallele Sprachfassungen synchron halten

ellmos-ai/bilingual-doc-sync

Source ellmos-ai/skills ↗License MIT

Parallel geführte Sprachfassungen eines Dokuments (Paper DE/EN, README + README_de, SKILL.md + SKILL.en.md, Website-Texte) synchron halten: fehlende Fassung nachziehen, Abschnitts-Parallelität prüfen, Divergenzen beheben — mit klarer Leitsprache-Regel und kontrolliertem Rücktransfer, wenn die Nebenfassung etwas besser löst. Nutze diesen Skill bei „sind DE und EN synchron?", „zieh die englische/deutsche Version nach", „Übersetzung ist veraltet", bei zweisprachigen Papers/READMEs/Skills, oder als

SkillScore87Maintained

Automatic

Translation & Localization pack

Last verified 8/6/2026

What it changes

Passed 20 of 23 test cases with the skill, and 12 of 23 without it.

Without skill52%

With skill87%

Checks it passed that the model alone missed

records which divergences were resolved in the sync entry
provides refactoring recommendations for developer_guide.md
records whether any back-transfers occurred in the sync entry

and 7 more in the full report

8 fixed12 passed either way3 still failing0 broke

Pass-rate lift: +35 pp
Tokens: +76%
Agent turns: 0%
Response time: -24%

Model gemini-3.6-flashMeasured 8/6/2026v120 of 23 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/ellmos-ai-bilingual-doc-sync/SKILL.md https://app.decimal.ai/s/ellmos-ai-bilingual-doc-sync/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add ellmos-ai-bilingual-doc-sync, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/ellmos-ai-bilingual-doc-sync/ and pins it in .decimal/skills.lock

decimalai skills add ellmos-ai-bilingual-doc-sync

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/ellmos-ai-bilingual-doc-sync/SKILL.md https://app.decimal.ai/s/ellmos-ai-bilingual-doc-sync/SKILL.md

Raw file: /s/ellmos-ai-bilingual-doc-sync/SKILL.md ↗ · machine-readable summary at /s/ellmos-ai-bilingual-doc-sync.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 8 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 8

Prompt

Two authors are editing `product_roadmap.md` and `product_roadmap.de.md` concurrently without a designated master document. Every time a discrepancy arises, they debate each point individually. What rule must be established before running the synchronization process?

What was checked, without and with the skill
Checked	Without skill	With skill
requires designating a leading language before starting the synchronization process	Missed	Passed

case-19 · gemini-3.6-flash · 8/6/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md112 linessingle file

Zweck

Zweisprachig geführte Dokumente divergieren schleichend: Die aktiv bearbeitete Fassung wächst, die andere veraltet — bis „Übersetzung" nur noch dem Namen nach stimmt. Dieser Skill macht die Synchronprüfung zu einem definierten Ablauf mit einer entscheidenden Vorab-Festlegung: Welche Fassung führt? Ohne Leitsprache-Regel wird jede Divergenz zur Einzelfallentscheidung und der Abgleich unwiederholbar.

Ablauf

1. Bestand feststellen

Liegen beide (alle) Sprachfassungen vor? Fehlt eine ganz → nachziehen (vollständige Übersetzung der führenden Fassung, nicht Neudichtung).
Namenskonvention prüfen (z. B. DOKUMENT.md + DOKUMENT.en.md oder _de/_en-Suffixe) und Abweichler angleichen — Auffindbarkeit ist die halbe Synchronität.

2. Leitsprache klären (vor jedem Abgleich)

Die Leitsprache ist die Fassung, in der inhaltlich gearbeitet wird (bei Papers oft EN, bei lokaler Doku oft die Muttersprache). Sie gewinnt bei Widerspruch.
Rücktransfer-Ausnahme: Löst die Nebenfassung etwas nachweislich besser (klarere Formulierung, korrigierter Fehler), wird es in die Leitfassung ÜBERNOMMEN — erst rücktransferieren, dann normal synchronisieren. Fachliche Korrektheit prüfen, bevor eine „schönere" Formulierung übernommen wird.

3. Parallelität prüfen

Struktur zuerst, dann Inhalt:

Gliederungsvergleich: Abschnitte/Überschriften beider Fassungen nebeneinander — fehlende, zusätzliche, umsortierte Abschnitte sind die groben Divergenzen.
Abschnittsweise Stichprobe der übereinstimmenden Gliederung: Aussagen, Zahlen, Verweise, Beispiele identisch? Besonders divergenzanfällig: Changelogs, Tabellen, Zahlenwerte, Literatur-/Linkverzeichnisse, zuletzt bearbeitete Abschnitte.
Nicht übersetzbare Invarianten prüfen: Code-Blöcke, Identifier, Formeln, Pfade müssen in beiden Fassungen IDENTISCH sein (Code wird nie übersetzt).

Track record

Benchmark

20 / 23

test cases passed, vs 12 / 23 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/2/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

ellmos-ai / skills

skills/dev/bilingual-doc-sync/SKILL.md

View on GitHub ↗

License MITImported 8/24/2026Version v1

More skills from the same source and nearby in the registry, with their headline benchmark lift.