# Writing

> Writing Skill

- Skill: `gm-itsolutions/writing` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add gm-itsolutions/writing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gm-itsolutions/writing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gm-itsolutions (https://skillmd.com/u/gm-itsolutions)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/gm-itsolutions/writing

---

# Writing Skill

Dieser Skill enthält Best Practices für das Erstellen von qualitativ hochwertigen Texten.

## Grundprinzipien

### 1. Klarheit
- Verwende einfache, präzise Sprache
- Vermeide Füllwörter und unnötige Komplexität
- Ein Gedanke pro Satz

### 2. Struktur
- Beginne mit dem Wichtigsten (Inverted Pyramid)
- Gliedere längere Texte mit Überschriften
- Verwende Absätze für thematische Trennung

### 3. Zielgruppe
- Passe Tonfall und Vokabular an die Leser an
- Erkläre Fachbegriffe wenn nötig
- Berücksichtige den Kontext

## Textarten

### Blog-Artikel
1. **Hook**: Fesselnde Einleitung (Frage, Statistik, Anekdote)
2. **Problem**: Beschreibe das Problem oder Thema
3. **Lösung**: Liefere wertvollen Content
4. **CTA**: Klarer Call-to-Action am Ende

### E-Mails
- **Betreff**: Klar, prägnant, actionable
- **Einleitung**: Kontext in 1-2 Sätzen
- **Hauptteil**: Eine Sache pro Absatz
- **Abschluss**: Klare nächste Schritte oder Frage

### Technische Dokumentation
- Übersicht/Zusammenfassung zuerst
- Schritt-für-Schritt Anleitungen nummerieren
- Code-Beispiele mit Erklärungen
- Troubleshooting-Sektion am Ende

## Qualitätscheckliste

Vor dem Absenden/Veröffentlichen prüfen:

- [ ] Rechtschreibung und Grammatik geprüft
- [ ] Absätze nicht länger als 4-5 Sätze
- [ ] Aktive statt passive Formulierungen verwendet
- [ ] Fachbegriffe erklärt (falls für Zielgruppe nötig)
- [ ] Logischer Aufbau und roter Faden erkennbar
- [ ] Call-to-Action oder nächste Schritte klar

## Tipps für verschiedene Töne

| Ton | Merkmale | Beispiel |
|-----|----------|----------|
| Formell | Sie-Form, keine Abkürzungen, sachlich | Geschäftskorrespondenz |
| Professionell | Du/Sie, klar, respektvoll | Tech-Blog, Dokumentation |
| Casual | Du-Form, lockere Sprache, Emojis OK | Social Media, Newsletter |
| Akademisch | Passiv OK, Quellenangaben, präzise | Paper, Fachartikel |