Offizieller Skill · Customer Success

Artikel fürs Help Center

v1.0.0 · Aktualisiert am 4. November 2026

Schreibt einen Hilfeartikel zu einer Aufgabe: Titel als Aufgabe, Antwort zuerst, nummerierte Schritte mit exakten Beschriftungen, Hinweise für Screenshots, Fehlerbehebung, ähnliche Links.

Funktioniert in Claude, ChatGPT und Coding-Agents. In Team und Business aktualisiert sich der offizielle Skill in deinem Pod von selbst, wenn wir ihn verbessern.

Wann du ihn nutzt

• Eine Frage taucht immer wieder auf, und die Antwort steht nur in den Antworten des Supports
• Eine Funktion ist live, und Kunden brauchen eine Anleitung

Was du ihm gibst

• Die Aufgabe und wer sie erledigen kann
• Die echten Schritte und Beschriftungen der Oberfläche
• Bekannte Probleme aus Tickets

Was du bekommst

Ein Hilfeartikel, bereit zum Veröffentlichen, mit Platzhaltern für Screenshots und einem Abschnitt zur Fehlerbehebung.

So funktioniert er

1. Benenne den Artikel nach der Aufgabe Formuliere ihn als Handlung, so wie Kunden suchen: „Kontakte als CSV exportieren“, „Teammitglied zum Arbeitsbereich hinzufügen“. Nicht „Exportfunktion“ oder „Exporte verstehen“. Eine Aufgabe pro Artikel; decken die Notizen 2 Aufgaben ab, schreib 2 Artikel.
2. Antworte in den ersten 2 Sätzen Sag, was die Aufgabe bewirkt, und nenne den kürzesten Weg: „Sie können Kontakte unter **Kontakte > Exportieren** exportieren. Die Datei kommt innerhalb weniger Minuten per E-Mail.“ Dann, wer es tun kann und was vorher nötig ist (Rolle, Tarif, Berechtigung).
3. Schreib nummerierte Schritte mit je einer Aktion Beginne jeden Schritt mit der Aktion. Setz Beschriftungen der Oberfläche fett, genau wie angezeigt, auch die Groß- und Kleinschreibung. Schreib Menüpfade als **Einstellungen** > **Team**, die Pfeile nicht fett. Nenne den Ort vor der Aktion: „Klicken Sie oben rechts auf **Einstellungen**.“ Bleib bei 3 bis 10 Schritten; sind es mehr, teile sie in Abschnitte mit eigenen Überschriften.
4. Sag, woran man den Erfolg erkennt Nach dem letzten Schritt eine Zeile dazu, was der Kunde sieht, wenn es geklappt hat: eine Meldung, eine Datei, ein neuer Eintrag in einer Liste.
5. Markiere Screenshots dort, wo sie helfen Setz einen Platzhalter nach einem Schritt, bei dem das Ziel schwer zu finden oder der Bildschirm unübersichtlich ist, nicht nach jedem Schritt. Schreib, was der Screenshot zeigt, damit er später aufgenommen werden kann und als Alt-Text dient.
6. Ergänze die Fehlerbehebung aus echten Problemen Jeder Punkt hat das Symptom in den Worten des Kunden als Überschrift, dann Ursache und Lösung in 1 bis 3 Sätzen. Nimm nur Probleme aus Tickets oder vom Produktteam; erfinde keine Fehler.
7. Verlinke 2 bis 4 ähnliche Artikel Die Aufgabe, die wahrscheinlich als Nächstes kommt, und die Voraussetzung. Nutze die echten Titel der Artikel, falls vorhanden; sonst schreib „[ähnlich: Thema]“.

Die SKILL.md

Die ganze Datei, so wie deine KI sie liest. Herunterladen

---
name: help-article-writer
description: Schreibt einen Artikel für Help Center oder Wissensdatenbank zu einer Kundenaufgabe, benannt nach der Aufgabe, mit der Antwort zuerst, nummerierten Schritten mit den exakten Beschriftungen der Oberfläche, Platzhaltern für Screenshots, einem Abschnitt zur Fehlerbehebung und ähnlichen Artikeln. Nutze ihn, wenn jemand nach einem Hilfeartikel, einer Support-Doku, einer Anleitung oder einer Seite für die Wissensdatenbank fragt oder eine Ticketantwort, Release Notes oder grobe Notizen in einen Artikel verwandeln will, mit dem Kunden allein zurechtkommen.
---

