Dokumentation, READMEs, PR-Beschreibungen und Recherchetexte im Stil dieses Repos schreiben oder bearbeiten. Verwende es immer, wenn du Prosa für Leser:innen erstellst.
Was ist Agents-village?
Dieser Skill definiert einen klaren, konsistenten Schreibstil für alle leserorientierten Texte in einem Repository. Er richtet sich an KI-Agenten und Entwickler:innen, die Dokumentation, READMEs, Pull-Request-Beschreibungen und Forschungsprosa erstellen. Der Skill legt fest, dass jeder Absatz mit dem Kernpunkt beginnt, eine Idee pro Absatz hat und kurze Sätze verwendet. Konkrete Angaben wie Zahlen, Dateien, Befehle oder Namen werden allgemeinen Formulierungen vorgezogen. Prozessbeschreibungen und Selbstbezüge sind in leserorientierten Dokumenten verboten, ebenso Füllwörter wie „es ist wichtig zu beachten“. Tabellen sind nur für Vergleiche erlaubt, Listen nur für Schritte oder parallele Elemente. Unsicherheiten werden genau einmal an der zutreffenden Stelle genannt, zusammen mit einem Hinweis, wie sie aufgelöst werden können. Jedes Verzeichnis benötigt eine `README.md` (Beschreibung für Menschen) und eine `AGENTS.md` (Regeln, die ein Agent umsetzen kann). Beide müssen aktualisiert werden, wenn sich der Zweck oder die Regeln des Verzeichnisses ändern. Leserorientierte Dokumente tragen maximal eine Zeile mit Autorenangabe und ein Datum. Betriebszustände gehören in `docs/HANDOFF.md` und `docs/handoff/LOG.md`. Der Skill schließt mit der Aufforderung, den Text wie eine fremde Person zu lesen und alles zu streichen, was übersprungen würde. Dadurch werden klare, prägnante und benutzerfreundliche Dokumente sichergestellt.