Agentsmd Optimize

Audytuje CLAUDE.md/AGENTS.md, weryfikuje jego twierdzenia wobec repozytorium i stosuje zatwierdzone poprawki

Autor: majiayu000 · majiayu000/spellbook

Testowano · Działa ★ 9.2/10

Agentsmd Optimize — Audytuje CLAUDE.md/AGENTS.md, weryfikuje jego twierdzenia wobec repozytorium i stosuje zatwierdzone poprawki

Co robi ten skill

Audytuje istniejący plik instrukcji CLAUDE.md lub AGENTS.md pod kątem pięciu wzorców struktury, weryfikuje każdą ścieżkę i twierdzenie o komendzie wobec rzeczywistego repozytorium (ls, package.json/Makefile), a następnie stosuje poprawki zatwierdzone przez użytkownika na miejscu. Uruchamia się, gdy użytkownik prosi o optymalizację, uporządkowanie lub naprawienie dokumentacji agenta (frazy angielskie lub chińskie, takie jak "优化 CLAUDE.md"), lub gdy mówi, aby zastosować poprawki po audycie. Oznacza brakujące referencyjne pliki zamiast je wymyślać i pozostawia regiony auto-generowane nietknięte.

Raport z testu

Pobrano SKILL.md (samodzielna proza, brak scripts) i zainstalowano do temp HOME — ląduje pod ~/.claude/skills/agentsmd-optimize/SKILL.md, frontmatter parsował z name+description, a grep nie znalazł curl|sh/base64/exfiltration smells. Dla testu output zbudowałem nieuporządkowany CLAUDE.md (błędne komendy, nieistniejący katalog application/, brakujący routing-contract.md ref) plus rzeczywisty package.json; czyszczenie baseline zachowało npm run start, yarn test, make build, przestarzały katalog i uszkodzony ref verbatim, podczas gdy weryfikacja Step 2 umiejętności (ls + package.json checks) wykryła, że żadne z nich nie istnieją i poprawiła je na npm run dev/npm test/npm run build, usunęła przestarzały katalog i oznaczyła brakujący plik zamiast go wymyślać. Istnieją dwa artefakty (BASELINE_CLAUDE.md vs SKILL_CLAUDE.md), a diff pokazuje konkretną różnicę w poprawności.

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

Instalacja

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.

Komendy i przykładowe prompty

/agentsmd-optimizeAudytuje CLAUDE.md/AGENTS.md, weryfikuje jego twierdzenia wobec repozytorium i stosuje zatwierdzone poprawki

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →