agentkitco/agentkit-dev-skills

Überprüft AGENTS.md-, CLAUDE.md-, Cursor-Regel- oder Copilot-Instructions-Dateien auf veraltete Befehle, defekte Pfade, vage Regeln, Geheimnisse und Widersprüche. Verwende diesen Skill, wenn du aufgefordert wirst, Anweisungen für KI-Agenten zu überprüfen, zu kürzen oder zu prüfen.

Was ist agentkit-dev-skills?

Dieser Skill führt ein automatisiertes Audit von Konfigurationsdateien für KI-Agenten (wie AGENTS.md, CLAUDE.md, Cursor-Regeln oder Copilot-Instructions) durch. Er identifiziert fehlerhafte, veraltete, vage oder riskante Zeilen und schlägt eine präzise, korrigierte Version vor. Der Skill unterstützt die Plattformen Claude Code, Cursor und GitHub Copilot, indem er typische Dateien wie CLAUDE.md, .cursor/rules/*.mdc, .github/copilot-instructions.md und .github/instructions/*.md analysiert. Zusätzlich prüft er manuell, ob referenzierte Skripte, Makefile-Targets oder pyproject.toml-Einträge tatsächlich existieren, und vermeidet das Ausführen von gefährlichen Befehlen wie deploy, migrate oder delete. Das Ergebnis wird in einem strukturierten Bericht mit den Kategorien „Muss korrigiert werden“, „Sollte gekürzt werden“, „Widersprüche“ und „Nicht verifiziert“ zusammengefasst. Der Skill stellt sicher, dass jede Beanstandung durch handfeste Beweise (z. B. fehlende Dateien oder fehlschlagende Befehlsausführungen) gestützt wird, und verhindert das Hinzufügen neuer Regeln während des Audits.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor

npx skills add https://github.com/agentkitco/agentkit-dev-skills/tree/HEAD/skills/agents-md-audit

Dokumentation

Eine Anweisungsdatei für Agenten auditieren

Ziel: Finde Zeilen in einer Anweisungsdatei, die falsch, veraltet, vage oder riskant sind, und schlage eine kürzere, korrekte Version vor. „Korrigiere“ niemals einen Befehl, den du nicht ausgeführt hast, oder einen Pfad, den du nicht überprüft hast.

Schritte

Finde die Dateien. Suche nach AGENTS.md, CLAUDE.md, CLAUDE.local.md, .claude/rules/*.md, .cursor/rules/*.mdc, .cursorrules, .github/copilot-instructions.md und .github/instructions/*.md. Liste auf, was du gefunden hast und wer welche Datei liest.
Führe den Checker aus vom Repository-Stammverzeichnis, um zuerst mechanische Ergebnisse zu erhalten: python3 scripts/audit_instructions.py <datei> [<datei> ...] (Der Pfad ist relativ zum Ordner dieses Skills; verwende den vollständigen Pfad zum installierten Skill.) Der Checker meldet: Länge, kaputte Dateipfade, Befehle, die ein Skript oder Make-Target nennen, das nicht existiert, vage Formulierungen, übrig gebliebene [BRACKET]-Platzhalter, doppelte Zeilen und geheimnisaussehende Zeichenketten. Falls Python nicht verfügbar ist, führe dieselben Prüfungen von Hand durch.
Überprüfe jeden Befehl selbst. Bestätige für jeden Befehl in der Datei, dass er existiert (Skript in package.json, Target in Makefile, Eintrag in pyproject.toml). Führe die günstigen, sicheren Befehle aus (Lint, Unit-Tests, Typprüfung). Führe keine deploy-, migrate- oder delete-Befehle aus; liste sie als „nicht verifiziert“.
Überprüfe die Beurteilungen, die das Skript nicht treffen kann:
- Regeln, die ein Linter oder Formatter bereits durchsetzt (Kandidaten zum Löschen).
- Regeln, die sich widersprechen, oder die einer anderen Anweisungsdatei widersprechen.
- Fakten, die der Agent in Sekunden aus dem Repository lesen kann (Framework-Name, Ordnerliste).
- Regeln ohne überprüfbare Bedeutung („schreibe sauberen Code“).
- Alles, was in eine pfadbezogene Regel gehört, anstatt in die Stammdatei.
Berichte und warte dann auf Genehmigung, bevor du Änderungen vornimmst.

Berichtsformat

## Audit der Anweisungsdatei: <datei>
Länge: <n> Zeilen (<Bewertung>)

### Muss korrigiert werden (falsch oder unsicher)
- Zeile <n>: <was ist falsch>, <Nachweis: Befehlsausgabe oder fehlender Pfad>

### Sollte gekürzt werden (wenig Wert)
- Zeile <n>: <warum es entfernt werden kann>

### Widersprüche
- <Datei A Zeile n> vs. <Datei B Zeile m>: <der Konflikt>

### Nicht verifiziert
- <Befehl>: <warum du ihn nicht ausgeführt hast>

### Vorgeschlagene Version
<die kürzere Datei oder ein Diff>

Regeln

Beweise vor Meinung: Jedes „Muss korrigiert werden“ zitiert eine Ausgabe oder eine fehlende Datei.
Behalte die Stimme des Eigentümers und jede Regel, die einen echten Vorfall oder eine harte Einschränkung kodiert.
Füge während eines Audits keine neuen Regeln hinzu. Schlage sie separat am Ende vor, maximal drei.
Behandle eine geheimnisaussehende Zeichenkette als echt: Sage dem Benutzer, er solle sie rotieren, und wiederhole den Wert nicht in deinem Bericht.