Amazon Quick SKILL erstellen: Vollständiger Leitfaden

Dieser Artikel fasst am Beispiel eines echten Falls — der Entstehungsgeschichte des Skills „SEO-Check" — zusammen, welche Arbeiten beim Erstellen eines SKILL anfallen, welche Befehle verwendet werden und welche Fallstricke es gab. Geeignet für alle, die ihre repetitiven Workflows als wiederverwendbare Fähigkeiten verankern möchten.

1. Was ist ein SKILL und warum sollte man ihn erstellen

Ein SKILL ist ein wiederverwendbares Fähigkeitspaket, das einenmehrstufigen Workflowverankert. Einmal erstellt, lässt sich der gesamte Ablauf mit einem Satz auslösen, ohne jedes Mal neu erklären zu müssen.

Ein SKILL ist im Wesentlichen ein Ordner:

skill-name/
├── SKILL.md          ← 核心：流程说明 + 触发词 + 输入 + 经验
├── scripts/          ← 可选：可复用的代码脚本
│   └── *.py
└── evals/            ← 可选：测试用例
    └── evals.json

Signale, dass sich ein SKILL lohnt: Du machst diese Sache wiederholt, die Schritte sind ≥2, es gibt ein klares Ergebnis und es funktioniert auch mit einem anderen Objekt (URL/Kunde/Projekt).

2. Der gesamte Ablauf zum Erstellen eines SKILL (5 Schritte)

Auch das Erstellen eines Skills wird von einem „Meta-Skill" angeleitet. Der Kern sind diese 5 Schritte:

Drei. Schrittweise Zerlegung: Was konkret in jedem Schritt zu tun ist

Schritt 1: Workflow zuerst durchlaufen lassen (am wichtigsten)

Baue nicht voreilig einen Skill. Führe zuerst eine echte Anforderung vollständig durch, zum Beispiel: „Prüfe die SEO dieser Webseite für mich“. Dabei gilt:

• Klar definierenEingabeWas ist die Eingabe (eine URL? eine Reihe von URLs?)
• Klar definierenAusgabeWas ist die Ausgabe (ein Bericht? In welchem Format?)
• Notiere, welche Fähigkeiten in jedem Schritt genutzt wurden (Webseite öffnen, Code ausführen, Excel generieren …)

Praxislektion: Unser SEO-Skill entstand erst, nachdem wir mehrere Seiten der offiziellen Website eines Unternehmens wirklich gründlich geprüft und das Berichtsformat mehrfach angepasst hatten. Zwischendurch stellte der Nutzer immer wieder neue Anforderungen (Bing-Standards ergänzen, offizielle Quellen verifizieren, in eine Ausführungsmatrix umwandeln, in zwei Phasen aufteilen …) – all das wurde zum wertvollsten Teil des Skills.

Schritt 2: Skill-Grundgerüst bestätigen

Der KI klar sagen (oder sie Vorschläge machen lassen):

Schritt 3: Sitzungsdaten extrahieren

Dieser Schritt wird vom Tool automatisch erledigt: Es scannt die gerade erfolgreich durchgelaufene Sitzung, extrahiert die verwendete Werkzeugliste und erzeugt ein SKILL.md-Gerüst mit YAML-Frontmatter. Du musst nur die in Schritt 2 festgelegten Angaben liefern: Skill-Name, Trigger-Wörter, Eingabefelder, Anzeigename, Symbol.

Anweisung:extract_session_data

Schritt 4: SKILL.md schreiben (Kern der Erstellung)

Ergänze auf Basis des Gerüsts folgende Teile:

① Frontmatter (Dateikopf)

---
name: seo-audit-skill
display_name: 「SEO 体检」
description: "一句话说清楚它做什么、什么时候该触发"
icon: "🔍"
trigger: SEO体检 audit 网站优化 网站SEO
inputs:
  - name: page_url
    description: "要体检的页面网址"
    required: true
scripts: [seo_audit.py, seo_matrix.py]
---

② Overview

In 2–3 Sätzen klar machen, was getan wird und wann es zum Einsatz kommt.

③ Workflow (in Schritten)

Jeden Schritt mit Modus (deterministic feste Aktion / agentic erfordert Urteilsvermögen), Eingabe, Ausgabe, Validierungsmethode und Vorgehen bei Fehlern kennzeichnen.Mehr "Warum" erklären, weniger starre "muss/verboten"-Regeln schreiben– die KI, die den Skill ausführt, versteht "Begründungen" besser.

④ Output

Wie das Endergebnis aussieht, das Format klar definieren.

⑤ Lessons Learned (Erfahrungen)

Dies ist die Wasserscheide der Skill-Qualität, unterteilt in vier Blöcke:

• Do: welche Vorgehensweisen wirksam sind
• Don't: welche Fallstricke man meiden sollte
• Common Failures: häufige Fehler + Gegenmaßnahmen
• When to Ask the User: wann man innehalten und jemanden fragen sollte

