Die Kurzantwort
CLAUDE.md, AGENTS.md und Cursor-Rules stehen in jeder Sitzung im Kontext – beschränk sie also auf Fakten und Grenzen. Ein Skill lädt nur, wenn seine Aufgabe ansteht, und kann daher eine lange Anleitung enthalten, ohne jeden Chat zu belasten.
Wer CLAUDE.md, AGENTS.md und Cursor-Rules liest
Claude Code liest CLAUDE.md, Codex liest AGENTS.md, und Cursor liest seine eigenen Rules plus beide Dateien. Alle drei lesen SKILL.md, aber nur bei Bedarf.
| Datei | Gelesen von | Wann |
|---|---|---|
CLAUDE.md | Claude Code, Cursor | Claude Code: beim Sitzungsstart, aus ~/.claude/CLAUDE.md und dem Projekt; die Datei eines Unterordners, sobald Claude in diesem Ordner arbeitet. Cursor: immer angewendet. |
AGENTS.md | Codex, Cursor | Codex: zuerst ~/.codex/AGENTS.md, dann eine Datei pro Ordner vom Repo-Root bis dorthin, wo du gestartet hast; die nächstgelegene gewinnt; insgesamt 32 KiB. Cursor: immer angewendet. |
.cursor/rules/*.mdc | Cursor | Einer von vier Modi: Always Apply, Apply Intelligently, Apply to Specific Files oder Apply Manually |
SKILL.md | Alle drei | Nur wenn eine Anfrage passt oder du ihn über den Namen aufrufst |
Was in CLAUDE.md gehört und was in einen Skill
Eine gute Faustregel: Passt es in eine Zeile und soll in jedem Chat gelten, ist es eine Anweisung. Braucht es eine Seite zur Erklärung und zählt nur für eine Art von Aufgabe, ist es ein Skill.
| Du willst sagen | Gehört in |
|---|---|
| „Nutze pnpm, nicht npm.“ | Anweisungsdatei |
| „Nie ohne Freigabe deployen.“ | Anweisungsdatei |
| „Führ vor dem Commit die Tests aus.“ | Anweisungsdatei |
| „Wie wir Release Notes schreiben, Schritt für Schritt.“ | Einen Skill |
| „Bau ein Launch-Deck in unserem Markenstil.“ | Einen Skill |
Jede Sitzung
Anweisungsdateien kosten in jedem Chat Kontext, ob du sie nutzt oder nicht
Bei Bedarf
Ein Skill kostet etwa einen Satz, bis er genutzt wird
So verschiebst du eine Anleitung aus CLAUDE.md
Ein typisches Vorher und Nachher
In einer CLAUDE.md wächst langsam ein 60-zeiliger Abschnitt darüber, wie man Release Notes schreibt. Jeder Chat zahlt dafür, Debugging-Sitzungen eingeschlossen. Verschieb ihn in einen Skill, dann bleibt nur eine Zeile zurück, und die Anleitung lädt nur, wenn du nach Release Notes fragst.
- Use pnpm. Never deploy without approval.
- For release notes, use the release-notes Skill.- 1
Schneid die Anleitung aus und füg sie in
.claude/skills/release-notes/SKILL.mdein (oder.agents/skills/für Codex und Cursor). - 2
Schreib eine Beschreibung, die sagt, wann er gebraucht wird.
- 3
Lass in der Anweisungsdatei einen einzeiligen Verweis stehen.
Das solltest du sehen: eine kürzere Anweisungsdatei, und die Anleitung lädt nur, wenn du nach Release Notes fragst.
In Cursor wandelt /migrate-to-skills „Apply Intelligently“-Rules für dich in Skills um.
Häufige Fragen
Was ist CLAUDE.md?
Eine Markdown-Datei mit Anweisungen, die Claude Code zu Beginn jeder Sitzung liest. Deine liegt unter ~/.claude/CLAUDE.md; die eines Projekts unter CLAUDE.md oder .claude/CLAUDE.md.
Sollte ich in Codex AGENTS.md oder Skills nutzen?
Beides. Kurze Regeln, die immer gelten, kommen in AGENTS.md, Anleitungen, die nur bei Bedarf laden sollen, in Skills. Der Codex-Guide behandelt beides.
Sind Cursor-Rules dasselbe wie Skills?
Nein. Rules sind .mdc-Dateien, die Unterhaltungen hinzugefügt werden; Skills sind Ordner, die der Agent nutzt, wenn sie relevant sind oder du sie aufrufst. Siehe den Cursor-Guide.
Quellen
War diese Anleitung hilfreich?
