CommunitySchreiben & Editierengithub.com

Agent-Fähigkeit schreiben

Entwerfen, überarbeiten oder prüfen Sie wiederverwendbare KI-Agent-Fähigkeiten und SKILL.md-Anleitungspakete. Verwenden Sie diese Fähigkeit, wenn Sie den Umfang, die Auslösebeschreibung, den Workflow, unterstützende Referenzen oder Skripte, Sicherheitsgrenzen und Bewertungen einer Fähigkeit erstellen oder verbessern möchten; passen Sie die Fähigkeit an den Host-Agenten und an reale Aufgaben an.

Was ist Agent-Fähigkeit schreiben?

Diese Fähigkeit ermöglicht es Entwicklern, strukturierte und ausführbare Anleitungspakete für KI-Agenten zu erstellen, zu überarbeiten oder zu prüfen. Sie konzentriert sich auf die Erstellung einer einzigen, kohärenten und wiederverwendbaren Aufgabe, die durch einen Agenten ausgeführt werden kann. Die Fähigkeit legt besonderen Wert darauf, die Anleitung in realen Aufgaben, Beispielen, Werkzeugumgebungen und vorhandenen Artefakten zu verankern. Sie unterstützt die Definition eines klaren Vertrags zwischen Auslöser und Ausgabe, das Verfassen einer schlanken SKILL.md-Datei mit YAML-Frontmatter und das Testen anhand repräsentativer Fälle. Die Fähigkeit hilft dabei, Sicherheits- und Korrektheitsgrenzen zu setzen, unnötige Schritte zu vermeiden und eine konsistente Auslieferung des gewünschten Artefakts sicherzustellen. Sie ist plattformunabhängig und folgt den Formaten der Host-Plattform (z. B. Claude Code, Cursor, Codex), ohne optionale Metadaten oder Zugriffsrechte vorauszusetzen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rafik-mikhail/write-agent-skill/tree/main

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Agent-Fähigkeit schreiben?

Zielsetzung

Ein ausführbares Anleitungspaket für einen Agenten für eine einzige, kohärente und wiederverwendbare Aufgabe liefern. Verankern Sie es in der Aufgabe des Benutzers, in Beispielen, der Werkzeugumgebung, vorhandenen Artefakten und Korrekturen. Wenn keine realen Beispiele verfügbar sind, kennzeichnen Sie Annahmen und entwerfen Sie minimal testbare Anweisungen, anstatt produktspezifische APIs zu erfinden. Vervollständigen und präsentieren Sie die tatsächlich angeforderte Fähigkeit, nicht nur einen Plan, einen Fortschrittsbericht oder eine Kritik.

Vertrag definieren

  1. Geben Sie den Auslöser an: die Aufgabe und Eingabe, die diese Fähigkeit aktivieren sollte, sowie angrenzende Anfragen, die dies nicht sollten. Schreiben Sie die description als präzise Routing-Regel, die angibt, was sie tut und wann sie verwendet werden soll.
  2. Geben Sie die erforderlichen und optionalen Eingaben, die zulässige Autorität des Agenten, die beabsichtigte Ausgabe und die Definition von „erledigt“ an. Lösen Sie Überschneidungen mit benachbarten Fähigkeiten an der Übergabestelle auf; führen Sie nicht unterschiedliche Stufen nur aufgrund eines gemeinsamen Themas zusammen.
  3. Kennzeichnen Sie, welche Verhaltensweisen obligatorische Sicherheits- oder Korrektheitsgates sind, welche Standardheuristiken sind und welche optionale Erweiterungen sind. Anweisungen können keine Laufzeitberechtigungen erzwingen: Verwenden Sie Plattformkontrollen für Dateisystem-, Netzwerk- und Werkzeugzugriff.

SKILL.md entwerfen

Verwenden Sie YAML-Frontmatter mit einem in Kleinbuchstaben und mit Bindestrich geschriebenen name, der dem Ordner entspricht, und einer spezifischen description. Folgen Sie dem Format und den Fähigkeiten der Host-Plattform; gehen Sie nicht von optionalen Metadaten aus oder dass allowed-tools plattformübergreifend den Zugriff erzwingt.

Halten Sie den Körper schlank: Aufgabe und Grenzen, Eingaben, Entscheidungsverfahren, Stopp-/Fehlerbehandlung, Ausgabevertrag und nicht offensichtliche Fallstricke. Geben Sie einen Standardpfad anstelle eines Menüs mit gleichwertigen Alternativen. Geben Sie genaue Schritte für fragile Operationen an; lassen Sie Raum für begründetes Urteilsvermögen bei der Kontextauswahl. Vermeiden Sie es, dasselbe Verbot in jedem Abschnitt zu wiederholen oder die Antwort einer einmaligen Aufgabe als allgemeines Verfahren einzubetten.

Verschieben Sie umfangreiche Domain-Referenzen in fokussierte references/-Dateien und teilen Sie dem Agenten genau mit, wann er sie lesen soll. Fügen Sie wiederverwendbare Skripte für sich wiederholende deterministische Arbeiten nur hinzu, nachdem Sie deren Laufzeitabhängigkeiten und Validierungsverhalten bestätigt haben. Halten Sie Referenzen direkt von SKILL.md aus erreichbar und behaupten Sie nicht, dass ein Entwurf installiert, ausgeführt oder validiert wurde, wenn dies nicht der Fall ist.

Testen und überarbeiten

Beginnen Sie mit 2–3 repräsentativen Fällen, darunter einem Grenzfall; fügen Sie Fälle mit negativem Auslöser und adversariale Fälle hinzu, wenn die Fähigkeit auf nicht vertrauenswürdigen Inhalten reagiert oder wichtige Grenzen hat. Führen Sie neue Sitzungen mit und ohne die Fähigkeit oder im Vergleich zum vorherigen Entwurf durch. Bewerten Sie beobachtbare Ausgaben und Werkzeugverhalten, nicht wie ausgefeilt die Anweisungen klingen. Untersuchen Sie Traces auf unnötige Schritte, übersehene Beweise, Fehlaktivierungen und Scope Creep. Verwenden Sie Code für mechanische Überprüfungen; lassen Sie Menschen substanzielle Urteile überprüfen. Entfernen Sie Anweisungen, die Kosten verursachen, ohne einen echten Fehler zu verhindern.

Abnahmeprüfung

Bevor Sie antworten, vergewissern Sie sich, dass das vollständige angeforderte Artefakt tatsächlich vorhanden und in sich konsistent ist. Wenn der Benutzer das vollständige Markdown anfordert, liefern Sie die gesamte aktuelle SKILL.md, keine Patch-Fragmente. Wenn Sie eine Datei erstellen, vergewissern Sie sich, dass sie existiert und den vollständigen Entwurf enthält; melden Sie den ungetesteten Status ehrlich. Geben Sie kurz an, was sich geändert hat und welche Validierungsanforderungen noch bestehen. Verwenden Sie eine Anfrage für eine Fähigkeit nicht ohne klare Aufforderung in eine nicht zusammenhängende Suite.

Verwandte Skills