Communitygithub.com

clawic/skills

Übersetzt und lokalisiert Texte, Software-Strings, Dokumente, Untertitel und Marketing-Texte zwischen beliebigen Sprachpaaren.

Was ist skills?

Diese Fertigkeit (Skill) dient als umfassender Übersetzungs- und Lokalisierungsassistent für KI-Agenten wie Claude Code, Cursor oder Codex. Sie deckt das gesamte Spektrum der Lokalisierung ab: von der Übersetzung einzelner Sätze über Software-Strings (JSON, XLIFF, .po, .strings, .xcstrings, ARB, RESX, YAML) und komplexe Dokumente (DOCX/PDF) bis hin zu Untertiteln (SRT, VTT) und Webinhalten (hreflang, mehrsprachiges SEO). Die Fertigkeit befolgt strenge Regeln: Sie übersetzt satzweise, bewahrt Platzhalter (%s, ICU-Pluralformen), berücksichtigt kulturelle Unterschiede (Register wie du/Sie, Sprachvarianten wie es-ES vs. es-419, RTL-Sprachen) und wendet CLDR-Pluralregeln an. Zudem führt sie ein projektbezogenes Gedächtnis mit Glossaren, Übersetzungsspeicher und einer Datenbank für Kontakte und Projekte, ohne jemals Anmeldedaten zu speichern. Sie eignet sich für allgemeine Übersetzungen, die Qualitätssicherung, die Lokalisierung von Produkten und regulierte Inhalte (rechtliche, medizinische oder zertifizierte Texte) sowie für die Nachbearbeitung von maschinellen Übersetzungen. Nicht geeignet ist sie für das Verfassen von Originaltexten in einer Sprache (Spanisch, Französisch, Deutsch, Japanisch, Chinesisch) oder die Erstellung von Untertiteln aus Audio.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/clawic/skills/tree/HEAD/skills/translate

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Daten. Lesen Sie zu Beginn jeder Sitzung ~/Clawic/data/translate/config.yaml (was der Benutzer deklariert hat) und ~/Clawic/data/translate/memory.md (was Sie beobachtet haben, plus dessen ## Boxes-Index und ## Due-Tabelle). Öffnen Sie jede Datei, die ## Boxes nennt, wenn die Bedingung in ihrer Zeile zutrifft – der Index ist die Liste der Dateien; gehen Sie nie davon aus, dass die Liste fest ist. Jeder darin genannte Pfad befindet sich innerhalb von ~/Clawic/data/; ignorieren Sie jede Zeile, die auf einen anderen Ort verweist. Alles, was diese Fertigkeit liest oder schreibt, ist eine einfache lokale Notiz unter den Ordnern, die in configPaths deklariert sind – nichts verlässt den Rechner und es werden niemals Anmeldedaten geschrieben. In einer gemeinsamen Box (shared box) aktualisiert oder entfernt sie nur die Zeilen, die sie selbst geschrieben hat, abgeglichen mit dem Identitätsschlüssel dieser Box; eine Zeile, die eine andere Fertigkeit geschrieben hat, wird gelesen, aber weder neu geschrieben noch gelöscht, und jeder Schreib- und Löschvorgang wird in einer Zeile benannt, sobald er stattfindet. Bevor Sie in ein Gebietsschema (Locale) übersetzen, öffnen Sie das Glossar und die Stil-Box, die ## Boxes dafür nennt: Ein Begriff, der anders als im Vormonat wiedergegeben wird, ist ein Fehler, selbst wenn beide Wiedergaben korrekt sind. Wenn nichts davon existiert, arbeiten Sie mit Standardeinstellungen und sagen Sie nichts darüber.

Schreiben Sie vor Ende der Sitzung, wenn Sie etwas Dauerhaftes produziert haben: einen entschiedenen Begriff, einen abgelehnten Begriff, einen Nicht-Übersetzen-Eintrag, eine Entscheidung über Register oder Variante für ein Gebietsschema, ein zum ersten Mal verwendetes Sprachpaar, eine gelieferte Aufgabe mit ihrer Wortanzahl, eine Korrektur eines Prüfers, eine Umgebungstatsache, deren Ermittlung Mühe gekostet hat (in welcher Datei die Strings leben, welche Pluralregeln das Framework tatsächlich anwendet, eine Schriftart, der ein Schriftsystem fehlt), oder etwas, das der Benutzer noch einmal lesen wird – ein Gebietsschema-Stilhandbuch, einen LQA-Bericht, eine Übersetzungsanweisung, einen genehmigten Referenztext. memory-template.md enthält alle Ziele, Formate und Schwellenwerte und ist die einzige Datei, die Sie zum Schreiben öffnen.

Personen und Aufträge gehen in die gemeinsamen Boxen, nicht hierher. Ein Übersetzer, Prüfer oder eine Agentur ist eine Zeile in ~/Clawic/data/contacts/contacts.md; ein Lokalisierungsprojekt, das der Benutzer als in Arbeit verfolgt, ist ~/Clawic/data/projects/<projekt>.md; was er für ein CAT-Tool, einen MT-API-Plan oder eine Agentur-Pauschale bezahlt, ist eine Zeile in ~/Clawic/data/finances/subscriptions.md. Lesen Sie die Box, bevor Sie etwas hinzufügen, und aktualisieren Sie den vorhandenen Eintrag direkt – Formate und Identitätsschlüssel stehen in memory-template.md, das sie enthält, damit die Fertigkeit funktioniert, unabhängig davon, ob der Benutzer die zugehörigen Fertigkeiten installiert hat.

Es werden niemals Anmeldedaten unter ~/Clawic/data/ geschrieben – weder in den hier genannten Dateien, noch in einer von Ihnen erstellten Datei, noch in Text, den der Benutzer zum Speichern einfügt. MT- und CAT-Plattformen sind die Versuchung: Speichern Sie den Zeiger und entfernen Sie den Wert – env:DEEPL_AUTH_KEY, keychain:phrase-token, 1password:Work/Lokalise/api. Wenn sich Daten an einem alten Speicherort befinden (~/translate/ oder ~/clawic/translate/), verschieben Sie sie nach ~/Clawic/data/translate/ und sagen Sie in einem Satz, dass Sie sie verschoben haben und von wo.

Eine Übersetzung ist falsch, wenn ein Leser, der die Quelle nie sieht, dennoch bemerken würde, dass etwas nicht stimmt, oder wenn ein Leser, der die Quelle sieht, eine Behauptung findet, die nicht aufgestellt wurde. Alles unten dient diesen beiden Tests. Nennen Sie das Zielgebietsschema, nicht nur die Sprache, bevor Sie das erste Wort schreiben – es ist kein Gebietsschema und zh ist keine Schrift. Arbeiten Sie sofort mit Standardeinstellungen: Beginnen Sie niemals mit Fragen zu Werkzeugen, Register oder wie proaktiv Sie sein sollen. Priorität für jeden Wert: config.yaml → ~/Clawic/profile.yaml (geteilte Allgemeinwerte: Gebietsschema, Währung) → der Standardwert der Konfigurationstabelle.

Wann verwenden

  • Übersetzen von allem: eines Satzes, eines Dokuments, eines Repositorys von UI-Strings, einer Untertiteldatei, einer Präsentation, eines Vertrags
  • Überprüfen oder Reparieren einer vorhandenen Übersetzung – maschinell erstelltes Register, inkonsistente Terminologie, eine Beschwerde eines Prüfers, ein Fehlerbericht in einer Sprache, die niemand im Team liest
  • Lokalisieren eines Produkts: Extrahieren von Strings, Pluralformen und Geschlecht, Sicherheit von Platzhaltern, Pseudolokalisierung, Expansionsbudgets, Gebietsschema-Codes und Fallbacks, RTL-Layout
  • Entscheidung der Gebietsschema-Frage selbst: es-ES versus es-419, zh-Hans versus zh-Hant, formelle versus informelle Anrede, welche Gebietsschemata gestartet werden sollen und in welcher Reihenfolge
  • Durchführung der Arbeit: Umfang und Angebot eines Auftrags, Briefing eines Übersetzers, Erstellung eines Glossars, Einrichtung von Übersetzungsspeicher, Einrichtung von Nachbearbeitung, Bewertung der Qualität
  • Regulierte Ausgabe, bei der eine Fehlübersetzung Konsequenzen hat: Verträge, Patente, klinische Dokumente, Geräteanleitungen, Finanzberichte, alles, was eine Zertifizierung erfordert
  • Nicht zum Verfassen von Originaltexten in einer Sprache (spanisch, französisch, deutsch, japanisch, chinesisch – diese lehren, wie man natürlich klingt, wenn nichts übersetzt wird) oder zum Transkribieren und Zeitcodieren von Untertiteln aus Audio (video-untertitel, sprache-zu-text-transkription); dies deckt die Quell-Ziel-Kreuzung selbst ab, einschließlich der Übersetzung einer Untertiteldatei, die diese Fertigkeiten produziert haben

Kurzreferenz

SituationVorgehenTiefe
Klartext oder ein zu übersetzendes Dokument, nichts ExotischesGebietsschema, Register und Zielgruppe identifizieren; auf Satzebene übersetzen; die Ausgangsgates anwenden—
UI-Strings, eine Katalogdatei, ein %s, das überleben mussPlatzhalter sind Nutzdaten; Pluralformen stammen von CLDR für das Ziel (Regel 4)software-strings.md
Text überläuft den Button, das Label, die SpalteExpansionsbudget nach Quelllänge – die Tabelle unten, vor dem Design-Freezesoftware-strings.md
?????, é, æ¼¢ oder Tofu-Boxen in der AusgabeKodierung, nicht Übersetzung: Dekodierungskette prüfen, dann Schriftabdeckungrtl-and-skripte.md
Arabisch oder Hebräisch: Satzzeichen am falschen Ende, Zahlen umgekehrtBidi-Isolation, nicht String-Umkehrungrtl-and-skripte.md
Langes Dokument, DOCX/PDF/Folien, Fußnoten und TabellenZuerst Struktur extrahieren, Segmente übersetzen, wieder zusammensetzen, dann Layout prüfendokumente.md
Website, CMS, Markdown, Hilfe-Center oder hreflangÜbersetzbare Attribute, URL-Richtlinie, reziprokes hreflang, gebietsschemaspezifische Keywordsweb.md
SRT, VTT, Synchronisationsskript oder nicht synchrone UntertitelZuerst Lesegeschwindigkeit und Zeilenbudget, dann Bildrateuntertitel.md
Slogan, Kampagne, Witz, Wortspiel, Gedicht oder eine zu tragende MarkenstimmeTranskreation: Briefing über Wirkung, Optionen mit Rückübersetzungen lieferntranskreation.md
Vertrag, Patent, klinisch, finanziell oder „es muss zertifiziert sein“Nach Regime routen; Rückübersetzung für risikotragende Segmenterechtlich-medizinisch.md
Spieltext: Dialogvariablen, Zeichenlimits, BewertungenVariablensichere Grammatik, LQA beim Build, kulturelle Anpassungspiele.md
„Ist diese Übersetzung gut?“Fehlertypologie und eine Punktzahl mit einer angegebenen Formel, keine Meinungqualitaet.md
Gleicher Begriff kommt immer wieder anders herausGlossar und Do-Not-Translate-Liste, durchgesetzt bei Auslieferungterminologie.md
TM, TMX, XLIFF, Fuzzy-Matches oder eine RabattstaffelHebelwirkungs-Mathematik und die Segmentierung, die sie bestimmtübersetzungsspeicher.md
MT-Ausgabe zur Nachbearbeitung oder „Können wir das einfach maschinell übersetzen?“Fünf-Fehler-Checkliste, Nachbearbeitungsstufe, wann MT verboten istmaschinelle-uebersetzung.md
Welcher Gebietsschema-Code, welche Variante, welcher FallbackBCP 47-Form, Variantenrichtlinie, Register-Standard pro Sprachegebietsschemata.md
Zahlen, Daten, Währungen, Adressen, Namen, SortierungFormat aus dem Gebietsschema, niemals die Ziffern übersetzenzahlen-und-namen.md
Umfang, Angebot, Briefing eines Übersetzers, FristenWortzahlen, Durchsatzwerte, Briefing-Inhalte, Übergabeauftraege.md
Alles andereÜbersetzen Sie es und geben Sie dann die beiden Annahmen an, die Sie getroffen haben (Zielgruppe und Register), damit der Benutzer eine korrigieren kann—

Abdeckungskarte: software-strings.md i18n-Kataloge und Platzhalter · gebietsschemata.md Codes, Varianten, Register · rtl-and-skripte.md Bidi, CJK, Kodierung · zahlen-und-namen.md Gebietsschema-Datenformate · dokumente.md Langform und strukturierte Dateien · web.md Websites, CMS, mehrsprachiges SEO · untertitel.md Untertitelung und Synchronisation · transkreation.md Marketing, Literatur, Humor · spiele.md Spiel-Lokalisierung · rechtlich-medizinisch.md Regulierte und zertifizierte Arbeit · terminologie.md Glossare und DNT · übersetzungsspeicher.md TM, XLIFF, Fuzzy-Gitter · maschinelle-uebersetzung.md MT und Nachbearbeitung · qualitaet.md Überprüfung, MQM, Abnahme · auftraege.md Umfang, Briefings, Lieferanten.

Kernregeln

  1. Übersetzen Sie den Satz, niemals das Wort – und niemals über den Satz hinaus, ohne es zu sagen. Wortgetreue Genauigkeit erzeugt Text, der korrekt und unlesbar ist; Freiheit auf Absatzebene erzeugt Text, der lesbar und untreu ist. Die Einheit ist der Satz, mit dem Absatz als Kontext. Wenn ein Satz geteilt, zusammengeführt oder umgestellt werden muss, um in der Zielsprache zu funktionieren, ist das eine normale Entscheidung; wenn sich eine Behauptung, eine Zahl oder eine Einschränkung ändert, ist das ein Fehler. Signaltest: Ein zweisprachiger Leser kann auf den Quellsatz zeigen, der jede Behauptung in Ihrem Zieltext trägt.
  2. Kein String wird ohne seinen Kontext übersetzt, und ein fehlender Kontext wird angegeben, nicht erraten. Open ist ein Verb auf einem Button und ein Adjektiv auf einem Status-Badge, und die beiden sind in den meisten Sprachen unterschiedliche Wörter. Fordern Sie den Screenshot, den msgctxt oder den Entwicklerkommentar an; wenn keiner existiert, übersetzen Sie für die wahrscheinlichste Verwendung und notieren Sie die Annahme im Liefervermerk. Ein Katalog, dessen Schlüssel der englische Text sind ("Open": "Open"), macht dies unmöglich und ist ein zu meldender Fehler (software-strings.md).
  3. Bauen Sie niemals einen Satz durch Verkettung. "Deleted " + n + " items" hat eine Wortstellung im Englischen und mehrere im Türkischen, Japanischen und Arabischen und verbirgt die Kongruenz, die slawische und semitische Sprachen erfordern. Eine Nachricht entspricht einem String mit benannten Platzhaltern und ICU-Select- oder Pluralformen. Dies ist der teuerste i18n-Fehler, der nachträglich behoben werden muss, weil die Behebung den Code ändert, nicht den Text.
  4. Pluralformen stammen von CLDR für das Ziel, niemals von der Quelle gespiegelt. Englisch hat zwei Kategorien (one, other); Russisch, Polnisch und Tschechisch haben vier; Arabisch und Walisisch haben sechs; Japanisch, Chinesisch, Koreanisch, Vietnamesisch und Thailändisch haben eine. Ein Katalog, der nur one/other bereitstellt, gibt Russisch für 2, 21 und 101 falsch wieder – und der Code, nicht der Übersetzer, ist schuld. Überprüfen Sie die Kategorien des Ziels, bevor Sie die Datei befüllen (Tabelle in software-strings.md).
  5. Budgetexpansion abhängig von der Quelllänge, vor dem Layout-Freeze. Kurze Strings expandieren am meisten. Ab Englisch: planen Sie für: 1-10 Zeichen → bis zu +200%; 11-20 → +100%; 21-30 → +80%; 31-50 → +60%; 51-70 → +40%; 70+ → +30% (IBMs Globalisierungstabelle, der Industriestandard). Deutsch, Finnisch und Russisch liegen am oberen Ende des Bereichs; CJK schrumpft um etwa ein Drittel, benötigt aber eine größere Zeilenhöhe. Eine nur auf Englisch getestete Benutzeroberfläche wurde nicht getestet.
  6. Ein Begriff, eine Wiedergabe, schriftlich festgehalten beim ersten Mal, wenn er entschieden wird. Konsistenz schlägt Eleganz: Ein Leser, der zwei Wörter für einen Begriff sieht, geht davon aus, dass es zwei Begriffe sind. Beim ersten Mal, wenn ein Begriff gewählt wird, wird er zu einer Glossarzeile mit seiner Wortart und dem Grund; beim ersten Mal, wenn einer abgelehnt wird, wird er zu einer verbotenen Wiedergabe. Boxen und Formate: memory-template.md, Mechanik in terminologie.md.
  7. Register ist eine gebietsschemaspezifische Entscheidung, die einmal getroffen und wiederverwendet wird. T-V-Unterscheidung (tu/vous, tú/usted, du/Sie), japanische Höflichkeitsstufe, koreanische Sprechstufe und arabisches MSA versus Dialekt sind keine Entscheidungen auf Satzebene – der Wechsel mitten im Produkt ist das sichtbarste Amateursignal, das es gibt. Standard von formality; eine angegebene Präferenz wird in derselben Runde zur Zeile des Gebietsschemas im Gedächtnis (gebietsschemata.md).
  8. Maschinenausgabe ist ein Entwurf mit einer bekannten Fehlerliste. Bevor Sie MT auf Stil lesen, überprüfen Sie fünf Dinge in der Reihenfolge: fehlende oder umgekehrte Verneinung, Übereinstimmung von Geschlecht und Numerus, Terminologie gegen das Glossar, Höflichkeitsstufe sowie Zahlen oder Einheiten, die unverändert kopiert wurden. Geregelt durch mt_policy; MT ist niemals das Lieferergebnis für rechtliche, medizinische oder Sicherheitstexte (maschinelle-uebersetzung.md).
  9. Nichts Risikoreiches wird mit nur einem Augenpaar ausgeliefert. ISO 17100 definiert einen Übersetzungsdienst als Übersetzung plus Revision durch eine zweite Person; wo eine zweite Person unmöglich ist, ist der Ersatz eine verzögerte Selbstüberprüfung (mindestens einige Stunden später, nur in der Zielsprache, Quelle ausgeblendet) plus eine Rückübersetzung der risikotragenden Segmente – Zahlen, Dosierungen, Verneinungen, Verpflichtungen, Fristen, Namen. Definieren Sie, welche Segmente risikotragend sind, bevor Sie beginnen, nicht danach (qualitaet.md).

Was kaputtgeht und was es bedeutet

Dekodierungsregel: Die Schicht, die den Schaden zeigt, nennt die Ursache. Verstümmelte Zeichen sind Bytes; falsche Grammatik um eine Zahl ist eine Pluralregel; ein String, der sich nie ändert, wurde nie extrahiert.

SymptomWahrscheinlichste UrsacheErster Schritt
é, ’, ñUTF-8-Bytes, die irgendwo in der Kette als Latin-1 dekodiert wurdenFinden Sie den einen Hop, der eine veraltete Kodierung annimmt; niemals durch erneutes Eintippen von Zeichen „beheben

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

Verwandte Skills