# Bilingual Doc Sync > > - **Type:** Skill - **Install:** `agentstack add skill-ellmos-ai-skills-bilingual-doc-sync` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [ellmos-ai](https://agentstack.voostack.com/s/ellmos-ai) - **Installs:** 0 - **Category:** [Databases](https://agentstack.voostack.com/c/databases) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [ellmos-ai](https://github.com/ellmos-ai) - **Source:** https://github.com/ellmos-ai/skills/tree/master/skills/utilities/bilingual-doc-sync - **Website:** https://github.com/ellmos-ai/skills#readme ## Install ```sh agentstack add skill-ellmos-ai-skills-bilingual-doc-sync ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Bilingual-Doc-Sync — parallele Sprachfassungen synchron halten ## 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: 1. **Gliederungsvergleich:** Abschnitte/Überschriften beider Fassungen nebeneinander — fehlende, zusätzliche, umsortierte Abschnitte sind die groben Divergenzen. 2. **Abschnittsweise Stichprobe** der übereinstimmenden Gliederung: Aussagen, Zahlen, Verweise, Beispiele identisch? Besonders divergenzanfällig: Changelogs, Tabellen, Zahlenwerte, Literatur-/Linkverzeichnisse, zuletzt bearbeitete Abschnitte. 3. **Nicht übersetzbare Invarianten** prüfen: Code-Blöcke, Identifier, Formeln, Pfade müssen in beiden Fassungen IDENTISCH sein (Code wird nie übersetzt). ### 4. Beheben - Divergenzen in Richtung Leitsprache auflösen (bzw. nach Rücktransfer). - Sprachtypografie der Zielsprache respektieren (im Deutschen echte Umlaute ä ö ü ß, keine ae/oe/ue-Ersatzschreibung; Anführungszeichen-Konventionen). - Metadaten nachziehen: Versionsnummern, Datumsfelder, Changelog-Einträge in BEIDEN Fassungen (der Changelog selbst ist der häufigste Divergenzpunkt). ### 5. Dokumentieren Ergebnis festhalten (was war divergent, was wurde übernommen, was rücktransferiert). Als periodischer Lauf über einen Bestand: mit dem Rotations-Gerüst kombinieren (`rotation-check`) — ein Dokument(-Paar) pro Lauf, Registry als Gedächtnis. ## Erweiterung: Expansions-Audit (sollten MEHR Sprachen existieren?) Neben dem Synchronhalten bestehender Fassungen gehört zur Sprachpflege die Frage, ob ein Dokument/Projekt WEITERE Sprachen verdient: 1. **Eignung bewerten** statt blind übersetzen: Zielgruppe, internationale Nutzbarkeit, Store-/Web-Präsenz, Mobilität des Inhalts. Nicht jedes interne Dokument braucht Englisch; nicht jede App braucht fünf Sprachen. 2. **Technische Vorbereitung prüfen:** Ist das Ziel überhaupt auf Sprachdateien/Parallel- Fassungen vorbereitet (i18n-Struktur, Namenskonvention)? Wenn nein, ist DAS die erste Aufgabe, nicht die Übersetzung. 3. **Befund dokumentieren, nicht sofort massenübersetzen:** Konkrete Übersetzungsaufgaben in die projektlokale TODO-Datei; „keine weitere Sprache sinnvoll" ist ein gültiges, festzuhaltendes Ergebnis. 4. **QA bei nachgezogenen Fassungen:** Auto-generierte Übersetzungen stichprobenartig gegen die Leitfassung prüfen (Abschnitt 3), bevor sie als „vorhanden" gelten. ## Beispiel ```text Auftrag: „Prüf, ob das Paper in DE und EN synchron ist." 1. Bestand: paper_en.tex (führend) + paper_de.tex vorhanden. 2. Gliederung: DE fehlt der neue Abschnitt 4.2 (letzte EN-Revision); DE hat einen besseren Beweis-Absatz in 3.1. 3. Rücktransfer: 3.1-Formulierung fachlich geprüft → in EN übernommen. 4. Nachziehen: 4.2 nach DE übersetzt; Zahlen in Tabelle 2 abgeglichen (DE hatte veraltete Werte); Literaturverzeichnis identisch gemacht. 5. Registry-Eintrag: „paper-X | 2026-07-03 | de-en-sync | 3 Divergenzen behoben, 1 Rücktransfer | nächster Check nach nächster EN-Revision". ``` ## Red Flags | Gedanke | Realität | | --- | --- | | „Ich übersetze die Unterschiede einfach frisch" | Erst Leitsprache + Rücktransfer-Frage klären — sonst wird die bessere Lösung überschrieben. | | „Die Gliederung passt, also ist es synchron" | Zahlen, Changelogs und Verweise divergieren zuerst — Stichprobe in die Tiefe ist Pflicht. | | „Code-Kommentare übersetze ich mit" | Code-Blöcke und Identifier bleiben in beiden Fassungen identisch (englisch). | | „Ich synchronisiere alle Dokumente in einem Rutsch" | Ein Paar pro Lauf (Rotations-Gerüst) hält den Abgleich prüfbar. | ## Verwandte Skills - `rotation-check` — Gerüst für den periodischen Lauf über einen Dokumentbestand. - `workflow-extract` — wenn dieser Check als stehende Automation eingerichtet werden soll. ## Changelog ### 1.1.0 (2026-07-03) - Expansions-Audit ergänzt (i18n-Eignung bewerten, technische Vorbereitung, QA für nachgezogene Fassungen) — integriert statt als eigener i18n-coverage-audit-Skill (Dedup-Entscheid). ### 1.0.0 (2026-07-03) - Initiale Version. Abstrahiert aus der Codex-Automation „research-paper-de-en-synchronisationscheck", verallgemeinert auf beliebige parallel geführte Sprachfassungen (Papers, READMEs, Skills, Website-Texte). ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [ellmos-ai](https://github.com/ellmos-ai) - **Source:** [ellmos-ai/skills](https://github.com/ellmos-ai/skills) - **License:** MIT - **Homepage:** https://github.com/ellmos-ai/skills#readme Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-ellmos-ai-skills-bilingual-doc-sync - Seller: https://agentstack.voostack.com/s/ellmos-ai - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.