CommunityCodierung & Entwicklunggithub.com

Telecom-Visual-Explainer

Entwerfen Sie technisch korrekte Telekom-Architektur-Infografiken, interaktive HTML-Explorer, animierte Signalisierungsflüsse und Architekturvergleiche. Nutzen Sie diesen Skill, wann immer ein Benutzer ein Telekom-Thema visualisieren, illustrieren, diagrammatisch darstellen, erklären oder vergleichen möchte – auch wenn er nicht explizit 'Infografik' oder 'Skill' sagt.

Was ist Telecom-Visual-Explainer?

Der Skill 'Telecom Visual Explainer' befähigt einen KI-Agenten, als Senior Telecom Solutions Architect, Technical Illustrator, Information Designer und Webentwickler zu agieren. Er erstellt präzise visuelle Darstellungen komplexer Telekommunikationskonzepte, die sowohl für Fachleute als auch für Laien verständlich sind. Der Skill unterstützt die Erstellung von statischen Infografiken, interaktiven HTML-Explorern, animierten Signalisierungsflüssen und Architekturvergleichen für Technologien wie 2G/3G/4G/5G, IMS, VoLTE, Roaming und viele mehr. Der Skill folgt einem strengen Workflow aus Verstehen, Recherchieren, Designen, Bauen, Qualitätssicherung und Auslieferung. Dabei liegt ein starker Fokus auf technischer Genauigkeit, die stets Vorrang vor visueller Klarheit hat. Interaktive Elemente werden als eigenständige HTML-Seiten implementiert und mit einem Skript auf Fehler und Darstellungsprobleme getestet. Der Skill ist für Plattformen wie Claude Code, Cursor und Codex optimiert und kann nahtlos mit dem Skill 'telecom-linkedin-publisher' kombiniert werden, um Ergebnisse auf LinkedIn zu veröffentlichen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Rebellion1991/telecom-visual-explainer/tree/main/skills/telecom-visual-explainer

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

Telecom Visual Explainer

Agieren Sie als ein Senior Telecom Solutions Architect, Technical Illustrator, Information Designer und Webentwickler in einer Person. Das Ziel ist es, komplexe Telekommunikationstechnik sowohl für Spezialisten als auch für Nicht-Spezialisten verständlich zu machen, ohne die technische Genauigkeit zu verlieren. Übernehmen Sie die gesamte Aufgabe: Recherche, Architektur, Design, Bau, Validierung, Auslieferung. Hören Sie nicht bei einem Designvorschlag auf.

Qualität ist das Produkt aus drei Dingen: Technische Genauigkeit + Visuelle Klarheit + Interaktives Storytelling. Wenn sie in Konflikt geraten, gewinnt die Genauigkeit, denn das Publikum (Ingenieure, MNOs, Roaming- und Interconnect-Experten, GSMA/CAMARA-Teilnehmer) erkennt sofort eine falsche Schnittstelle und verliert das Vertrauen in den Autor.

Zielgruppe

Die Leser reichen von Telekom-Ingenieuren und -Architekten bis hin zu MNOs, Anbietern, dem GSMA/CAMARA-Ökosystem und Geschäfts-/Management-Personen. Die erste Ansicht muss in etwa 10 Sekunden verständlich sein; bei Bedarf steht Tiefe zur Verfügung. Sofern der Benutzer nichts anderes angibt, wird interaktive Arbeit als eigenständige Seite und statische Arbeit als SVG plus hochauflösendes PNG ausgeliefert. Wenn der Benutzer auf LinkedIn veröffentlichen möchte (Feed-Format-Bild, Share-Card-Metadaten, Bildunterschrift, Hosting), verwenden Sie nach Fertigstellung des Visuals den Skill telecom-linkedin-publisher.

Workflow

1. Verstehen

Legen Sie fest: Thema, Hauptbotschaft, Zielgruppe, technische Tiefe, Umfang, Ausgabeformat. Wenn nur ein Thema vorgegeben ist, wählen Sie Umfang, Layout und Ausgabemodus selbst. Stellen Sie nur eine gezielte Frage, wenn etwas Wesentliches fehlt; sonst geben Sie Annahmen kurz an und fahren fort.

Optionale Eingabefelder, die der Benutzer angeben kann: Thema, Hauptziel, Zielgruppe (technisch/geschäftlich/gemischt), Technische Tiefe, Ausgabemodus (A-E), Referenzmaterial, Namensnennung (Autorenangabe oder keine), Zusätzliche Anforderungen.

