human-writing

Name: human-writing
Author: Svenja-dev

38stars5forks

How to install human-writing?

svenja-dev/claude-code-skills/human-writing

$npx -y skills add Svenja-dev/claude-code-skills --skill human-writing

Installs into the current project.

Summary

Vermeidet KI-typische Schreibmuster und erzeugt hochwertige Sach- und Fachtexte, die gelesen, gespeichert und erinnert werden. Trigger bei Anfragen wie "schreibe einen Artikel", "erstelle einen LinkedIn-Post", "verfasse einen Blog-Beitrag", "schreibe einen Text ueber", "ueberarbe

Files · 1

View on GitHub

SKILL.md

1	# Human Writing Style Guide
2
3	Dieser Skill hat zwei Teile. Teil 1 beschreibt, wie gute Sachtexte aufgebaut sind, also Texte, die Leser tatsaechlich lesen, speichern und deren Autor sie sich merken. Teil 2 beschreibt, welche KI-typischen Muster zu vermeiden sind.
4
5	Beides gehoert zusammen: Ein Text, der nur KI-Muster vermeidet, ist nicht automatisch gut. Und ein inhaltlich guter Text faellt durch, wenn er nach Sprachmodell klingt.
6
7	## Teil 1: Wie gute Sachtexte funktionieren
8
9	### Der Einstieg (Hook)
10
11	Der erste Satz entscheidet, ob jemand weiterliest. Gute Hooks sind faktisch korrekt und wecken Neugier. Erfundene Geschichten als Einstieg sind verboten, weil sie Glaubwuerdigkeit zerstoeren und als KI-Muster erkannt werden ("Stell dir vor, es ist 6 Uhr morgens in einer Fabrikhalle...").
12
13	Sechs bewaehrte Hook-Typen, die abgewechselt werden muessen:
14
15	1. Kontraintuitive Aussage
16	"Die meisten Schichtleiter drucken ihre KPIs morgens auf Papier aus. Nicht weil sie Technik ablehnen, sondern weil ihr MES keine brauchbare Morgen-Ansicht hat."
17
18	2. Ueberraschende Zahl oder Statistik
19	"92% der Excel-Dateien in der Fertigungsplanung enthalten mindestens einen Formelfehler (Panko, 2008)."
20
21	3. Konkrete Szene (real, nicht erfunden)
22	"Im Audit letzte Woche fehlten 14 von 200 Chargenprotokollen. Alle aus derselben Schicht."
23
24	4. Direkte Frage
25	"Wann haben Sie zuletzt geprueft, ob Ihre OEE-Berechnung die Mikrostopps mitzaehlt?"
26
27	5. Zitat einer realen Person
28	"'Wir haben drei MES-Systeme evaluiert. Alle konnten alles. Keines konnte das, was wir wirklich brauchten.' (Produktionsleiter, Mittelstand, 2024)"
29
30	6. Widerspruch oder Spannung
31	"Unternehmen investieren Millionen in Traceability. Gleichzeitig laufen 40% der Rueckverfolgungen ueber Outlook-Mails."
32
33	Nicht jeder Text braucht einen dramatischen Hook. Bei kurzen Fachtexten, Anleitungen oder Status-Updates reicht ein klarer, direkter erster Satz, der sofort sagt, worum es geht.
34
35	### Die Orientierung (Nut Graf / Summary)
36
37	Nach dem Hook muss der Leser innerhalb der ersten drei Absaetze wissen:
38	- Worum geht es konkret?
39	- Warum ist es relevant fuer ihn?
40	- Was erwartet ihn im weiteren Text?
41
42	Bei laengeren Texten (ab ca. 800 Woertern) gehoert eine Summary an den Anfang. Nicht als trockene Aufzaehlung, sondern als kompakter Absatz, der die Kernaussage vorwegnimmt. Das ist keine Entscheidungsschwaeche ("ich verrate schon alles"), sondern Respekt vor der Zeit des Lesers. Wer die Summary liest und denkt "das reicht mir", hat trotzdem etwas mitgenommen. Wer mehr will, liest weiter.
43
44	Beispiel fuer eine gute Summary:
45	"Dieser Artikel zeigt, warum klassische OEE-Berechnungen in der Praxis oft 5 bis 15 Prozentpunkte daneben liegen, welche drei Fehlerquellen am haeufigsten sind und wie man sie ohne neues Tooling behebt. Lesedauer: 6 Minuten."
46
47	### Ueberraschende Fakten und dosierter Humor
48
49	Ueberraschende Fakten aktivieren das Dopamin-Belohnungssystem und foerdern die Langzeitgedaechtnisbildung (Edutopia, basierend auf neurowissenschaftlichen Studien). Ein guter Sachtext streut alle 300 bis 500 Woerter eine ueberraschende Information ein, die der Leser nicht erwartet hat.
50
51	Humor funktioniert in Sachtexten, wenn er organisch aus dem Thema kommt. Erzwungener Humor schadet. Gute Formen:
52	- Trockene Untertreibung ("Das Spreadsheet hatte 47 Tabs. Die Dokumentation bestand aus einem Post-it.")
53	- Selbstironie ("Ja, ich habe auch mal eine Pivot-Tabelle als Datenbank missbraucht.")
54	- Absurde, aber wahre Details ("Der Server lief seit 2011 durch. Niemand wusste das Passwort, aber er lief.")
55
56	Schlechte Formen:
57	- Wortspiele, die den Lesefluss stoppen
58	- "Stell dir vor"-Szenarien
59	- Sarkasmus ueber den Leser oder sein Fachgebiet
60
61	### Spezifische Details statt Abstraktion
62
63	Der staerkste Hebel fuer einpraegsame Texte sind intime, spezifische Details, die der Leser ohne den Autor nicht kennen wuerde. Das ist der Unterschied zwischen "die Produktion war ineffizient" und "der Schichtleiter druckte jeden Morgen 14 Seiten Excel aus, markierte drei Zeilen gelb und warf den Rest weg."
64
65	Spezifische Details erzeugen Bilder im Kopf. Abstrakte Aussagen erzeugen nichts.
66
67	\| Abstrakt (schlecht) \| Spezifisch (gut) \|
68	\|---------------------\|-------------------\|
69	\| "Die Digitalisierung schreitet voran." \| "Seit Januar laeuft die Schichtuebergabe ueber ein Tablet statt ueber das blaue Notizb

