writing-shape

Überblick über die writing-shape-Skill

writing-shape ist eine konversationelle Drafting-Skill, die aus einem markdown „Haufen“ Schritt für Schritt einen veröffentlichungsreifen Artikel formt. Sie eignet sich besonders für Autor:innen, Tech-Marketer:innen und Redakteur:innen, die bereits Material haben, aber Hilfe brauchen, um den Aufhänger, den Einstieg und die endgültige Form des Textes zu finden.

Wofür writing-shape gedacht ist

Nutze writing-shape, wenn die Aufgabe nicht „von null schreiben“ lautet, sondern „dieses Rohmaterial schlüssig machen“. Die Skill funktioniert gut mit Interviewnotizen, bereinigten Transkripten, Entwurfsfragmenten und technischem Writing, das vor dem Fertigstellen noch eine stärkere erzählerische Linie braucht.

Was writing-shape anders macht

Die writing-shape-Skill macht mehr als nur Quellnotizen zusammenzufassen. Sie lässt dich zwischen möglichen Einstiegen wählen und baut den Artikel dann Absatz für Absatz auf, während die Struktur unterwegs mitverhandelt wird. Das ist besonders nützlich für Texte, bei denen Reihenfolge, Gewichtung und Format genauso wichtig sind wie die Fakten.

Bestes Einsatzgebiet und Grenzen

Für Technical Writing ist das eine gute Wahl, wenn aus unordentlichem Input ein gut lesbarer Artikel werden soll. Ein Ersatz für fachliche Urteilskraft ist es aber nicht. Wenn du polierten Text ohne Diskussion brauchst, ist ein generischer Prompt oft schneller; wenn du einen geführten redaktionellen Prozess willst, ist writing-shape die bessere Installation.

So verwendest du die writing-shape-Skill

Installation und Session-Setup

Installiere mit npx skills add mattpocock/skills --skill writing-shape. Starte die Session dann, indem du die rohe Markdown-Datei und den Zielpfad des Artikels übergibst — oder bitte die Skill, einen Pfad auszuwählen, falls du dich noch nicht entschieden hast. Die Skill erwartet, dass das Quellmaterial als read-only behandelt wird und die Artikeldatei vor jedem Schreibschritt erneut eingelesen wird.

Welche Eingaben du bereitstellen solltest

Die stärkste Nutzung von writing-shape beginnt mit drei Dingen: den Rohnotizen, der Zielgruppe und dem gewünschten Ergebnis des Artikels. Zum Beispiel ist „forme diese Notizen zu einem praxisnahen Leitfaden für neue Platform Engineers“ besser als „mach das besser“, weil die Skill damit eine These, eine Leserschaft und das gewünschte Detailniveau als Optimierungsziele bekommt.

Empfohlener Workflow

Starte mit der Quelldatei, lies sie von Anfang bis Ende und lass die Skill 2–3 mögliche Einstiege vorschlagen. Wähle den Einstieg, der zur eigentlichen Aufgabe des Artikels passt, und arbeite dann Schritt für Schritt weiter, indem du jeweils fragst, was der Leser als Nächstes braucht. Genau in diesem Loop ist writing-shape am nützlichsten: Der Artikel bleibt verankert, während du die Struktur mit dem Entwurf mitformen kannst.

Dateien zuerst lesen

Öffne zuerst SKILL.md und prüfe dann alle benachbarten Repo-Hinweise, auf die die Skill verweist, etwa README.md, AGENTS.md und metadata.json, falls sie vorhanden sind. In diesem Repository liegt der Hauptwert in SKILL.md selbst — die praktische Entscheidung lautet also nicht „versteckte Helfer finden“, sondern „den Drafting-Loop verstehen und sauber anpassen“.

writing-shape-Skill-FAQ

Ist writing-shape nur für Markdown-Eingaben gedacht?

Sie ist zwar auf Markdown-Dateien ausgelegt, aber der „Haufen“ kann auch aus einem Transkript, Notizen oder grober Prosa bestehen, die in Markdown überführt wurde. Entscheidend ist, dass das Ausgangsmaterial vor dem Formen als geschlossener, vollständig lesbarer Stoff vorliegt.

Worin unterscheidet sich writing-shape von einem normalen Prompt?

Ein normaler Prompt fordert oft in einem einzigen Durchgang einen fertigen Entwurf an. writing-shape führt stattdessen durch eine iterative redaktionelle Sitzung: Die Wahl des Einstiegs, die Reihenfolge der Absätze und Diskussionen über das Format passieren während des Prozesses. Das führt bei unordentlichem Input meist zu einem bewussteren Artikel.

Ist writing-shape für Einsteiger geeignet?

Ja, wenn die Person Quellmaterial liefern und ein paar redaktionelle Fragen beantworten kann. Besonders hilfreich ist sie, wenn Einsteiger zwar wissen, was sie haben, aber noch nicht, wie sie es zu einem überzeugenden Artikel ordnen.

Wann sollte ich writing-shape nicht verwenden?

Verwende writing-shape nicht, wenn der Inhalt bereits eng strukturiert ist, wenn es keinen echten Materialstapel gibt, den man formen müsste, oder wenn du statt eines sich entwickelnden Artikels nur eine Einmal-Zusammenfassung brauchst. Am wertvollsten ist die Skill, wenn noch eine Formentscheidung ansteht und nicht nur Aufräumarbeit.

So verbesserst du die writing-shape-Skill

Gib ihr ein schärferes redaktionelles Briefing

Die besten Ergebnisse mit writing-shape entstehen durch ein klares Versprechen: Für wen der Artikel gedacht ist, welches Problem er löst und welche Art von Text daraus werden soll. Wenn du Zielgruppe und Ergebnis von Anfang an benennen kannst, kann die Skill einen besseren Einstieg wählen und spätere Absätze darauf ausrichten.

Liefere besseres Quellmaterial

Ein häufiger Fehler: Der Quellstapel ist zu breit, zu repetitiv oder mit themenfremder Recherche vermischt. Vor dem Einsatz der Skill solltest du offensichtliches Rauschen kürzen, die relevantesten Markdown-Fragmente zusammenlassen und Abschnitte markieren, wenn das Material mehrere Themen enthält. Bessere Eingaben reduzieren verzweigte Entwürfe und machen die Formungsphase entschiedener.

Überarbeite die Struktur, nicht nur den Wortlaut

Wenn sich der erste Entwurf falsch anfühlt, bitte nicht nur um „bessere Prosa“. Passe stattdessen die These an, ordne die Beats neu oder verändere die Erwartungen an das Format des Artikels. writing-shape wird am stärksten, wenn du zuerst die Form des Arguments und erst danach die Sätze überarbeitest.

Bewahre die Artikeldatei

Da die Skill erwartet, dass das Artikeldokument vor jedem Schreibschritt erneut gelesen wird, sollten Änderungen in dieser Datei bleiben und nicht nur im Chat behandelt werden. Diese Gewohnheit schützt Nutzeränderungen, macht die Zusammenarbeit sicherer und hält writing-shape auch für längere Drafting-Sessions nützlich.