Stats
Actions
Tags
From agent-docs
Comprehensive scored review of all agent docs (CLAUDE.md/AGENTS.md plus rules directories) with bidirectional claim verification, coverage sweep, paths-glob validation and prune-sweep. Manual-only — invoke via /agent-docs:audit. Optional args — subtree path; `solo` runs without subagents; `quick` skips scoring and coverage (red flags + below-B list only).
How this skill is triggered — by the user, by Claude, or both
Slash command
/agent-docs:audit [pfad] [solo] [quick][pfad] [solo] [quick]This skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Comprehensive Review aller Agent-Docs mit Scoring. Teuer und tokenintensiv — läuft nur auf expliziten Befehl.
Comprehensive Review aller Agent-Docs mit Scoring. Teuer und tokenintensiv — läuft nur auf expliziten Befehl.
Zuerst lesen: ${CLAUDE_SKILL_DIR}/../../references/shared.md (Scope, Ground Rules, Subagenten, Vorschlags-Format, Verify, Anti-Patterns) und ${CLAUDE_SKILL_DIR}/../../references/style.md (Qualitätsmaßstab). Für Schritt 1e: ${CLAUDE_SKILL_DIR}/../../references/prune-sweep.md.
$ARGUMENTS — alle optional, kombinierbar:
solo → keine Subagenten; dieselben Aufträge inline sequenziell (gilt automatisch, wenn die Umgebung keine Subagenten kann).quick → Spar-Variante: Claim-Verifikation, Link-/Glob-Checks und Duplikat-Scan laufen, aber kein 6-Kriterien-Scoring, keine Per-File-Tabellen, kein Coverage-Sweep. Report = Red Flags + Below-B-Verdachtsliste (1 Zeile pro Datei) + Fix-Proposals nur für Red Flags.Discovery. Glob alle Scopes (laut shared.md). Parallel Subagenten (~1 pro 3–5 Files, Output-Format laut shared.md festnageln). Auftrag:
"Verifiziere jeden Claim beidseitig (Doku→Code UND Code→Doku) via Grep/Read. Output:
{file, line, claim, verified|stale|wrong|missing|duplicate|generic, evidence}. Bei Unsicherheitneeds verificationstatt raten."
Plus separate Sweeps (je 1 Subagent):
quick) — non-triviale Code-Bereiche mit 0 Doc-Coverage. Kriterium "kritisch": Ein neuer Agent würde dort ohne Doku falsche Annahmen treffen oder lange suchen (non-obvious Invariants, Sicherheits-relevantes, überraschende Kopplungen, CI/Deploy-Pipelines, Test-Harnesses, Polyfills/Side-Effect-Imports, nicht-offensichtliche Datenformate). Triviale CRUD-Bereiche zählen NICHT.paths:-Validierung — Verdicts: ok|dead|too-broad|too-narrow mit Beispiel-Treffern bzw. fehlenden erwarteten Treffern. Typische too-narrow-Lücke: Test-Suiten + Lib-Helfer.Scoring pro File (s.u.). Entfällt bei quick.
Report ausgeben (Template s.u.; bei quick nur Summary-Zeile, Red Flags und Below-B-Verdachtsliste).
Fix-Proposals für alle material Issues im Format laut shared.md; Files < B priorisieren (bei quick: nur Red Flags). Keine kosmetischen Vorschläge.
Approval-Gate. Stop, auf User-Freigabe warten.
Verify. Laut shared.md; betroffene Files re-scoren (bei quick nur Link-/Glob-Verify).
| Kriterium | Gewicht | Voller Score = |
|---|---|---|
| Accuracy | 25 | Pfade, Namen, Commands, beschriebene Behavior matchen Code. |
| Completeness | 20 | Repo-spezifische, non-obvious Invariants vollständig. |
| Conciseness | 20 | Keine Generics, kein Source-Duplikat, nichts Selbstverständliches, kein Cross-File-Duplikat. |
| Actionability | 15 | Neue Session kann ohne Code-Reread arbeiten. |
| Currency | 10 | Keine stale Refs, dead Links, removed/renamed Code. |
| Cross-references | 10 | Interne Links resolven, keine Duplikation zwischen Files. |
Grades: A 90+, B 70+, C 50+, D 30+, F <30. Brevity ≠ Fail. Bloated ≠ Pass. Akkurates Signal > Score-Padding.
## Documentation Audit
**Summary:** N audited · A:x B:x C:x D:x F:x · Below-B: x · Undocumented: x · Duplikate: x · Prune-Kandidaten: x
**Red Flags**
- <path:line> — <flag>: <stale-path|broken-link|wrong-behavior|duplicate|contradicts-<file>|security-mismatch|undocumented-critical>
**Per-File**
### <path> — XX/100 (X)
| Acc | Comp | Conc | Act | Curr | Cross | Notes |
|---:|---:|---:|---:|---:|---:|---|
| X/25 | X/20 | X/20 | X/15 | X/10 | X/10 | <kurz> |
Issues:
- <doc:line> — <was falsch> — Evidence: <code:line>
**Undocumented Areas**
- <code path> — <Warum kritisch> — <wo dokumentieren (Datei + Sektion)>
**Nebenbefunde (Code, nicht Doku)**
- <code:line> — <Befund>
A-Files: One-Liner statt Tabelle.
npx claudepluginhub xuoon/skills --plugin agent-docsCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.