2026 Agent Skill Guide: Cursor SKILL.md, agentskills.io Open Standard und Mac Cloud 7×24 Betrieb

Ca. 15 Min. Lesezeit · MACCOME

Wenn Ihr Team in Cursor taeglich Deploy-Checklisten, PR-Vorlagen und Testbefehle neu einfuegt, aber der Agent Prozesse nicht ueber Sitzungen hinweg behaelt, ist dieser Guide fuer Entwickler und DevOps in der EU gedacht. Sie erhalten: klare Grenzen zwischen Skill, Rule und MCP, die SKILL.md-Spezifikation nach agentskills.io, ein achtstufiges Runbook sowie eine Entscheidungsmatrix fuer 7×24 Mac Cloud inklusive Datenschutz- und DSGVO-Aspekten. Aufbau: sechs Pain Points, Vergleichstabellen, dreistufiges Laden, acht Schritte, Oekosystem-Kennzahlen, Host-Matrix, FAQ.

Sechs Pain Points: Warum lange Prompts in Produktion scheitern

Anthropic veroeffentlichte Agent Skills Ende 2025 als offenen Standard; 2026 lesen Cursor 2.4+, Claude Code, Gemini CLI und GitHub Copilot dieselbe SKILL.md-Struktur. Dennoch sehen wir in deutschen Teams wiederkehrende Fehlermuster:

  1. Jede Sitzung beginnt bei null: Deploy-, PR- und Test-SOPs sind nicht wiederverwendbar; Onboarding-Kosten wachsen linear mit der Teamgroesse.
  2. Kontext durch globale Rules blockiert: 200 Zeilen Workflow in einer Rule verdrängen echten Code-Kontext und erhoehen Token-Kosten messbar.
  3. Verwechslung OpenClaw Skills und Cursor Skills: OpenClaw lebt im Gateway/ClawHub-Oekosystem (siehe OpenClaw MCP/ClawHub Runbook); Cursor Skills sind editorseitige Runbooks mit anderem Pfad und Trigger.
  4. description als Zusammenfassung statt Routing-Schluessel: Der Agent matcht nicht; Nutzer interpretieren das als defekten Skill.
  5. Monolith-Skills: Deploy, Security und Tests in einem Ordner erhoehen Wartungsaufwand statt ihn zu senken.
  6. Skill ohne Dauer-Host: Hooks und Cron-Jobs auf dem Laptop brechen bei Schlafmodus ab (analog zum Hermes-Gateway-Guide).

Definition: Ein Skill ist ein wiederverwendbares Runbook, das nur bei passender Aufgabe vollstaendig geladen wird — nicht bei jedem Chat-Start.

Skill vs Rule vs MCP: Entscheidungsmatrix

Dimension Rule Skill MCP
Ladezeitpunkt Dauerhaft in der Sitzung Metadata → Match → Volltext Bei Tool-Aufruf
Typischer Inhalt Naming, Git-Sicherheit, Marken-CI Mehrstufige Workflows, Runbooks Externe APIs, DB, Browser
Kontext-Kosten Fix belegt Progressive Disclosure Nur Rueckgabe des Aufrufs
DSGVO-Relevanz Keine Datenhaltung Keine PII in description AV-Vertrag mit Tool-Anbieter noetig

Dreistufiges Laden: Discovery → Aktivierung → On-Demand

Cursor folgt der agentskills.io-Spezifikation:

  • Level 1 Discovery: Beim Start nur name + description pro Skill — entscheidet die Relevanz.
  • Level 2 Aktivierung: Bei Match wird SKILL.md vollstaendig gelesen und Schritt fuer Schritt ausgefuehrt.
  • Level 3 On-Demand: references/ bei Bedarf; scripts/ liefern nur stdout/stderr in den Kontext, nicht den Quellcode.

Pfade: .cursor/skills/ (Projekt), ~/.cursor/skills/ (global), .agents/skills/ (Claude Code / Codex / Gemini CLI). Manuell: /skill-name oder @skill-name.

SKILL.md: Verzeichnisstruktur und Frontmatter

text
.cursor/skills/deploy-app/
├── SKILL.md          # Pflicht
├── scripts/          # optional: deploy.sh, validate.py
├── references/       # optional: Schema, Compliance-Texte
└── assets/           # optional: Templates

description ist Routing-Schluessel

markdown
---
name: deploy-app
description: >-
  Wenn der Nutzer eine App deployen, "Release", "Staging/Production"
  oder CI/CD-Konfiguration erwaehnt.
paths:
  - "apps/web/**"
disable-model-invocation: false
---

# App deployen

## Schritte
1. `scripts/validate.py` fuer Umgebungsvariablen.
2. `scripts/deploy.sh <environment>` ausfuehren.
3. Health-Check; bei Fehler Rollback laut Abschnitt unten.
info

