CommunityCodierung & Entwicklunggithub.com

1203124102-oss/codex-pronunciation-strip

Füge einen kompakten, klickbaren Aussprache-Strip für 2-4 englische Wörter in eine Chat-Antwort ein und annotiere diese Wörter inline. Verwende dies, wenn der Benutzer nach Wortaussprache, Audio-Buttons oder Vokabelnotizen in einer Unterhaltung fragt; nicht zur Erstellung eigenständiger Audiodateien oder Webseiten.

Was ist codex-pronunciation-strip?

Dieses Skill ermöglicht es KI-Agenten (z. B. Claude Code, Cursor, Codex), interaktive Aussprache-Strips direkt in Chat-Antworten einzubetten. Es generiert einen einzeiligen Strip mit 2-4 Wort-Buttons, die bei Klick die browser-eigene Sprachsynthese nutzen, um die Aussprache abzuspielen – ohne externe Links, Downloads oder große Audio-Player. Der Skill kombiniert diese Strips mit inline-Vokabelannotationen, die farbiges KaTeX, IPA, Wortart und eine kurze Übersetzung in der Benutzersprache enthalten. Die Verwendung ist auf Chat-Kontexte zugeschnitten, in denen der Benutzer nach Wortaussprache fragt, und funktioniert plattformübergreifend durch Nutzung von Theme-Variablen und privaten Unicode-Zeichen für die Visualisierungsreferenz. Entwickler müssen nur ein Python-Skript aufrufen, das den HTML-Fragment generiert, und die Referenz in die Antwort einfügen – das Skill sorgt für Barrierefreiheit und konsistente Darstellung.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add 1203124102-oss/codex-pronunciation-strip

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Aussprache-Strip

Füge einen kleinen, einzeiligen Strip mit Wort-Buttons zu einer Chat-Antwort hinzu. Jeder Klick spricht das Wort mit der browser-eigenen Sprachsynthese aus, sodass nichts geöffnet, heruntergeladen oder die Unterhaltung verlassen wird. Kombiniere den Strip mit inline-Vokabelannotationen.

Arbeitsablauf

  1. Wähle 2-4 Wörter aus, die lehrreich sind: oberhalb des Lernniveaus, leicht zu verwechseln oder zentral für die Antwort. Vermeide es, bereits erklärte Wörter erneut zu annotieren.

  2. Annotiere jedes Wort innerhalb eines normalen Satzes, niemals als separate Liste. Verwende KaTeX mit farbigem Fettdruck, US-IPA, Wortart und einer kurzen Übersetzung in der Sprache des Benutzers. Wähle eine zufällige Farbe pro Wort aus einer kleinen barrierefreien Palette (#2563eb, #7c3aed, #059669, #b45309, #db2777, #0e7490); halte jedes Wort in einer einheitlichen Farbe und vermeide wiederholte Farben innerhalb einer Antwort. Dieser Client rendert nur $$...$$, also schreibe:

    Halte es kompakt ($$\textcolor{#7c3aed}{\textbf{compact}}$$ /kəmˈpækt/, Adj. kompakt)

  3. Erzeuge den Strip:

    python scripts/make_compact_strip.py --out <absoluter-pfad>.html wort1 wort2 ...
    

    Halte die Datei dauerhaft und leicht lesbar für den Client. Bevorzuge das Visualisierungsverzeichnis des Threads mit einem ASCII-Dateinamen, z. B. ~/.codex/visualizations/<datum>/<thread-id>/pron-<slug>.html.

  4. Das Skript gibt den Pfad und eine Visualisierungsreferenz aus. Setze diese Referenz wörtlich in eine eigene Zeile am Ende der endgültigen Antwort.

Rendering-Regel

Die Referenz ist in private-use Zeichen eingeschlossen: öffnend U+E200, Trennzeichen U+E202, schließend U+E201. Kopiere sie aus der Skriptausgabe. Wenn du sie neu tippst, verwende genau diese Codepunkte. Ein falsches schließendes Zeichen wie U+E041 verwandelt die gesamte Referenz stillschweigend in Klartext, sodass kein Strip erscheint.

Einschränkungen

  • Gib nur das HTML-Fragment aus. Füge kein <!doctype>, <html>, <head> oder <body> hinzu; halte CSS und JavaScript auf die generierte Root-ID beschränkt.
  • Halte den Strip auf 2-4 Buttons und eine Zeile, die nur bei Platzmangel umbricht.
  • Verlinke nicht auf externe Wörterbuch- oder TTS-Seiten und bette keine großen Audio-Player ein. Die Buttons müssen direkt abspielen.
  • Verwende die Theme-Variablen des Hosts (--foreground, --border, --primary, --accent, --ring, --primary-foreground) anstelle von fest codierten Paletten.
  • Wenn der Client keine Inline-Visualisierungen rendern kann, falle auf kompakte Sprecher-Links innerhalb des Satzes zurück: [🔊](https://dict.youdao.com/dictvoice?audio=<wort>&type=2).

Dateien

  • scripts/make_compact_strip.py — validiert 2-4 Wörter, schreibt das Fragment und gibt die Visualisierungsreferenz aus.
  • assets/strip-template.html — das Fragment-Template mit __ROOT_ID__ und __WORDS_JSON__ Platzhaltern.

Erfordert Python 3.8 oder neuer; keine Drittanbieterpakete.

Verwandte Skills