Eine einzige Zeile in AGENTS.md wie „Commits mit --no-verify erstellen“ schaltet deine git-Hooks für jede Aufgabe des Agenten aus. Ein in CLAUDE.md eingefügtes Token wird bei jeder Anfrage an den Modellanbieter gesendet, und ein HTML-Kommentar, den GitHub nie anzeigt, kann den Agenten zum Ausführen eines Skripts auffordern. Dieser Skill findet solche und sieben weitere Fehler in Agenten-Anweisungsdateien und erklärt, wie du sie behebst.

Dein Agent führt in jedem Projektordner einen Scanner für AGENTS.md, CLAUDE.md und die .claude-Regeln, Subagenten und Slash-Befehle, GEMINI.md, Cursor-.mdc-Regeln und .cursorrules, Copilots copilot-instructions.md und *.instructions.md sowie Windsurf- und Cline-Regeln aus. Er unterscheidet Verbote von Anweisungen („Niemals --no-verify verwenden“ ist in Ordnung), behandelt HTML-Kommentare und unsichtbares Unicode als versteckten Text, liest @path-Importe wie Claude Code (relativ zur Datei, außerhalb von Code) und gleicht die Frontmatter-Schlüssel jedes Werkzeugs mit dessen Dokumentation ab. Er führt niemals aus, was die Dateien anweisen. Er liefert BLOCK, REVIEW oder NOT FLAGGED mit Datei, Zeile, Begründung und sichererem Vorgehen. Geheimnisse werden nie ausgegeben.

Was geprüft wird

BLOCK (vor der Weitergabe beheben)

• A01: Passwörter, Tokens und API-Schlüssel in den Anweisungen oder darin importierte @.env- und Schlüsseldateien

• A02: Anweisungen zum Abschalten von Schutzmaßnahmen: --no-verify, --dangerously-skip-permissions, --yolo, Force-Push auf main, rm -rf ~, niemals vor Löschungen oder Deployments nachfragen, fehlgeschlagene Tests löschen

• A03: versteckter Text: HTML-Kommentare mit Befehlen oder Täuschungen, Unicode-Tag-Zeichen, erzwungene Schreibrichtungsänderungen und Folgen von Zeichen ohne Breite

• A04: Anweisungen, Aktionen vor dem Nutzer zu verbergen, Nutzer- oder Systemanweisungen zu überschreiben oder Geheimnisse an eine externe Adresse zu senden

REVIEW (vor der Veröffentlichung prüfen)

• A11: Dateien, die länger sind, als das Werkzeug zuverlässig liest (CLAUDE.md über 200 Zeilen, .mdc-Regeln über 500, AGENTS.md über 32 KiB)

• A12: @path-Importe, mdc:-Links und Markdown-Links auf nicht vorhandene Dateien

• A13: nicht funktionierendes Regel-Frontmatter: .md-Dateien in .cursor/rules, alwaysApply zusammen mit globs, globs statt paths, *-Muster ohne Anführungszeichen

• A14: Downloads, die per Pipe an eine Shell übergeben werden (curl | sh, iwr | iex)

• A15: Installationsbefehle für einen Paketmanager, den das Projekt nicht verwendet

• A16: persönliche Benutzerordnerpfade wie C:\Users\name oder /Users/name

Das ist enthalten

• Der Scanner (Python 3.9+, ausschließlich Standardbibliothek)

• Ein Regelhandbuch mit Begründung und sichererem Vorgehen zu jeder Regel

• Ein riskantes und ein sicheres Beispielprojekt sowie der tatsächliche Scanner-Bericht zum riskanten Beispiel

Grenzen

Der Scanner liest jede Datei in ihrer vorliegenden Form: Skills in .claude/skills, Benutzerdateien außerhalb des Projekts (~/.claude/CLAUDE.md, ~/.codex/AGENTS.md, globale Cursor- oder Windsurf-Regeln), Einstellungen zur Dateiauswahl und Inhalte importierter Dateien, die keine Anweisungsdateien sind, werden nicht geprüft. Ob ein Satz eine Anweisung oder ein Verbot ist, wird anhand seiner Formulierung entschieden; ungewöhnliche Formulierungen können daher übersehen werden. NOT FLAGGED ist keine Garantie.

Inhalt

Eine ZIP-Datei mit 30 Dateien: SKILL.md, der Scanner in scripts/ (4 Python-Dateien), references/rules.md (alle Regeln mit Begründung und sichererem Vorgehen) und examples/ (23 Beispieldateien plus report.md, die tatsächliche Scanner-Ausgabe zum riskanten Beispiel).

So funktioniert es: Dies ist ein Agenten-Skill: ein Ordner mit einer SKILL.md-Datei und Python-Skripten, die ein KI-Programmieragent wie Claude Code, Cursor oder Codex CLI ausführen kann. Entpacke das Archiv in den Skills-Ordner deines Agenten (für Claude Code: ~/.claude/skills/) und bitte deinen Agenten anschließend, dein Projekt zu prüfen. Die Skripte lassen sich auch eigenständig mit Python 3.9 oder neuer ausführen, ohne zusätzliche Installation. Sie lesen ausschließlich deine Dateien: kein Netzwerkzugriff, keine Datenübertragung.