agnix
Lint-Agent-Konfigurationen, bevor sie Ihren Workflow unterbrechen. Validiert Skills, Hooks, MCP, Memory und Plugins für Claude Code, Cursor, GitHub Copilot und Codex CLI.
Verwendung
Aufrufen, wenn Benutzer Folgendes verlangt:
- „Lint meine Agent-Konfigurationen“
- „Validiere meine Skills“
- „Prüfe meine CLAUDE.md“
- „Validiere Hooks“
- „Lint MCP-Konfigurationen“
- „Behebe Probleme in der Agent-Konfiguration“
Unterstützte Dateien
| Dateityp | Beispiele |
|---|---|
| Skills | SKILL.md |
| Memory | CLAUDE.md, AGENTS.md |
| Hooks | .claude/settings.json |
| MCP | *.mcp.json |
| Cursor | .cursor/rules/*.mdc |
| Copilot | .github/copilot-instructions.md |
Ausführung
1. Prüfen, ob agnix installiert ist
agnix --version
Falls nicht gefunden, installieren:
cargo install agnix-cli
2. Validieren
agnix .
3. Falls Probleme gefunden und --fix angefordert wurde
agnix --fix .
4. Erneut validieren, um zu bestätigen
agnix .
CLI-Referenz
| Befehl | Beschreibung |
|---|---|
agnix . | Aktuelles Projekt validieren |
agnix --fix . | Probleme automatisch beheben |
agnix --strict . | Warnungen als Fehler behandeln |
agnix --target claude-code . | Nur Claude-Code-Regeln |
agnix --target cursor . | Nur Cursor-Regeln |
agnix --watch . | Überwachungsmodus |
agnix --format json . | JSON-Ausgabe |
Ausgabeformat
CLAUDE.md:15:1 warning: Generische Anweisung „Sei hilfreich“ [behebbar]
Hilfe: Entfernen Sie generische Anweisungen. Claude weiß das bereits.
skills/review/SKILL.md:3:1 error: Ungültiger Name [behebbar]
Hilfe: Verwenden Sie nur Kleinbuchstaben und Bindestriche
1 Fehler, 1 Warnung gefunden (2 behebbar)
Häufige Probleme und Korrekturen
| Problem | Lösung |
|---|---|
| Ungültiger Skill-Name | Verwenden Sie Kleinbuchstaben mit Bindestrichen: my-skill |
| Generische Anweisungen | Entfernen Sie „Sei hilfreich“, „Sei genau“ |
| Fehlende Auslösephrase | Fügen Sie „Verwenden, wenn...“ zur Beschreibung hinzu |
| Verzeichnis-/Namenskonflikt | Benennen Sie das Verzeichnis so um, dass es dem Feld name: entspricht |