People who liked this also viewed

6 picks

Type

human-writing

38stars5forks

View on GitHub

How to install human-writing?

svenja-dev/claude-code-skills/human-writing

$npx -y skills add Svenja-dev/claude-code-skills --skill human-writing

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Human Writing Style Guide
2
3	Dieser Skill hat zwei Teile. Teil 1 beschreibt, wie gute Sachtexte aufgebaut sind, also Texte, die Leser tatsaechlich lesen, speichern und deren Autor sie sich merken. Teil 2 beschreibt, welche KI-typischen Muster zu vermeiden sind.
4
5	Beides gehoert zusammen: Ein Text, der nur KI-Muster vermeidet, ist nicht automatisch gut. Und ein inhaltlich guter Text faellt durch, wenn er nach Sprachmodell klingt.
6
7	## Teil 1: Wie gute Sachtexte funktionieren
8
9	### Der Einstieg (Hook)
10
11	Der erste Satz entscheidet, ob jemand weiterliest. Gute Hooks sind faktisch korrekt und wecken Neugier. Erfundene Geschichten als Einstieg sind verboten, weil sie Glaubwuerdigkeit zerstoeren und als KI-Muster erkannt werden ("Stell dir vor, es ist 6 Uhr morgens in einer Fabrikhalle...").
12
13	Sechs bewaehrte Hook-Typen, die abgewechselt werden muessen:
14
15	1. Kontraintuitive Aussage
16	"Die meisten Schichtleiter drucken ihre KPIs morgens auf Papier aus. Nicht weil sie Technik ablehnen, sondern weil ihr MES keine brauchbare Morgen-Ansicht hat."
17
18	2. Ueberraschende Zahl oder Statistik
19	"92% der Excel-Dateien in der Fertigungsplanung enthalten mindestens einen Formelfehler (Panko, 2008)."
20
21	3. Konkrete Szene (real, nicht erfunden)
22	"Im Audit letzte Woche fehlten 14 von 200 Chargenprotokollen. Alle aus derselben Schicht."
23
24	4. Direkte Frage
25	"Wann haben Sie zuletzt geprueft, ob Ihre OEE-Berechnung die Mikrostopps mitzaehlt?"
26
27	5. Zitat einer realen Person
28	"'Wir haben drei MES-Systeme evaluiert. Alle konnten alles. Keines konnte das, was wir wirklich brauchten.' (Produktionsleiter, Mittelstand, 2024)"
29
30	6. Widerspruch oder Spannung
31	"Unternehmen investieren Millionen in Traceability. Gleichzeitig laufen 40% der Rueckverfolgungen ueber Outlook-Mails."
32
33	Nicht jeder Text braucht einen dramatischen Hook. Bei kurzen Fachtexten, Anleitungen oder Status-Updates reicht ein klarer, direkter erster Satz, der sofort sagt, worum es geht.
34
35	### Die Orientierung (Nut Graf / Summary)
36
37	Nach dem Hook muss der Leser innerhalb der ersten drei Absaetze wissen:
38	- Worum geht es konkret?
39	- Warum ist es relevant fuer ihn?
40	- Was erwartet ihn im weiteren Text?
41
42	Bei laengeren Texten (ab ca. 800 Woertern) gehoert eine Summary an den Anfang. Nicht als trockene Aufzaehlung, sondern als kompakter Absatz, der die Kernaussage vorwegnimmt. Das ist keine Entscheidungsschwaeche ("ich verrate schon alles"), sondern Respekt vor der Zeit des Lesers. Wer die Summary liest und denkt "das reicht mir", hat trotzdem etwas mitgenommen. Wer mehr will, liest weiter.
43
44	Beispiel fuer eine gute Summary:
45	"Dieser Artikel zeigt, warum klassische OEE-Berechnungen in der Praxis oft 5 bis 15 Prozentpunkte daneben liegen, welche drei Fehlerquellen am haeufigsten sind und wie man sie ohne neues Tooling behebt. Lesedauer: 6 Minuten."
46
47	### Ueberraschende Fakten und dosierter Humor
48
49	Ueberraschende Fakten aktivieren das Dopamin-Belohnungssystem und foerdern die Langzeitgedaechtnisbildung (Edutopia, basierend auf neurowissenschaftlichen Studien). Ein guter Sachtext streut alle 300 bis 500 Woerter eine ueberraschende Information ein, die der Leser nicht erwartet hat.
50
51	Humor funktioniert in Sachtexten, wenn er organisch aus dem Thema kommt. Erzwungener Humor schadet. Gute Formen:
52	- Trockene Untertreibung ("Das Spreadsheet hatte 47 Tabs. Die Dokumentation bestand aus einem Post-it.")
53	- Selbstironie ("Ja, ich habe auch mal eine Pivot-Tabelle als Datenbank missbraucht.")
54	- Absurde, aber wahre Details ("Der Server lief seit 2011 durch. Niemand wusste das Passwort, aber er lief.")
55
56	Schlechte Formen:
57	- Wortspiele, die den Lesefluss stoppen
58	- "Stell dir vor"-Szenarien
59	- Sarkasmus ueber den Leser oder sein Fachgebiet
60
61	### Spezifische Details statt Abstraktion
62
63	Der staerkste Hebel fuer einpraegsame Texte sind intime, spezifische Details, die der Leser ohne den Autor nicht kennen wuerde. Das ist der Unterschied zwischen "die Produktion war ineffizient" und "der Schichtleiter druckte jeden Morgen 14 Seiten Excel aus, markierte drei Zeilen gelb und warf den Rest weg."
64
65	Spezifische Details erzeugen Bilder im Kopf. Abstrakte Aussagen erzeugen nichts.
66
67	\| Abstrakt (schlecht) \| Spezifisch (gut) \|
68	\|---------------------\|-------------------\|
69	\| "Die Digitalisierung schreitet voran." \| "Seit Januar laeuft die Schichtuebergabe ueber ein Tablet statt ueber das blaue Notizb

People who liked this also viewed

6 picks

Type