Skill vs Rule · Dreistufen-Laden · SKILL.md · 6-Schritte-Runbook · Mac 7×24
Fügen Sie jedes Mal eine lange Eingabeaufforderung „PR + Test + CHANGELOG aktualisieren“ in den Cursor ein? Agent Skill destilliert komplexe Abläufe in wiederverwendbare Runbooks, und mit Rule-Rollenteilung und dreistufigem inkrementellem Laden verhalten sich Ihre 2026-Agenten eher wie Kollegen mit SOPs als wie einmalige Chats. Dieser Artikel richtet sich an Entwickler, die komplexe Eingabeaufforderungen wiederholen. Ein Vergleich von Skill vs Rule, der SKILL.md-Struktur und dem agentskills.io-Ökosystem (Community-Skills 31000+), die Schritte zum Erstellen Ihres ersten Skills mit dem 6-Schritte-Runbook und wie ein Mac Mini M4 pro Monat die Agenten- und Skill-Zusammensetzung rund um die Uhr unterstützt.
Der „KI-Codierungsassistent“ von 2024–2025 wird im Wesentlichen eineKonversationsvervollständigung sein, bei der Sie den Kontext, die Einschränkungen und die Schritte jedes Mal neu erklären müssen. Im Jahr 2026 werden Cursor Agents (2.4+ Skills-Verbesserungen) aufgegeben sein: Repositorys lesen, mehrere Dateien ändern, Tools aufrufen und gemäß den Teamregeln liefern. Wissen sollte mehr als nur ein Chatverlauf sein und als versionierbares Kompetenzpaket externalisiert werden.
Agent Skill ist ein Ordner unter .cursor/skills/ oder Benutzerebene ~/.cursor/skills/. Der Kern ist SKILL.md (YAML-Frontmatter + Markdown-Body), an den Sie Skripte/, Referenzen/, Vorlagen und Checklisten anhängen können. Während der Erkennungsphase liest der Agent nur den Namen und die Beschreibung, und nachdem er die Aufgabe erfüllt hat, aktiviert er den vollständigen Text und lädt bei Bedarf den vollständigen Text und alle erforderlichen Zusatzdateien. Vermeiden Sie es, 50 Seiten Runbooks auf einmal in den Kontext zu stellen.
.cursor/rules Wenn Sie „Kommentare verboten“ und „pnpm erforderlich“ schreiben, ist das eine vollständige Leitplanke. Wenn die gleiche „Veröffentlichung + Codeüberprüfung + Dokumentaktualisierung“ dreimal pro Woche wiederholt wird und Sie die Regel weiter ausweiten, zahlen Sie mehr Token pro Konversation und es wird schwierig, sie mit Kollegen zu teilen. Fertigkeit ist Flow-Wiederverwendung und Regel ist Verhaltensgrenze – sie werden in der Tabelle im nächsten Abschnitt verglichen.
Lange Eingabeaufforderungen können nicht versioniert werden:Gute Anweisungen sind in Notion usw. verstreut und können vom Agenten nicht gelesen werden. Änderungen an einer Stelle erreichen nicht das gesamte Team.
Kontextinflation: Das Einfügen des gesamten Runbooks in eine Konversation nimmt Platz für Code und Unterschiede ein, was dazu führt, dass lange Aufgaben abgeschnitten werden.
Trigger-Instabilität:Eine strukturierte Beschreibung-Routing-Klausel fehlt und der Agent kann nicht bestimmen, welches Handbuch geöffnet werden soll.
Keine Schritt-für-Schritt-Offenlegung:Lange Skripte und API-Dokumentation, selbst für einfache Unteraufgaben wird der volle Preis bezahlt.
Kann vom Team nicht wiederverwendet werden:Erfolgreiche Erfahrungen einzelner Chats wie Git können nicht überprüft, zusammengeführt und zurückgesetzt werden.
Regeln sind Verkehrsregeln, die an der Windschutzscheibe angebracht sind. Fähigkeiten sind im Fahrzeug enthaltene Handbücher – Sie müssen nicht jede Seite umblättern, um das Problem zu finden.
Cursorregeln (.cursor/rules/*.mdc oder Projektregeln) werden immer oder mit Globs injiziert, wie beim Sitzungsstart konfiguriert, und berücksichtigen Codierungsstil, Sicherheits-Redlining und Repository-Strukturkonventionen. Agent-Fähigkeiten sind agentskills.io Folgt offenen Standards (gegenseitige Zertifizierung für mehrere Tools seit 2025) und ist standardmäßig für mehrstufige Workflows, Domänenkenntnisse und ausführbare Skripte geeignet.
| Perspektive | Regel | Agentenfähigkeit |
|---|---|---|
| Ladezeitpunkt | Eingefügt bei Sitzungsstart oder Pfadübereinstimmung | Erkennen → Aktivieren → Referenzen/Skripte bei Bedarf |
| Typische Szene | Kommentare verboten, Commit-Regeln, Framework-Auswahl | PR-Erstellung, Bereitstellungsprüfung, Domänen-API-Integration, /slash-Workflow |
| Kontextbelegung | Bewohner. Wenn die Anzahl der Zeilen groß ist, werden sie kontinuierlich belegt. | Nur Metadaten, wenn sie nicht ausgelöst werden. Gestaffelte Bereitstellung nach Auslöser |
| Auch wenn | Mitarbeiterhandbuch / Compliance-Klausel | Rolle SOP + Toolbox (Skripte, Vorlagen, externe Dokumente) |
Referenzen/ für das On-Demand-Lesen. scripts/validate.sh in der Sandbox auf und gibt das Ergebnis an die Konversation zurück. Die Community verfügt über offizielle/halboffizielle Fähigkeiten wie create-hook, create-rule, babysit (PR-Merge und CI) und split-to-prs. Beziehung zu MCP: MCP stellt eine Verbindung zu externen Systemen her und Skills teilen den Agenten mit, wann und in welcher Reihenfolge sie Tools verwenden sollen – kombiniert, nicht exklusiv.
Das Folgende wurde mit Cursor 2.4+ überprüft. Generieren Sie ein Skelett mit dem integrierten /create-skill und konvergieren Sie es gemäß den Teamregeln. Mein Ziel ist es, die Eingabeaufforderung „Ich konnte beim dritten Versuch endlich schreiben“ zu einem überprüfbaren Ordner im Repository zu machen.
Geben Sie /create-skill in die Agentenkonversation ein:Beschreiben Sie den Aufgabentyp, das Auslösewort, die Eingabe/Ausgabe und die Kontraindikationen und generieren Sie die erste Version SKILL.md und den Verzeichnisbaum.
Bereich auswählen: Projektebene .cursor/skills/<skill-name>/ mit Git geteilt. Die persönliche Klasse ~/.cursor/skills/ ist für Repository-übergreifende Benutzerdefiniert (es wird kein privater Schlüssel festgeschrieben).
Schreiben Sie eine Beschreibung für frontmatter:Dies ist keine Zusammenfassung, sondern ein Routing-Schlüssel. Schreiben Sie „VERWENDEN, wenn der Benutzer fragt …“ und „NICHT verwenden für …“, um die Übereinstimmungsgenauigkeit in der Erkennungsphase zu erhöhen.
Text ist eine schrittweise Offenlegung:Die Kernschritte sind in SKILL.md. Langtext, OpenAPI, JSON-Beispiel unter references/, Skript unter references/ext-sm">scripts/.
Testen Sie den Auslöser:Überprüfen Sie 3 positive Beispiele (sollten aktiviert werden) und 2 Gegenbeispiele (nicht aktiviert) in einer neuen Sitzung. Überprüfen Sie, ob im Kontext nur die erforderlichen Dateien aufgeführt sind.
Alte Assets migrieren: Für aufgeblähte Regeln und einmalige Befehle verwenden Sie /migrate-to-skills (oder teilen Sie es manuell auf), um den Flow-Typ zu Skills zu verschieben. Die Regel hinterlässt nur eine kurze rote Linie.
--- Name: release-pr-runbook Beschreibung: VERWENDEN, wenn der Benutzer eine Release-PR öffnen, eine Versionserhöhung versenden oder die Pre-Merge-Checkliste ausführen möchte. NICHT für Hotfixes ohne Änderungsprotokoll oder für Bumps, die nur auf Abhängigkeiten basieren, verwenden. --- # PR-Runbook veröffentlichen ## Sammeln - Lesen Sie die package.json-Version und die aktuellen Git-Tags. – Listen Sie offene PRs auf, die auf „Hauptziel“ abzielen. ## Akt - Bump-Version pro Semester. - Aktualisieren Sie CHANGELOG.md mit benutzerorientierten Aufzählungszeichen. ## Überprüfen - Testsuite und Lint ausführen. - Bestätigen Sie CI grün, bevor Sie eine Überprüfung anfordern.
| Pfad/Feld | Rolle |
|---|---|
SKILL.md | Erforderlich. frontmatter + main Runbook (< 500 Zeilen empfohlen) |
Name | Kleinbuchstaben-Trennstrich-ID. Entspricht dem Ordnernamen |
Beschreibung | Trigger-Routing-Klausel. Enthält USE when / DO NOT |
scripts/ | Ausführbare Validierung/Generator. Agentenanrufe auf Anfrage |
references/ | Lange Dokumentation, API-Beschreibung. Nach Aktivierung lesen |
assets/ | Vorlage, Diagramm, Beispieleinstellungen (optional) |
Die Implementierung von Cursor's Skills entspricht agentskills.io und kann in drei Ebenen organisiert werden: Sie ist direkt mit der Token-Abrechnung und Stabilität verbunden.
Erkennung:Beim Start oder Scannen werden nur der Name + Beschreibung (ungefähr mehrere Dutzend Token pro Fertigkeit) jeder Fertigkeit geladen, um einen „verfügbaren manuellen Katalog“ zu bilden.
Aktivierung:Fügen Sie nach der Benutzerabsicht oder der Schlüsselwortübereinstimmung den vollständigen Text von SKILL.md ein (normalerweise Hunderte bis Tausende von Token).
Bei Bedarf:Nur laden/ausführen, wenn ein Textlink auf references/*.md verweist oder scripts/* aufruft. Schlagen Sie nicht „jedes Mal ein dickes Buch ganz auf“.
Fügen Sie im Skill-Design einen Entscheidungsbaum in die erste Hälfte des Textes ein (bestimmen Sie zuerst Szene A/B), und dicke Materialien gehen Sie zu Referenzen. Wenn die Skriptausgabe umfangreich ist, fordert der Skill den Agenten auf, nur eine Zusammenfassung der wichtigen Zeilen zurückzugeben, anstatt den vollständigen Text wieder in den Kontext einzufügen.
Punkt:Wenn Sie eine Beschreibung wie eine Marketingzusammenfassung schreiben, werden falsche Auslöser zunehmen. Routing-Regeln (Bedingung + Ausschluss) geschrieben wird. Der offizielle Erstellungs-Skill wird Sie wiederholt nach dem Auslösewort fragen – es ist Ihre Zeit wert.
Hochwertige Kompetenz folgt vier Prinzipien. Drei Phasen: Grundbeschreibung, schrittweise Offenlegung, einzelne Verantwortung (1 Fähigkeit, 1 Aufgabentyp) und Sammeln, Handeln, Verifizieren. Keine Überschneidungen mit Regeln – Regel ist „Test erforderlich“ und Fertigkeit ist „Schritte zum Ausführen von Integrationstests in diesem Repository und zum Lesen von Fehlerprotokollen“.
| Fähigkeit/Regie | Szene zu Angesicht | Wichtige Punkte |
|---|---|---|
| Suche nach Eingabeaufforderungen | Optimieren Sie doppelte Eingabeaufforderungen, vergleichen Sie Community-Vorlagen | Reduzieren Sie die Notwendigkeit, das Rad neu zu erfinden und passen Sie das Schreibformat an |
| React Best Practices | Komponenten, RSC, Leistung und A11y | Vercel/Team-Regeln als manuell externalisieren |
| Babysitter-/PR-Fähigkeiten | PR-Kommentare, CI-Fehler, Zusammenführungskonflikte | GitHub CLI funktioniert mit CI-Protokollen |
| create-rule / create-skill | Governance der Cursor-Konfiguration selbst | Meta-Skill. Vereinheitlichen Sie die Basis Ihres Teams |
| sdk | Cursor-SDK/Agent-API-Integration | Agent programmgesteuert über Backend oder Pipeline aufrufen |
| Schleife | Periodische Patrouille, Agent vom Typ Cron | Erfordert einen stabilen Host 7×24. Siehe Abschnitt 6 |
SKILL.md. /create-skill, /migrate-to-skills in den Standardworkflow. description ist keine Artikelzusammenfassung, sondern ein Routing-Prädikat – die offizielle Dokumentation und der Leitfaden zum Erstellen von Fertigkeiten betonen dies. Hinweis:Schreiben Sie keine privaten Schlüssel oder Kunden-PII in die Beschreibung (immer sichtbar auf L1). Skripte verwenden Umgebungsvariablen. gitignore den vertraulichen Anhang von references/ und erkläre im Skill-Text, wie man ihn erhält.
Das Kompetenz-Ökosystem ist nicht auf eine einzige IDE beschränkt. agentskills.io bietet Standards, Validierungskonzepte und einen Indexeinstiegspunkt, der es Teams ermöglicht, interne Fähigkeiten zu submodulieren und zu veröffentlichen (ähnlich wie internes npm). Ein realistischer Weg für einzelne Entwickler besteht darin, einen Skill in der Nähe der Community abzuzweigen → Beschreibung und Referenzen/ anzupassen → den Unterschied in PR zu überprüfen.
Fähigkeiten erweitern sich von „Codierungsunterstützung“ bis hin zu Automatisierung rund um die Uhr – /loop für geplante Repository-Scans, Telegram/Slack für /mac-quote-Typ-Zitatfluss, Cursor SDK führt den auf der Serverseite residenten Agenten aus – die Hostauswahl wirkt sich auf den Gesamtzins des Skills aus.
~/.cursor/skills als „organisatorisches Gedächtnis“ entwickeln. Typische Konfiguration: fester Projekt-Clone und Skills-Submodule auf dem gemieteten Mac; nach dem Merge läuft scripts/verify.sh per Hook. Der IM-Bot liefert nur die Absicht, die Ausführung erfolgt per Skill auf dem Mac — analog zu Hermes Gateway 7×24 und persistentem Speicher: Agent als Infrastruktur, Cursor Skills näher am IDE-Alltag.
DSGVO und Cloud: Enthalten Skills personenbezogene Daten (Kunden-PII, Tokens in description oder Logs), gehören Verarbeitungszweck, Speicherort und Auftragsverarbeitung in die Runbook-Checkliste. Gemietete Mac-Knoten mit dokumentierter Datenresidenz erleichtern Nachweise gegenüber Compliance — messen Sie Trigger- und Token-Kurven statt Bauchgefühl.
Notebook und günstiges VPS reichen für Skill-Autor und Einmaltests, schwächen aber Sleep, native macOS-Automation und dauerhaftes ~/.cursor für 7×24. Reine API-Skills laufen in der Cloud; sobald Runbooks Keychain oder Apple-Tools brauchen, steigen Migrationskosten. Teams, die Agent Skills als „residenten Kollegen“ mit kumulierenden Token-Einsparungen betreiben, bündeln mit VpsMesh Mac Mini M4 Cloud-Miete Uptime, Remote-KVM und fixe Monatskosten zu planbarem OpEx. Preise: Mac Mini M4 Mietpreise, Setup: Hilfezentrum, Bestellung: Bestellseite.
MCP (Model Context Protocol) ist die Verbindungsschicht zur Außenwelt. Stellen Sie Ihre Datenbank, GitHub-API, Ihren Browser und Ihre internen Microservices als Tools/Ressourcen über den Server bereit. Agent Skill ersetzt MCP nicht, sondern ist ein Markdown-Runbook, das angibt, was in welcher Aufgabe zuerst erfasst werden soll, welche MCP-Tools in welcher Reihenfolge aufgerufen werden sollen und wie überprüft werden soll. Beispiel: MCP ist die Steckdose und das Kabel und Skill ist das Startverfahren im Gerätehandbuch.
Eine kurze Regel, die Sie jedes Mal befolgen sollten, wenn Sie Code schreiben, ist die Regel (Kommentare nicht erlaubt, festgelegter Paketmanager erforderlich usw.). Abläufe, die „gelegentlich durchgeführt werden, viele Schritte umfassen und Skripte und Anhänge erfordern“, sind Fähigkeiten. Faustregel: Wenn dieselbe lange Eingabeaufforderung ein drittes Mal erscheint, /createVerwandeln Sie es mit E-Skill in eine Fertigkeit. Die Gesamtzahl der Regeln sollte gering sein, damit die Sitzung nicht bei L0 voll wird. Der Flussteil der Hypertrophieregel kann mit /migrate-to-skills in den Skill verschoben werden.
Nicht erforderlich. Reine Cloud-API, macOS-unabhängiger Skill kann auf Linux VPS über Cursor CLI/SDK geplant werden. Wenn Sie Apple Eco Automation, den lokalen Schlüsselbund und ~/.cursor/skills nicht durch Schließen des Deckels wie Gateway herunterfahren möchten, ist die monatliche Gebühr für den Mac Mini M4 ganz einfach. Überprüfen Sie zunächst die Trigger- und Token-Kurve mit einer einmonatigen Miete. Der Preis beträgt Mietgebühr für den Mac Mini M4 und die Anwendung ist eine Bestellseite.