Verwenden Sie diese Checkliste vor der Veröffentlichung eines Artikels, um sicherzustellen, dass er sowohl die Standards für menschliche Lesbarkeit als auch KI-Wiederfindbarkeit erfüllt. Jeder Gegenstand entspricht einer Best Practice-Struktur, die in gen-KI-freundlichen Inhalten abgedeckt wird.
Struktur & Überschriften
- Die Überschriften H1, H2 und H3 werden hierarchisch verwendet, keine Ebenen werden übersprungen.
- Jede Überschrift ist beschreibend und spezifisch, nicht generisch (meide "Überblick", "Einleitung", "Details").
- Im selben Artikel wird keine Überschrift wiederholt.
- Relevante Schlüsselwörter erscheinen natürlich in Überschriften.
Absätze & Fluss
- Die Sätze sind kurz. Idealerweise unter 20 Wörtern und direkt.
- Jeder Absatz behandelt eine einzelne Idee oder Aufgabe.
- Füllmaterial, Hintergrundkontext und tangentiale Informationen werden entfernt oder separat verlinkt.
- Jeder Abschnitt ist modular und prägnant. Idealerweise unter 500 Token (~375 Wörter).
Listen & Tabellen
- Stichpunkte werden für gruppierte, ungeordnete Informationen verwendet.
- Nummerierte Listen werden für aufeinanderfolgende Schritte verwendet.
- Listen enthalten 3–7 Elemente, und jedes Element ist parallel aufgebaut.
- Tabellen werden für strukturierte Daten (Parameter, Einstellungen, Vergleiche) verwendet.
- Alle Tabellenspalten haben beschreibende Überschriften.
- Alle Tabellenzellen enthalten beschreibenden Text. Kein Y/N, keine Striche, keine Emojis oder Symbole.
- Keine zusammengeführten Zellen oder inkonsistente Tabellenformatierung.
Code-Schnipsel
- Der Code ist sauber, konsequent eingerückt und korrekt formatiert.
- Inline-Kommentare erklären Logik und Absicht.
- Syntax-Hervorhebung oder Sprachtags werden angewendet.
- Codeblöcke sind kopierbar. Keine Zeilennummern oder dekoratives Design.
- Eine Kontextanweisung ist für API - oder produktspezifischen Code enthalten.
Bilder & Links
- Jedes Bild hat einen bedeutungsvollen, beschreibenden Alternativtext.
- Alttext vermeidet vage Bezeichnungen wie "Screenshot".
- Bildunterschriften oder umgebender Text liefern bei Bedarf zusätzlichen Kontext.
- Der gesamte Ankertext ist beschreibend. Zum Beispiel "Lerne, wie man private Arbeitsbereiche verwaltet" statt "hier", "das" oder "hier klicken".
- Innere Links führen bei relevanter Anwendung auf verwandte Artikel.
SEO & Metadaten
- Schlüsselwörter erscheinen natürlich in Überschriften, Abschnittsöffnern und im Haupttext.
- Eine Meta-Beschreibung wird mit den Hauptstichwörtern des Artikels verfasst.
- Strukturierte Metadaten (Titel-Tag, Beschreibung, benutzerdefinierte Felder) werden dort angewendet, wo sie unterstützt werden.
- Die Terminologie entspricht den vom Glossar genehmigten Begriffen.
Kompetenzen & KI-Arbeitsablauf
- Wurde ein SKILL.md verwendet, wurde das Ergebnis vor der Veröffentlichung auf Genauigkeit und Vollständigkeit überprüft.
- Keine Abschnitte wurden ohne Grund übersprungen. Wenn ein Abschnitt ausgelassen wird, ist er tatsächlich nicht anwendbar.
- Stimme und Ton entsprechen den MSTP-Konventionen: zweite Person, Gegenwartsform, aktive Stimme, keine Marketingsprache.
- Die von der Fähigkeit erstellten FAQs sind eigenständig und stammen aus echten Nutzerfragen, nicht aus generierten Füllmaterial.
GEO (Generative Engine-Optimierung)
- Der Artikel beginnt mit einer direkten Antwort auf die Frage des Hauptnutzers innerhalb der ersten zwei Sätze.
- Jeder Abschnitt ist in sich geschlossen und ergibt Sinn, wenn er isoliert gelesen wird, ohne den umgebenden Kontext zu benötigen.
- Schlüsselbegriffe und Definitionen werden explizit formuliert und nicht aus dem Kontext angenommen.
- Keine kritischen Informationen sind in der Mitte eines langen Absatzes versteckt – sie werden in einer Überschrift, Liste oder einem Hinweis aufgedeckt.
- Die Inhalte sind so strukturiert, dass KI eine brauchbare Antwort extrahieren kann, ohne den gesamten Artikel lesen zu müssen.
Glossar & Terminologie
- Genehmigte Glossarbegriffe werden genau wie definiert verwendet. Keine Synonyme oder Variationen.
- Unbekannte Begriffe werden beim ersten Erwähnen definiert oder verknüpft.
- Abkürzungen und Abkürzungen werden durchgehend verwendet.
Schreibstil
- Der Ton ist klar, gesprächig und benutzerfreundlich.
- Es wird einfache Sprache verwendet; Fachjargon wird vermieden oder erklärt.
- Die zweite Person ("du") wird in Lehr- und Anleitungstexten verwendet.
FAQs
- Der Artikel enthält 5–10 häufig gestellte Fragen in einem eigenen Abschnitt.
- Fragen stammen aus echten Nutzeranfragen, Support-Tickets oder häufigen Produktfragen.
- Jede FAQ-Antwort ist in sich geschlossen und prägnant.
KI-spezifische Prüfungen
- KI-generierte Entwürfe, überprüft auf Genauigkeit, Ton und Halluzinationen.
- Der Artikel wurde in Eddy AI getestet, um genaue Antworten zu bestätigen.
- Die Inhalte sind modular genug, um in FAQs, Chat-Antworten und Zusammenfassungen wiederverwendet zu werden.
- Unbeantwortete Anfragen oder Support-Feedback wurden geprüft und integriert.