Agentsmd Optimize

Prüft eine CLAUDE.md/AGENTS.md, verifiziert deren Behauptungen gegen das Repo und wendet genehmigte Korrekturen an

von majiayu000 · majiayu000/spellbook

Getestet · Funktioniert ★ 9.2/10

Agentsmd Optimize — Prüft eine CLAUDE.md/AGENTS.md, verifiziert deren Behauptungen gegen das Repo und wendet genehmigte Korrekturen an

Was es kann

Prüft eine bestehende CLAUDE.md- oder AGENTS.md-Anweisungsdatei anhand von fünf Strukturmustern, verifiziert jeden Pfad und jede Befehlsbehauptung gegen das reale Repo (ls, package.json/Makefile) und wendet dann die vom Benutzer genehmigten Korrekturen direkt an. Wird ausgelöst, wenn der Benutzer bittet, seine Agenten-Dokumentation zu optimieren, zu bereinigen oder zu reparieren (englische oder chinesische Formulierungen wie „优化 CLAUDE.md“), oder wenn er nach einer Prüfung die Anwendung von Korrekturen verlangt. Kennzeichnet fehlende referenzierte Dateien, anstatt sie zu erfinden, und lässt automatisch generierte Bereiche unberührt.

Testbericht

Die SKILL.md (eigenständige Prosa, keine Skripte) abgerufen und in ein temporäres HOME installiert — sie landet unter ~/.claude/skills/agentsmd-optimize/SKILL.md, Frontmatter parst mit name+description, und ein grep fand keine curl|sh/base64/exfiltration-Gerüche. Für den Output-Test erstellte ich eine unordentliche CLAUDE.md (falsche Befehle, ein nicht existierendes application/-Verzeichnis, eine fehlende routing-contract.md-Referenz) plus eine echte package.json; die Baseline-Bereinigung behielt npm run start, yarn test, make build, das veraltete Verzeichnis und die defekte Referenz wortwörtlich bei, während die Skill-Verifizierung von Schritt 2 (ls + package.json-Prüfungen) feststellte, dass keine existieren, und sie zu npm run dev/npm test/npm run build korrigierte, das veraltete Verzeichnis löschte und die fehlende Datei kennzeichnete, anstatt sie zu erfinden. Zwei Artefakte (BASELINE_CLAUDE.md vs SKILL_CLAUDE.md) existieren und der Diff zeigt den konkreten Korrektheitsunterschied.

Getestet am: 2026-07-31 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/majiayu000/spellbook.git /tmp/agentsmd-optimize-src
mkdir -p ~/.claude/skills
cp -R /tmp/agentsmd-optimize-src/skills/agentsmd-optimize ~/.claude/skills/agentsmd-optimize
# Single self-contained SKILL.md, no external deps or scripts.
# Sibling skill referenced in the body: skills/agentsmd-audit (audit-only). Copy it too if you want both.
# Rule codes it cites (SEC-13, W-17, U-32) are the author's own global ruleset, not required to use the skill.

Befehle & Beispiel-Prompts

  • /agentsmd-optimizePrüft eine CLAUDE.md/AGENTS.md, verifiziert deren Behauptungen gegen das Repo und wendet genehmigte Korrekturen an

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • Optimize my CLAUDE.md instruction file
  • Score my AGENTS.md against best practices
  • Apply the recommended fixes to my agent doc