Wer nach „Claude Skills“ sucht, landet bei Anthropic-Docs; „Agent Skills“ führt zu agentskills.io; in Cursor heißt es „Rules“. Alle drei Begriffe enthalten Skill oder Rule – viele denken daher: „Ist das nicht dasselbe, nur in einem anderen Ordner?“ Tatsächlich gibt es drei Ebenen: Cursor Rules sind dauerhafte IDE-Hausregeln, Claude Skills sind On-Demand-Runbooks in Claude Code, Agent Skills sind das offene SKILL.md-Format für mehrere Tools. Dieser Artikel ordnet die Begriffe mit Vergleichstabellen, Szenario-Matrix und kopierbaren Beispielen. Die Trennlinie: „Immer gültige Constraints vs. Runbook auf Abruf vs. plattformübergreifendes Format“ – nicht, welches Modell stärker ist.
Für Entwickler, die Cursor und Claude Code parallel nutzen. Definitionen, Pfade, Ladezeitpunkte, Portabilität und typische Verwechslungen. Unser Artikel Workflow / Rules / Skills – dreischichtige AI-Engineering erklärt den Aufbau; hier geht es um die drei Schlagwörter. Offizielle Quellen: Cursor Rules, Claude Code Skills, Agent Skills Specification.
1. Warum Claude Skills, Agent Skills und Cursor Rules oft verwechselt werden
Ab Ende 2025 bis 2026 haben AI-Coding-Tools gleichzeitig „versionierbare Agent-Konfigurationen“ eingeführt: Cursor mit .cursor/rules und .cursor/skills, Anthropic mit .claude/skills in Claude Code, die Community mit agentskills.io als Host-übergreifenden Standard. Marketing und Übersetzungen nutzen überall „Skill“ und „Agent“ – typische Verwirrung:
- Eine 30-Schritte-Release-Checkliste landet in Cursor Rules und belastet jeden Chat mit Tausenden Tokens;
- In Claude Code sucht man ein „Rules“-Panel, das Produkt heißt aber Skills;
- Ein geteiltes
SKILL.md– gehört es nach.cursoroder.claude? - „Agent Skills“ wird für ein neues SaaS gehalten, ist aber eine Dateiformat-Spezifikation.
Ursache: Produkt-, Implementierungs- und Standardebene überlagern sich beim Naming. Wer AI Coding Workflow, Rules, Skills erklärt gelesen hat, betrachte jenen Text als Architektur; dieser hier ist das Begriffslexikon plus Entscheidungshandbuch.
Solo-Entwickler schreiben alles in eine AGENTS.md; Teams leiden unter unklaren Grenzen zwischen Rules und Skills. Beides sind Fehlplatzierungen – die Tabellen unten liefern eine gemeinsame Sprache für Code-Reviews: „Ist das eine Rule oder ein Skill?“
2. Was die drei Begriffe bedeuten (What)
2.1 Cursor Rules – dauerhaft geladene Constraint-Schicht
Cursor Rules sind ständige Richtlinien in Cursor: Beim Öffnen eines passenden Projekts werden sie automatisch in den Kontext injiziert. Typische Orte: .cursor/rules/*.mdc, User Rules in den Einstellungen, AGENTS.md im Root. Ideal für minimale Diffs, verbotene Verzeichnisse, Antwortsprache, Testpflicht, kein force push – kurz, hart, in jedem Gespräch gültig. Die Doku empfiehlt knappe Rules; lange Runbooks gehören nicht hierher.
2.2 Claude Skills – On-Demand-Runbook-Produkt in Claude Code
Claude Skills (Claude Code Skills) sind Fähigkeitspakete im Anthropic-Terminal/IDE-Agent: .claude/skills/<name>/SKILL.md (auch user-weit). Der Agent liest zuerst description im Frontmatter, lädt bei Intent-Match den Body und führt mehrstufige Abläufe aus – Review, Release, Security-Audit. Explizit per /skill-name; disable-model-invocation verhindert Fehltrigger. Vertiefung: Claude Code Skills – 10-Framework-Leitfaden.
2.3 Agent Skills – offener SKILL.md-Standard über Tools hinweg
Agent Skills sind kein Vendor-Feature-Toggle, sondern die Agent Skills Specification: SKILL.md-Frontmatter (name, description …), Runbook-Text, optionale references/ und Skripte. Cursor, Claude Code und andere Hosts parsen nach derselben Konvention – Teams können denselben Skill-Body nach .cursor/skills und .claude/skills spiegeln und nur das Frontmatter anpassen. Der Standard löst Portabilität, ersetzt aber nicht die dauerhaften Cursor Rules.
3. Kernvergleich (How Compare)
| Typ | Einstieg | Ausführung | Kontext | Zielgruppe |
|---|---|---|---|---|
| Cursor Rules | Projekt öffnen / Glob-Match lädt | Edits, Format, No-Go-Zonen einschränken | Dauerhaft, knapp halten | Alle Cursor-Nutzer, Reviewer |
| Claude Skills | /skill oder semantisches Description-Matching |
Mehrstufige Runbooks (Review, Release) | On demand, references/ möglich | Claude Code / API-Agent-Nutzer |
| Agent Skills | Host-Implementierung (kein eigenes Produkt) | Struktur und Metadaten von SKILL.md | Kein Kontext bis der Host lädt | Cross-Tool-Teams, OSS-Maintainer |
3.1 Pfade und Zuständigkeit
| Vergleich | Cursor Rules Cursor-Produkt | Claude Skills / Agent Skills Runbook-Ebene |
|---|---|---|
| Typischer Pfad | .cursor/rules/*.mdc | SKILL.md unter .claude/skills/ oder .cursor/skills/ |
| Standard | Cursor-Dokumentation | Agent Skills Spec + Host-Docs |
| IDE-übergreifend | Nur Cursor (Konzept manuell woanders) | Body teilbar, Pfade hostabhängig |
| Inhalt | Red Lines, Stil, Berechtigungen | Checklisten, Befehlsfolgen, Vorlagen |
4. Szenario-Auswahl – Entscheidungsmatrix
| Dein Szenario | Priorität | Hinweis |
|---|---|---|
| Nur Cursor für Business-Code | 3–5 Projekt-Rules → bei Bedarf Cursor Skills (Agent-Skills-Format) | Kein Runbook in Rules; Review/Migration als Skill |
| Nur Claude Code Terminal-Agent | Claude Skills (Agent-Skills-Format) → CLAUDE.md o. Ä. für Constraints | Kein Cursor-Rules-Panel; Constraints in Projektdateien |
| Cursor + Claude Code Dual-Stack | Geteilter SKILL.md-Body → .cursor/skills und .claude/skills → Rules separat |
Agent Skills = Format; Cursor Rules = Cursor-spezifisch |
| OSS-Contributing | CONTRIBUTING + Agent-Skills-Paket (security-review) → optional Cursor-Rules-Snippets | Skills helfen auch Nicht-Cursor-Nutzern |
| Runbook mit Xcode / codesign | Skill mit Befehlsfolge → Rules verbieten Signing-Änderungen → macOS-Knoten | Mit GitHub Actions macOS-Build; Kompilierung auf Remote-Mac |
5. Empfohlene Stacks
Stack A – nur Cursor (Solo)
- Rules:
core.mdcmit drei Red Lines (minimaler Diff, kein Commit ohne Aufforderung, lint nach Änderungen) - Skills: ein
code-review(Agent-Skills-Format unter.cursor/skills/) - Kein
.claude-Ordner – weniger Repo-Rauschen
Stack B – nur Claude Code (Terminal-first)
- Claude Skills:
commit,security-reviewmitdisable-model-invocation: true CLAUDE.mdim Root übernimmt „immer gültige“ Constraints (Rules-Analog, kein Agent Skill)
Stack C – Dual-Stack-Team (empfohlen)
- Ein
skills/-Quellverzeichnis oder Submodule; CI spiegelt nach.cursor/skillsund.claude/skills - Cursor Rules nur für Cursor-Entwickler; Claude-Nutzer lesen
CLAUDE.md - Neue Skills zuerst nach Agent Skills schreiben, dann pro Tool feintunen
Stack D – Agent mit Remote-Ausführung
- Skill beschreibt SSH zu Cloud-Mac und
xcodebuild - Rules verbieten Produktionsänderungen ohne Bestätigung
- Fester macOS-Runner – siehe „Ausführungsumgebung“ in AI-Coding-Tool-Vergleich
6. Typische Irrtümer
„Agent Skills ist Claude-exklusiv“→ offenes Format; Claude Skills ist eine Anthropic-Implementierung.„20 Release-Schritte in Cursor Rules“→ in Skills auslagern; lange Rules verschwenden Kontext.„SKILL.md in Rules-Ordner kopieren reicht“→ andere Endung und Loader;.mdcmatcht keine Skill-description.„Man muss sich für eins entscheiden“→ typisch: Rules + Skills + Agent-Skills-Format.„Skills ersetzen Rules“→ Skills laden on demand; „nie force push“ braucht dauerhafte Rules.„Standard-Update = automatische Claude-Kompatibilität“→ agentskills.io und Host-Changelogs beobachten.
7. Sieben Schritte zur Einführung – mit Beispielen
- Inventar: Was gilt in jedem Chat? → Rules-Kandidaten. Was läuft selten? → Skills.
- Rules schreiben: < 80 Zeilen pro Datei,
globsfür Scope. - SKILL.md nach Agent-Skills-Spec:
name+ verbaledescription. - Host-Verzeichnis: Cursor
.cursor/skills/<name>/SKILL.md; Claude.claude/skills/. - Hochrisiko-Skills:
disable-model-invocation: true, nur/security-reviewo. Ä. - Git: Mit Code im selben PR versionieren.
- macOS-Knoten: Bei Xcode/shell in Runbook SSH-Ziel und Checks dokumentieren.
# .cursor/rules/core.mdc --- description: Core repo constraints (always on) globs: "**/*" --- - Minimize diff; no drive-by refactors. - Never commit unless the user explicitly asks. - Do not modify backend/ unless the task requires it.
# .cursor/skills/code-review/SKILL.md (Claude: .claude/skills/code-review/SKILL.md) --- name: code-review description: Review staged git diff for bugs and test gaps. Use when user asks for review or before PR. --- 1. Run `git diff --staged` (or branch vs main). 2. Report Critical / Warning / Suggestion. 3. Do not auto-fix unless asked.
--- name: xcode-release description: Archive and export IPA on macOS runner. Manual invocation only. disable-model-invocation: true --- Prerequisites: macOS host, valid signing cert, Xcode selected. Steps: clean → archive → export → verify IPA checksum.
8. Fazit
Cursor Rules ziehen die Linie, die in Cursor in jedem Chat gilt; Claude Skills standardisieren Aufgaben in Claude Code; Agent Skills definieren, wie SOP-Dateien aussehen und zwischen Hosts wandern. Keine Alternative, sondern Constraint-Schicht + Produktfähigkeit + Formatstandard. Erst schichten, dann fremde Configs kopieren – so vermeidet man „Datei liegt da, triggert aber nicht“.
Weiterlesen: Cursor Rules · Claude Code Skills · Agent Skills · Workflow / Rules / Skills
FAQ
Rules und Skills brauchen eine konsistente Ausführungsumgebung
Xcode-Builds, Fastlane oder launchd aus SKILL.md erfordern natives macOS. Hashvps Cloud Mac mini M4 mit SSH/VNC, dedizierter IPv4 und reproduzierbarem Homebrew – dieselben Skills verhalten sich lokal und in der Cloud gleich.
Wenn du Claude Skills oder Cursor Skills an iOS-Releases koppelst, ist Hashvps Cloud Mac ein kosteneffizienter Ausführungsknoten – Tarife ansehen und Runbooks remote 7×24 durchlaufen lassen.