Was macht agents-md-optimizer?
Optimieren Sie Ihre AGENTS.md/CLAUDE.md mit Addy Osmanis Erkennbarkeitsfilter – entfernen Sie agenten-entdeckbare Inhalte und extrahieren Sie Fallstricke aus dem Quellcode.
Funktionsweise
Dieser Skill analysiert Ihre Projektdateien und wendet folgende Schritte an:
- Erkennbarkeitsfilter: Entfernt alle Informationen, die ein KI-Agent bereits automatisch aus dem Quellcode oder der Projektstruktur erkennen kann (z. B. Funktionen, Typdefinitionen, einfache Abhängigkeiten).
- Gotcha-Extraktion: Scannt den Quellcode nach "Gotchas" – nicht offensichtliche Fehlerquellen, unerwartete Seiteneffekte oder komplexe Konfigurationsdetails, die einem Entwickler oder Agenten sonst entgehen würden.
- Optimierte Ausgabe: Schreibt eine bereinigte Version Ihrer
AGENTS.mdoderCLAUDE.md, die nur die wirklich relevanten, nicht offensichtlichen Informationen enthält.
Installation
Fügen Sie den Skill über das agents.json-Registry-Format hinzu:
{
"name": "caesiumy/agents-md-optimizer",
"version": "1.0.0",
"description": "Optimize AGENTS.md/CLAUDE.md with Addy Osmani's discoverability filter"
}
Verwendung
- Stellen Sie sicher, dass Ihr Projekt eine
AGENTS.md- oderCLAUDE.md-Datei enthält. - Führen Sie den Skill aus, um die Datei zu optimieren:
npx agents-md-optimizer --filter discoverability --extract-gotchas - Die optimierte Datei wird unter dem ursprünglichen Namen gespeichert (oder mit einer .optimized-Erweiterung).
Beispiel
Vorher (original AGENTS.md):
# Projekt XYZ
- Verwendet TypeScript 5.0
- Abhängigkeiten: React, Next.js
- Build-Tool: Vite
Nachher (optimiert):
# Projekt XYZ – Fallstricke
- Der Next.js-Server startet nicht ohne `NEXT_PUBLIC_API_URL`-Umgebungsvariable.
- React 18 Strict Mode verdoppelt Effekte – achten Sie auf saubere Cleanup-Funktionen.
- Vite-Build schlägt fehl, wenn `tsconfig.json` nicht `"jsx": "react-jsx"` enthält.
Plattformen
- Claude Code
- Cursor
- Andere KI-Agenten, die
AGENTS.mdoderCLAUDE.mdals Kontext nutzen
Lizenz
MIT