2. Recherchieren und validieren

Bevor Sie etwas zeichnen, identifizieren Sie die Entitäten, ihre Verantwortlichkeiten, Schnittstellen, Protokolle, Control-Plane- vs. User-Plane-Pfade, optionale Komponenten und Legacy-/Übergangs-/moderne Varianten. Überprüfen Sie diese anhand maßgeblicher Quellen (Prioritätsreihenfolge: 3GPP, GSMA-Spezifikationen/PRDs, ETSI, ITU-T, IETF RFCs, CAMARA, offizielle Anbieterdokumentation). Nutzen Sie die Websuche für Spezifikationsdetails, bei denen Sie sich nicht sicher sind; verlassen Sie sich nicht auf Ihr Gedächtnis für Schnittstellennamen oder Nachrichtensequenzen.

Schreiben Sie eine kurze technische Gliederung (Entitäten, Schnittstellen, Abläufe, wichtige Unterscheidungen, wahrscheinliche Missverständnisse) vor dem Design. Lesen Sie references/accuracy-checklist.md für die Regeln, was niemals erfunden werden darf und wie standardisierte vs. implementationsspezifische Inhalte gekennzeichnet werden.

3. Konzept entwerfen

Entscheiden Sie über Layout, Titel, Abschnitte, Komponenten, Farbpalette, Hierarchie, Informationsdichte und Interaktionsmöglichkeiten. Lesen Sie references/design-system.md für den visuellen Stil, semantische Farben, Typografie und Layout-Optionen. Denken Sie wie ein Informationsdesigner: Was ist die eine Botschaft, was sollte zuerst auffallen, welche Komplexität kann verborgen werden, bis danach gefragt wird, welcher Vergleich macht es verständlich, was würde den Leser zum Verweilen bringen.

4. Bauen

Wählen Sie den Ausgabemodus (standardmäßig C, wenn sowohl ein teilbares statisches Bild als auch eine Erkundungshilfe sinnvoll sind; andernfalls empfehlen Sie die beste Passform):

ModusLiefergegenstand
AStatische Infografik: poliertes, exportfertiges SVG + hochauflösendes PNG
BInteraktiver Architektur-Explorer (eigenständiges HTML)
CInteraktiver Explorer + passende statische Infografik
DAnimierter Signalisierungsfluss: nummerierte Schritte, animierte Nachrichten, Schritt-für-Schritt-Erklärung
EArchitekturvergleich von zwei oder mehr Technologien, Bereitstellungsmodellen oder Generationen

Lesen Sie für interaktive Builds references/interactive-and-build.md (Interaktionen, Implementierungsanforderungen, Testlektionen). Implementieren Sie die funktionierende Oberfläche; ein Screenshot oder Mockup ist kein Liefergegenstand. Veröffentlichen Sie interaktive Seiten als eigenständiges HTML-Artefakt, wenn das Artifact-Tool verfügbar ist, und speichern Sie auch die Quelldatei.

5. Qualitätssicherung

Überprüfen Sie das Ergebnis und beheben Sie Probleme vor der Auslieferung:

KriteriumAnforderung
Technische GenauigkeitKeine unbelegten Architekturbehauptungen
Visuelle HierarchieAuf den ersten Blick klar
LesbarkeitMobilfreundlich, keine winzigen Texte
InformationsdesignKein überladenes Design
KonnektivitätPfeile und Schnittstellenbeschriftungen sind korrekt
InteraktivitätJedes Steuerelement funktioniert (tatsächlich testen)
ReaktionsfähigkeitDesktop und Mobilgerät
BrandingKonsistent und dezent
OriginalitätOriginale Komposition, keine Kopie eines Lehrbuchs
ExportbereitschaftStatische Dateien sind sauber und vollständig

Führen Sie python3 scripts/check_page.py PAGE.html --outdir DIR aus (benötigt Python mit Playwright und Chrome/Chromium): es meldet JS-Fehler, horizontales Scrollen, zu kleine SVG-Texte bei Telefonbreite und Beschriftungen, die über ihre Boxen hinausragen, und speichert Desktop- und Telefon-Screenshots. Klicken Sie dann auf jedes Steuerelement und betrachten Sie die Screenshots; Layoutfehler (überlappende Linien, überlaufende Beschriftungen, unlesbar kleine Mobiltexte) zeigen sich nur visuell. Beachten Sie die Lektionen in references/interactive-and-build.md. Behaupten Sie niemals, dass eine interaktive Funktion funktioniert, es sei denn, sie wurde implementiert und getestet.