# Hilfeartikel schreiben

Mit einem Hilfeartikel erledigt ein Kunde eine Aufgabe, ohne den Support zu kontaktieren. Er kommt über die Suche, überfliegt den Text nach seiner Aufgabe und folgt den Schritten, während das Produkt neben dem Artikel offen ist. Benenne den Artikel nach der Aufgabe, stell die Antwort an den Anfang und mach jeden Schritt zu einer Aktion mit der Beschriftung genau so, wie sie auf dem Bildschirm steht.

## Wann du sie nutzt

- Eine Frage taucht in Tickets immer wieder auf, und die Antwort steht nur in den Antworten des Supports.
- Eine Funktion ist live, und Kunden müssen wissen, wie man sie nutzt.
- Ein bestehender Artikel ist lang, veraltet oder in internen Begriffen geschrieben.
- Nicht für eine FAQ-Liste über viele Fragen: Dafür gibt es faq-from-tickets. Nicht für Release Notes: Dafür gibt es release-notes.

## Was du brauchst

- Die Aufgabe, um die es geht, und wer sie erledigt (alle Nutzer, nur Admins, ein bestimmter Tarif).
- Die echten Schritte: Bildschirme, Schaltflächen und Menünamen so, wie das Produkt sie zeigt. Hast du nur eine Beschreibung, schreib die Schritte und markiere jede unsichere Beschriftung mit „[Beschriftung prüfen]“.
- Bekannte Probleme: Fehler, auf die Kunden stoßen, aus Tickets oder vom Produktteam.
- Optional: bestehende Artikel, die du als ähnliche Artikel verlinkst.

## Schritte

1. **Benenne den Artikel nach der Aufgabe.** Formuliere ihn als Handlung, so wie Kunden suchen: „Kontakte als CSV exportieren“, „Teammitglied zum Arbeitsbereich hinzufügen“. Nicht „Exportfunktion“ oder „Exporte verstehen“. Eine Aufgabe pro Artikel; decken die Notizen 2 Aufgaben ab, schreib 2 Artikel.
2. **Antworte in den ersten 2 Sätzen.** Sag, was die Aufgabe bewirkt, und nenne den kürzesten Weg: „Sie können Kontakte unter **Kontakte > Exportieren** exportieren. Die Datei kommt innerhalb weniger Minuten per E-Mail.“ Dann, wer es tun kann und was vorher nötig ist (Rolle, Tarif, Berechtigung).
3. **Schreib nummerierte Schritte mit je einer Aktion.** Beginne jeden Schritt mit der Aktion. Setz Beschriftungen der Oberfläche fett, genau wie angezeigt, auch die Groß- und Kleinschreibung. Schreib Menüpfade als **Einstellungen** > **Team**, die Pfeile nicht fett. Nenne den Ort vor der Aktion: „Klicken Sie oben rechts auf **Einstellungen**.“ Bleib bei 3 bis 10 Schritten; sind es mehr, teile sie in Abschnitte mit eigenen Überschriften.
4. **Sag, woran man den Erfolg erkennt.** Nach dem letzten Schritt eine Zeile dazu, was der Kunde sieht, wenn es geklappt hat: eine Meldung, eine Datei, ein neuer Eintrag in einer Liste.
5. **Markiere Screenshots dort, wo sie helfen.** Setz einen Platzhalter nach einem Schritt, bei dem das Ziel schwer zu finden oder der Bildschirm unübersichtlich ist, nicht nach jedem Schritt. Schreib, was der Screenshot zeigt, damit er später aufgenommen werden kann und als Alt-Text dient.
6. **Ergänze die Fehlerbehebung aus echten Problemen.** Jeder Punkt hat das Symptom in den Worten des Kunden als Überschrift, dann Ursache und Lösung in 1 bis 3 Sätzen. Nimm nur Probleme aus Tickets oder vom Produktteam; erfinde keine Fehler.
7. **Verlinke 2 bis 4 ähnliche Artikel.** Die Aufgabe, die wahrscheinlich als Nächstes kommt, und die Voraussetzung. Nutze die echten Titel der Artikel, falls vorhanden; sonst schreib „[ähnlich: Thema]“.

## Ausgabeformat

