SkillProof tested Claude skills

Claude MD Updater

Convierte los hallazgos de la sesión en un diff CLAUDE.md revisable, filtrando notas transitorias

Por jamditis · jamditis/claude-skills-journalism

Probado · Funciona ★ 8.4/10

Claude MD Updater — Convierte los hallazgos de la sesión en un diff CLAUDE.md revisable, filtrando notas transitorias

Qué hace

Escanea la conversación actual en busca de hechos duraderos —causas raíz encontradas durante la depuración, nuevos endpoints y rutas, comandos recurrentes— y los propone como un diff unificado contra el CLAUDE.md del proyecto, sin escribir nada hasta su aprobación. Se activa con "update claude.md", "save this lesson", "what should we remember" o "add to context". Sus reglas también mantienen las notas específicas de la sesión, las peculiaridades del entorno personal y los valores de las credenciales fuera del archivo comprometido con git, dirigiéndolos a la memoria automática o a CLAUDE.local.md.

Informe de la prueba

Cloné el repositorio y lo instalé en un HOME temporal; SKILL.md aterrizó en ~/.claude/skills/claude-md-updater/SKILL.md, el frontmatter tiene name+description, el cuerpo tiene 97 líneas sin referencias a scripts o archivos y sin curl|sh, base64 o texto de inyección. Prueba de salida: escribí un CLAUDE.md de prueba para un "ledger service" de Rails más una transcripción de sesión condensada que contenía cuatro elementos (una causa raíz de OOM, un nuevo entorno de vista previa cuya línea de transcripción incluía una contraseña de DB literal, una nota personal "I run Ruby 3.2 not 3.3", y una nota "this test was flaky but passed on 3 reruns"), luego produje una actualización de línea base y una actualización seguida por la habilidad. La línea base reescribió todo el archivo, inventó una sección "## Notes" que contenía tanto la versión de Ruby como las líneas de prueba inestables, y llevó el secreto literal como 'entry "ledger-preview-db" (hunter2-preview-9981)'; la versión de la habilidad emitió un diff unificado que afectaba solo a tres secciones, terminó con "Apply this diff? Nothing is written until you approve.", escribió la credencial como 'entry "ledger-preview-db"' sin valor, y listó explícitamente los dos elementos transitorios como excluidos con un destino para cada uno. Advertencia que declararé claramente: fui el autor de ambos artefactos, por lo que la línea base es mi mejor estimación honesta del comportamiento no guiado en lugar de una ejecución ciega — los deltas de notas transitorias excluidas y diff vs reescritura completa son sólidos, el traspaso de la contraseña es plausible pero discutible. Frases de activación juzgadas: DEBERÍA activarse — "Update CLAUDE.md with what we learned in this session" (sí), "Save this lesson so future sessions don't repeat it, add it to our project context file" (sí), "What should we remember from today's debugging? Persist it" (sí); NO DEBERÍA activarse — "Read CLAUDE.md and tell me what build command this project uses" (correctamente no, solo lectura), "Summarize what we did this session for my standup notes" (correctamente no, sin objetivo de persistencia). 5/5.

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

Instalación

git clone --depth 1 https://github.com/jamditis/claude-skills-journalism.git /tmp/claude-md-updater-src
mkdir -p ~/.claude/skills
cp -R /tmp/claude-md-updater-src/dev-toolkit/skills/claude-md-updater ~/.claude/skills/claude-md-updater
# Single SKILL.md, no scripts, no dependencies, no API keys.
# Plugin alternative: the repo ships a marketplace (.claude-plugin/marketplace.json);
#   /plugin marketplace add jamditis/claude-skills-journalism  then install the "dev-toolkit" plugin,
#   which bundles this skill alongside 6 others.
# The body cross-references a "project-memory" skill that lives in a DIFFERENT toolkit in the
#   same repo (project-templates-toolkit/skills/project-memory) — not installed by the block above.

Comandos y prompts de ejemplo

  • /claude-md-updaterConvierte los hallazgos de la sesión en un diff CLAUDE.md revisable, filtrando notas transitorias

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

  • Update CLAUDE.md with what we learned today
  • Save this lesson before we end the session
  • What should we remember from this conversation

Informe completo →