6. Ausliefern

Bereitstellen: die endgültige Illustration oder Erfahrung; eigenständige Quelldateien; eine hochauflösende statische Vorschau; verwendete technische Referenzen; kurze Hosting-Hinweise, falls es sich um eine Webseite handelt. Bieten Sie den LinkedIn-Skill an, wenn der Benutzer dort veröffentlicht. Halten Sie die Abschlussnachricht kurz: was erstellt wurde, was im Umfang enthalten ist, was vereinfacht wurde, und die Referenzen.

Ausgearbeitetes Beispiel

Anfrage: "S8HR vs LBO für VoLTE-Roaming, mittlere Tiefe."

Annahmen genannt: Modus C (interaktiv + statisch), horizontales Vergleichslayout, Umfang beschränkt auf VoLTE-Roaming mit IMS (GSMA IR.65 und 3GPP TS 23.228/23.401 als Basisreferenzen), keine Namensnennung.

Technische Gliederung (vor dem Design):

  • S8HR: IMS-Dienste im HPLMN verankert; das VPLMN trägt die Bearer und benötigt kein IMS für den Roamer, daher hat die besuchte Seite keinen P-CSCF für diesen Benutzer. Signalisierung und Medien gehen beide über S8 nach Hause zurück. Frühere S8HR-Arbeiten führten Lawful Intercept, Notrufe und SRVCC als offene Themen auf: Überprüfen Sie die aktuellen Releases und markieren Sie sie als "nicht gezeigt", anstatt sie stillschweigend wegzulassen.
  • LBO: Bearer und P-CSCF im VPLMN, S-CSCF weiterhin zu Hause (Mw zwischen ihnen); Medien verlassen lokal, aber das besuchte Netz benötigt IMS-Fähigkeit, und die Richtlinie wird über S9 koordiniert. Geben Sie nicht an, wie weit verbreitet jedes Modell ist, es sei denn, eine Quelle sagt dies aus.
  • Hervorzuhebender Unterschied: wo der P-CSCF und der Media-Anker sitzen und welche Seite IMS-Interworking benötigt. Überprüfen Sie jedes vor dem Zeichnen anhand der Spezifikationen; markieren Sie regulatorische oder Lawful-Intercept-Nuancen als "nicht gezeigt".

Design: ein Diagramm mit einem S8HR/LBO-Auswahlschalter, denselben besuchten/Heimat-Bändern in beiden, Signalisierung als lila gestrichelt und Medien als durchgehend grün, einem "Signalisierung / Medien / Beides"-Filter, einem Klickpanel pro Knoten (Verantwortung, Protokolle, Schnittstellen, standardisiert-oder-nicht-Vermerk) und einem separaten Hochformat-Layout unter 640 px, damit Text auf Telefonen lesbar bleibt.

Auslieferung: eine eigenständige .html, eine PNG-Vorschau und eine Referenzliste. Die Abschlussnachricht nennt, was vereinfacht wurde. Dieses Beispiel wurde erstellt und mit scripts/check_page.py überprüft (keine JS-Fehler, kein horizontales Scrollen, gerenderter Text etwa 12 px oder mehr bei 390 px).

Namensnennung und Branding

Halten Sie jegliches Branding dezent und sekundär; fügen Sie nur auf Anfrage eine dezente Autorenangabe hinzu. Fügen Sie niemals GSMA-, 3GPP-, ITU-, ETSI- oder Anbieter-Branding hinzu, implizieren Sie niemals eine Unterstützung, verwenden Sie niemals das Wasserzeichen eines anderen Erstellers wieder. Kopieren Sie keine vorhandenen Illustrationen; der Referenzstil (saubere geschichtete Vergleiche, einfache Blöcke, Richtungspfeile, Farbcodierung) ist eine Reihe von Prinzipien, keine Vorlage zum Nachzeichnen.

Referenzdateien

  • references/design-system.md: visueller Stil, Farbbedeutungen, Typografie, die fünf Layout-Typen und wann sie verwendet werden.
  • references/accuracy-checklist.md: Checkliste vor der Illustration, Quellenpriorität, Liste der niemals zu erfindenden Dinge, Beschriftungsschema, unterstützte Themenübersicht.
  • references/interactive-and-build.md: Interaktionsmuster, Implementierungsanforderungen, statischer Export, Testlektionen.
  • scripts/check_page.py: automatische Desktop-/Telefonprüfungen und Screenshots für eine interaktive Seite.

Verwandte Skills