Hinweis: In Cursor Agent /create-skill fuer ein normkonformes Geruest; ab 2.4+ auch /migrate-to-skills fuer Legacy-Rules.

Acht Schritte: Vom leeren Ordner zum ausloesbaren Skill

  1. Einzelne Verantwortung waehlen: z. B. nur „PR erstellen“, nicht Deploy mischen.
  2. Ordner anlegen: .cursor/skills/ihr-skill-name/; Name = YAML-name (Kleinbuchstaben, Bindestriche).
  3. SKILL.md schreiben: Frontmatter + Gather → Act → Verify im Fliesstext.
  4. (Optional) scripts/: Deterministische Logik in Bash/Python auslagern.
  5. (Optional) references/: Lange Docs und API-Schemas; Haupttext unter 500 Zeilen halten.
  6. Settings → Rules pruefen: Skill-Liste und description-Vorschau sichtbar?
  7. Regression mit echten Trigger-Phrasen: z. B. „Bitte staging deployen“; description nachjustieren.
  8. Versionieren: Projekt-Skills ins Git; persoenliche Skills unter ~/.cursor/skills/.

2026-Oekosystem: drei belastbare Kennzahlen

  • Standard-Timeline: Repo agentskills/agentskills seit 2025-12-16 (Apache-2.0); Spec unter agentskills.io/specification aktiv gepflegt.
  • Marktplatz-Groesse (Anfang 2026): Aggregatoren listen 31.000+ Skill-Eintraege — Fork-Duplikate abziehen; Maintainer und Stars pruefen.
  • Engineering-Trends: Vercel React Best Practices (40+ Regeln), Web Design Audit, PR/TDD-Workflows; fuer EU-Teams: keine personenbezogenen Daten in Skill-Metadaten speichern (Datenschutz by Design).

MACCOME-Szenario: Skills fuer Miet-Workflows

Fuer wiederkehrende Angebots- und Vertragsprozesse eignen sich z. B. /mac-quote (Modell + Laufzeit → Preistabelle) und /contract-draft (Standardklauseln). Preise bleiben in internen APIs/MCP — der Skill beschreibt nur Pruefpunkte. Kombination mit OpenClaw/OpenHuman auf gemietetem Mac: Gateway getrennt von Cursor-Repo-Skills.

Host-Matrix: Skill-Qualitaet ohne Uptime reicht nicht

Host 7×24 Skill-Szenario Schwaeche
MacBook privat Schlafmodus bricht ab Skill-Entwicklung tagsueber Keine zuverlaessigen launchd-Hooks
Linux VPS Hoch Reine CLI-Skills Kein Xcode, keine native Apple-Toolchain
Gemieteter Mac Mini M4 Rechenzentrum-Uptime Cursor SSH Remote, launchd, Gateway Monatskosten + Datenexport planen (DSGVO)

Fazit: Prozess in den Skill, Verfuegbarkeit in die Mac Cloud

Mit dem achtstufigen Runbook laesst sich der erste ausloesbare Skill in 1–2 Stunden produktiv setzen. Die Grenzen alternativer Ansaetze sind klar: (a) Ueberlange Rules fressen dauerhaft Kontext; (b) Community-Skills ohne description-Tests triggern unzuverlaessig; (c) lokale Cron-Jobs scheitern am Schlafmodus. Fuer EU-Betrieb zusaetzlich: Speicherort dokumentieren, AV-Vertrag mit Cloud-Anbieter, Loeschkonzept bei Vertragsende.

Wenn Skills Ihre Delivery-Prozesse stabilisieren und Sie SSH in Minuten, fixe Monatsgebuehr und Export von Projekt plus .cursor/skills/ vor Kuendigung brauchen, ist ein dedizierter MACCOME Mac Mini M4 die belastbare Wahl: echtes Apple Silicon, kompatibel mit Cursor Remote und launchd. Regionen und RAM: Mietpreise; Betrieb: Hilfe-Center.

Haeufige Fragen

Agent Skill vs MCP?

MCP liefert externe Faehigkeiten; Skills definieren wann und wie der Agent sie nutzt. Best Practice: Tool-Namen im Skill referenzieren.

Globaler vs Projekt-Skill?

PR- und Test-Workflows nach ~/.cursor/skills/; produktspezifisches Deploy ins Repo unter .cursor/skills/ mit Code-Review.

Welche Cursor-Version?

Ab 2.4+ stabil; danach /migrate-to-skills und Trigger-Regression empfohlen.

7×24-Skripte auf welchem Host?

Fuer dauerhafte Automatisierung siehe Mietpreise und waehlen Sie einen dedizierten Mac-Knoten mit dokumentiertem Speicherort.