Praxislektion: In den Lessons unseres Skills stehen echte Stolperfallen – bei Chinesisch kein \uXXXX Escaping verwenden, beim Schreiben von CSV utf-8-sig gegen Excel-Zeichensalat einsetzen, eine ungewöhnlich hohe Rate fehlender Bild-alt-Texte ist meist ein Fehlalarm durch Lazy Loading (als "zu prüfen" markieren statt direkt als fehlend zu werten), manche Domains blockieren Massen-Crawling, daher mit Browser verifizieren … Diese "Tränen und Schweiß" machen den Skill beim nächsten Lauf stabiler.

⑥ Skripte (optional, aber dringend empfohlen)

Wenn im Ablauf Code wiederholt geschrieben wird, in ein Skript auslagern und ablegen unter scripts/, in SKILL.md referenzieren. Wir haben „Page-Signal-Erfassungs-JS“ und „Multi-Page-Matrix-Generierung“ zu zwei Skripten gemacht, um ein konsistentes Ausgabeformat bei jedem Durchlauf zu gewährleisten.

Schritt 5: Speichern + Testen

• Speicheranweisung:save_skill（Skill-Name + vollständige SKILL.md + Skripte）
• Testgenerierung:generate_skill_evals（automatisch einige Testfälle erstellen）
• Danneinmal echt ausführenund validieren – wir haben es in zwei Szenarien getestet, Einzelseite und Mehrseite, und bestätigt, dass echte Probleme erkannt werden (z. B. mehrere 404-Bad-Links aufgespürt, Abweichung zwischen Social-Share-Titel und Seitentitel gefunden).

IV. Iteration und Verteilung nach der Erstellung

Iterative Verbesserung

Anweisung:load_skill_for_improvement. Ein SKILL entsteht nicht in einem Durchgang. Nach einigen Einsätzen bei Bedarf verbessern:

• Ablauf ändern, Ausgabeformat ergänzen, Trigger-Wörter anpassen
• Beim Speicherndenselben Skill-Namen verwenden, um an Ort und Stelle zu überschreiben (die alte Version wird automatisch gesichert)

Praxis: Unser SKILL wurde viele Runden iteriert – Bing-Standard ergänzt, Ausführungsmatrix-Format geändert, in zwei Phasen aufgeteilt, Excel+Markdown-Doppelausgabe ergänzt, Spaltennamen an Beispiel angeglichen, zuletzt umbenannt. Jede Runde war load_skill_for_improvement → ändern → save_skill überschreiben.

Umbenennen

Ändern Sie den name und display_namein den Frontmatter-Angaben, verwenden Sie den neuen Namen save_skill, und löschen Sie dann den alten Skill-Ordner.

Paketieren und verteilen

Den gesamten Skill-Ordner als ZIP packen – so lässt er sich sichern, auf einen anderen Computer migrieren oder an Kollegen weitergeben (in deren skills-Verzeichnis legen).

Portierung auf andere Tools

Für die Nutzung in anderen KI-Tools (ChatGPT/Claude/Gemini) ist eine "Entplattformisierung" nötig: proprietäre Tool-Namen in allgemeine Fähigkeitsbeschreibungen umschreiben ("Webseite öffnen", "Code ausführen") und Skripte als selbstständiges Markdown einbetten – dann lässt sich alles als System-Prompt/benutzerdefinierte Anweisung einfügen.

V. Schnellreferenz gängiger Anweisungen

Sechs. Fallstrick-Checkliste (aus echter Praxis)

1. Erst zum Laufen bringen, dann festigen– Schreib den Skill nicht aus dem Nichts.
2. Nur veränderliche Werte als Eingabe– Feste Werte im Ablauf hart kodieren.
3. Lessons Learned mit echter Erfahrung füllen– Das ist der Schlüssel, ob ein Skill „mit jeder Nutzung stabiler“ wird.
4. Wiederholten Code in Skripte auslagern– Sorgt für konsistentes Ausgabeformat und spart Token.
5. Nach dem Speichern immer testen– Einmal mit Einzelseite + Mehrseite echt durchlaufen, um zu prüfen, ob echte Probleme erkannt werden.
6. Encoding-Fallstrick(bei chinesischem Text/Code-Generierung): Dateien schreiben mit encoding="utf-8", CSV mit utf-8-sig, nicht mit \uXXXX Escaping; PDF-Chinesisch mit integrierter CID-Schrift.
7. Iteration mit gleichem Namen überschreiben——name bleibt unverändert, alte Version wird automatisch gesichert.

Fazit

Die Essenz des SKILL-Erstellens ist:Einen einmal erfolgreichen Workflow samt seiner Urteile und Lehren zu einer Fähigkeit zu verpacken, die „beim nächsten Mal mit einem Satz wiederholbar“ ist. Ein guter Skill dokumentiert nicht nur Schritte, sondern auch die Erfahrung, „wie man diese Sache richtig macht“.

Erst die Sache schön erledigen, dann wiederverwendbar machen – das ist die ganze Kunst des SKILL-Erstellens.