Prompts

SKILL.md prüfen: Portabilität und häufige Fehler (Prompt)

Liest die Hauptdatei eines Agent Skills und findet Portabilitätsprobleme und häufige Fehler. Du fügst die ganze SKILL.md ein, inklusive des Frontmatter-Blocks mit `---`.

Sprachen: English · Español

Aus dem englischen Prompt übersetzt. Die englische Version ist die, die wir getestet haben.

Der Prompt

Kopiere den Prompt, füge ihn in deinen Chatbot ein und ersetze die Texte in eckigen Klammern durch dein Material. Der Assistent antwortet auf Deutsch.

Schreibe deine gesamte Antwort auf Deutsch (zitierten Quelltext, Schlüsselnamen, Dateinamen und Ersatztext lässt du in der Originalsprache).

Du prüfst die Hauptdatei eines Agent Skills auf Portabilität und häufige Fehler, nur durch Lesen. Zitiere zu jedem Befund die Zeile dahinter. Behaupte nie, dass der Skill gültig oder portabel ist, und erfinde keine Befunde.

Prüfe:
1. Fehler (Errors): Frontmatter fehlt oder ist nicht geschlossen; Frontmatter, das ein strikter YAML-Parser ablehnen würde (ein unquotiertes ": " oder " #" in der description, ein nicht geschlossenes Anführungszeichen, eine verirrte eingerückte Zeile); fehlendes name oder description; ein name, der nicht aus Kleinbuchstaben, Ziffern und einzelnen Bindestrichen besteht oder über 64 Zeichen lang ist (und, wenn du es erkennen kannst, nicht zum Ordnernamen passt); eine description über 1024 Zeichen; Markdown-Links auf Dateien, die wahrscheinlich nicht existieren.
2. Warnungen (Warnings): Frontmatter-Schlüssel außer name und description (license, compatibility und metadata sind Schlüssel der Spezifikation: vermerke sie; allowed-tools und andere sind toolspezifisch); eine description, die nicht sagt, wann der Skill zu nutzen ist ("Use when the user says ..."); Namen herstellerspezifischer Tools (WebFetch, Skill tool, Bash(...), mcp__) und herstellerspezifische Pfade (.claude/, .cursor/); ein Text, der sich auf das Web, eine Shell oder ein Skript stützt, aber nie sagt, was zu tun ist, wenn sie fehlen; Text wie $ARGUMENTS oder $0, den manche Tools ersetzen; ein Text, der über 500 Zeilen lang aussieht.
3. Gib zu jedem Befund die Zeile an, in einem Satz, warum es wichtig ist, und den genauen Ersatztext.
4. Schließe damit, was du durch Lesen nicht prüfen konntest (ob die Anweisungen funktionieren, ob der Skill auslöst, Dateien außerhalb dessen, was ich eingefügt habe).
Ändere nichts.

Hier ist meine Skill-Datei:

Ein echtes Beispiel (auf Englisch)

Das Beispiel bleibt auf Englisch, weil es das Ergebnis des ursprünglichen Tests ist. Der übersetzte Prompt antwortet auf Deutsch.

Our own public skills repository on 2026-10-04: it had grown to 15 skills, and a new one was skipped by npx skills add proskillpacks/skills --list with a YAML error. The same rule, run over our whole tree of 57 skills, found 7 descriptions with an unquoted colon (now fixed), and the checker's other warnings led us to add fallback sentences and remove a vendor tool name.

After (skill output, excerpt):
$ python3 scripts/skill_check.py proskillpacks-skills/skills --quiet
skill errors warnings lines scripts
accessibility-quick-audit 0 0 39 -
changelog-from-commits 0 0 39 -
readme-first-run-check 0 0 39 -
agent-ready-quick-check 0 0 64 Python
late-payment-chaser-uk 0 0 109 Python
...
15 skill(s): 0 error(s), 0 warning(s)

$ python3 scripts/skill_check.py examples/bad-yaml-colon/SKILL.md
ERROR frontmatter: line 3: description: unquoted ': ' inside the value (strict YAML reads it as a nested mapping). Quote the value or reword

Grenzen

  • Er liest Dateien. Er kann nicht sagen, ob die Anweisungen eines Skills funktionieren oder ob er auslöst.
  • Warnungen sind Portabilitätsrisiken, kein Beweis für einen Defekt.
  • Die Listen der herstellerspezifischen Muster sind nicht vollständig.

Mehr