Communitygithub.com

emavv/karpathy-guidelines

Universelle Verhaltensprinzipien für KI-Agenten: Karpathys Richtlinien, angepasst für Hermes (SOUL.md) und OpenAI Codex (Skill). Generalisiertes Vier-Prinzipien-Framework — Denken vor dem Handeln, Einfachheit zuerst, Chirurgische Änderungen, Zielorientierte Ausführung.

Was ist karpathy-guidelines?

Diese Skill definiert ein universelles Set von Verhaltensprinzipien für KI-Agenten, basierend auf den ursprünglichen Richtlinien von Andrej Karpathy. Sie wurde für Agenten wie Hermes (über SOUL.md) und OpenAI Codex adaptiert und bietet ein generalisiertes Vier-Prinzipien-Framework: 1) Denken vor dem Handeln – der Agent soll nachdenken, bevor er Code ausführt oder Änderungen vornimmt. 2) Einfachheit zuerst – Lösungen sollen so einfach wie möglich gehalten werden. 3) Chirurgische Änderungen – Änderungen sollen minimal, präzise und nachvollziehbar sein. 4) Zielorientierte Ausführung – jede Aktion muss dem übergeordneten Ziel dienen. Die Richtlinien sind als YAML-ähnliche Konfiguration definiert, die in SOUL.md-Dateien oder Codex-Konfigurationen eingebettet werden kann. Sie sind besonders nützlich für Entwickler, die KI-Agenten in Entwicklungsumgebungen wie Claude Code, Cursor oder Codex einsetzen, um konsistentes, vorhersehbares und effizientes Verhalten sicherzustellen. Durch die Befolgung dieser Prinzipien reduzieren Agenten unnötige Änderungen, vermeiden Überengineering und bleiben fokussiert auf die tatsächliche Aufgabenlösung.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add emavv/karpathy-guidelines

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht karpathy-guidelines?

Universelle Verhaltensprinzipien für KI-Agenten: Karpathys Richtlinien, angepasst für Hermes (SOUL.md) und OpenAI Codex (Skill). Generalisiertes Vier-Prinzipien-Framework — Denken vor dem Handeln, Einfachheit zuerst, Chirurgische Änderungen, Zielorientierte Ausführung.

Prinzipien

  1. Denken vor dem Handeln – Bevor du Code änderst oder ausführst, überlege dir die Konsequenzen und den optimalen Ansatz.
  2. Einfachheit zuerst – Bevorzuge einfache, lesbare Lösungen gegenüber komplexen oder cleveren Konstrukten.
  3. Chirurgische Änderungen – Mache minimale, gezielte Änderungen an bestehendem Code, anstatt großflächig umzubauen.
  4. Zielorientierte Ausführung – Jede ausgeführte Aktion muss direkt dem übergeordneten Ziel dienen. Vermeide unnötige Schritte.

Verwendung

Diese Richtlinien können in Agenten-Konfigurationsdateien eingebettet werden, z. B. in SOUL.md-Dateien für Hermes oder als Konfigurationsparameter für Codex.

Beispiel (SOUL.md)

principles:
  - think_before_acting: true
  - simplicity_first: true
  - surgical_changes: true
  - goal_driven: true

Plattformen

  • Hermes – Via SOUL.md-Konfiguration
  • OpenAI Codex – Als Skill integriert
  • Universal – Für jeden KI-Assistenten anpassbar

Warum dieses Framework?

Diese Prinzipien wurden von Andrej Karpathy basierend auf jahrelanger Erfahrung mit KI-Code-Assistenten destilliert. Sie helfen, häufige Fehler wie Überengineering, unnötige Änderungen oder ziellose Aktionen zu vermeiden. Agenten, die diese Richtlinien befolgen, arbeiten effizienter und liefern konsistentere Ergebnisse.

Lizenz

MIT

Verwandte Skills