Agentsmd Optimize

Audita un CLAUDE.md/AGENTS.md existente, verifica sus afirmaciones contra el repositorio y aplica las correcciones aprobadas

Por majiayu000 · majiayu000/spellbook

Probado · Funciona ★ 9.2/10

Agentsmd Optimize — Audita un CLAUDE.md/AGENTS.md existente, verifica sus afirmaciones contra el repositorio y aplica las correcciones aprobadas

Qué hace

Audita un archivo de instrucciones CLAUDE.md o AGENTS.md existente contra cinco patrones de estructura, verifica cada ruta y afirmación de comando contra el repositorio real (ls, package.json/Makefile), luego aplica las correcciones que el usuario aprueba in situ. Se activa cuando el usuario pide optimizar, limpiar o corregir su documento de agente (frases en inglés o chino como "优化 CLAUDE.md"), o cuando dice aplicar correcciones después de una auditoría. Marca los archivos referenciados faltantes en lugar de inventarlos y deja las regiones auto-generadas intactas.

Informe de la prueba

Se obtuvo el SKILL.md (prosa autocontenida, sin scripts) y se instaló en un HOME temporal — aterriza en ~/.claude/skills/agentsmd-optimize/SKILL.md, el frontmatter se analiza con name+description, y un grep no encontró indicios de curl|sh/base64/exfiltración. Para la prueba de salida, construí un CLAUDE.md desordenado (comandos incorrectos, un directorio application/ inexistente, una referencia routing-contract.md faltante) más un package.json real; la limpieza de la línea base mantuvo npm run start, yarn test, make build, el directorio obsoleto y la referencia rota textualmente, mientras que siguiendo la verificación del Paso 2 de la habilidad (comprobaciones de ls + package.json) detectó que ninguno existía y los corrigió a npm run dev/npm test/npm run build, eliminó el directorio obsoleto y marcó el archivo faltante en lugar de inventarlo. Existen dos artefactos (BASELINE_CLAUDE.md vs SKILL_CLAUDE.md) y la diferencia muestra la diferencia concreta de corrección.

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

Instalación

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.

Comandos y prompts de ejemplo

/agentsmd-optimizeAudita un CLAUDE.md/AGENTS.md existente, verifica sus afirmaciones contra el repositorio y aplica las correcciones aprobadas

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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

Informe completo →