```markdown
# [Titel der Aufgabe als Handlung]

[Was das bewirkt und der kürzeste Weg, 1–2 Sätze.]

**Wer das tun kann:** [Rolle / Tarif] · **Bevor Sie anfangen:** [Voraussetzung, oder streichen]

## [Aufgabe oder erster Teil der Aufgabe]
1. Klicken Sie [Ort] auf **[Beschriftung]**.
2. [...]

![Screenshot: was er zeigt]

Wenn es geklappt hat, [was der Kunde sieht].

## Fehlerbehebung
### [Symptom in den Worten des Kunden]
[Ursache und Lösung, 1–3 Sätze.]

## Ähnliche Artikel
- [Titel des Artikels]
```

## Beispiel

**Eingabe:**

> Notizen vom Produktteam: Admins können Teammitglieder über Einstellungen → Team → Schaltfläche „Personen einladen“ einladen, E-Mail-Adressen eingeben (durch Kommas getrennt), Rolle Mitglied oder Betrachter wählen, dann Einladungen senden. Die Einladung läuft nach 7 Tagen ab. Tickets: Leute sagen, die Einladungs-E-Mail kam nie an (meist im Spam-Ordner oder falsche Adresse); „Personen einladen“ ist für Nicht-Admins ausgegraut.

**Ausgabe:**

```markdown
# Teammitglied in Ihren Arbeitsbereich einladen

Sie können Teammitglieder unter **Einstellungen** > **Team** > **Personen einladen** einladen. Sie bekommen eine E-Mail mit einem Link zum Beitreten; der Link funktioniert 7 Tage lang.

**Wer das tun kann:** Admins des Arbeitsbereichs

## Einladung senden
1. Klicken Sie im linken Menü auf **Einstellungen**.
2. Klicken Sie auf **Team**.
3. Klicken Sie auf **Personen einladen**.
4. Geben Sie eine oder mehrere E-Mail-Adressen ein, durch Kommas getrennt.
5. Wählen Sie eine Rolle: **Mitglied** oder **Betrachter**.
6. Klicken Sie auf **Einladungen senden**.

![Screenshot: das Fenster „Personen einladen“ mit zwei eingegebenen E-Mail-Adressen und geöffnetem Rollenmenü]

Wenn es geklappt hat, erscheint jede Person in der Team-Liste als „Eingeladen“, bis sie beitritt.

## Fehlerbehebung
### Die Einladungs-E-Mail ist nie angekommen
Bitten Sie die Person, im Spam- oder Junk-Ordner nachzusehen. Ist sie dort nicht, prüfen Sie die Adresse in der Team-Liste und senden Sie die Einladung noch einmal.

### „Personen einladen“ ist ausgegraut
Nur Admins können einladen. Bitten Sie einen Admin des Arbeitsbereichs, die Person einzuladen oder Sie zum Admin zu machen.

## Ähnliche Artikel
- [ähnlich: Rolle eines Teammitglieds ändern]
- [ähnlich: Teammitglied entfernen]
```

## Prüfen vor dem Senden

- [ ] Der Titel ist als Handlung formuliert und nennt eine Aufgabe.
- [ ] Die ersten 2 Sätze beantworten die Frage auch ohne die Schritte.
- [ ] Jeder Schritt hat eine Aktion, und jede Beschriftung der Oberfläche ist fett und stimmt mit dem Produkt überein oder ist mit „[Beschriftung prüfen]“ markiert.
- [ ] Der Artikel sagt, wer es tun kann und woran man den Erfolg erkennt.
- [ ] Jeder Punkt der Fehlerbehebung stammt aus Tickets oder vom Produktteam.
- [ ] Keine internen Begriffe (Ticket, SKU, Feature Flag, Backend).

## Häufige Fehler

- Mit Hintergrund anfangen („Teams sind ein wichtiger Bestandteil von ...“). Die Leser sind wegen der Schritte da.
- „Navigieren Sie zur Einstellungsseite und konfigurieren Sie Ihr Team“ schreiben. Nenne jeden Klick.
- Ein Screenshot nach jedem Schritt. Das macht die Seite lang, und mit jeder Änderung der Oberfläche veraltet er.

Teile ihn mit deinem Team

Füge ihn einem AI Skill Pod hinzu, und alle im Team, auch Freelancer, nutzen dieselbe Version aus ihrer eigenen KI. Lies, wie Teams KI-Skills am besten teilen

Zum Pod meines Teams hinzufügen

Änderungen

• v1.0.0 · 4. November 2026 · First release.