Handoff que guarda en archivo antes del /clear, /prime para retomar, checkpoint en medio del trabajo y auditoría de la memoria. Cada una con un solo trabajo, en PT y EN.

skillmanager3x es un conjunto de skills (instrucciones listas en archivos de texto) para quienes usan Claude Code y trabajan en sesiones largas. Resuelven el problema de perder el hilo cuando la conversación se llena: session-handoff guarda el estado en un archivo, tú limpias con /clear y prime retoma leyendo ese archivo. Además hay un checkpoint rápido, una auditoría de la memoria y una barra de estado. Para usarlas, basta copiar las carpetas a ~/.claude/skills.
No hay build, dependencias ni código ejecutable. Cada skill es una carpeta con un SKILL.md (markdown + frontmatter YAML) que Claude Code carga cuando dices uno de los gatillos.
Pasa la posta antes del /clear o del cambio de agente. Muestra en el chat y guarda en handoffs/history/<UTC>.md + handoffs/latest.md, con la próxima acción exacta, verificación real y revisión de secretos.
El par del handoff: al inicio de la sesión lee CLAUDE.md/AGENTS.md, context/, tasks/ y handoffs/latest.md y devuelve un briefing corto. Solo lee; no retoma deploys ni envíos por su cuenta.
Checkpoint rápido durante el trabajo: foco actual, qué fue a la memoria, decisiones recientes, próximos pasos y una recomendación (continuar, compactar, auditar, handoff o limpiar).
Inventario de lo que hay en ~/.claude/projects/<proyecto>/memory/ y en CLAUDE.md. Separa el hecho duradero (se mantiene) del estado de corto plazo (se descarta) y del ruido (se elimina).
Regla de bolsillo: fin de sesión → handoff. "¿Cómo vamos?" → statusline. "¿Qué hay en la memoria?" → audit. Hablas en lenguaje natural, el harness lo compara con la description del frontmatter y carga la skill correcta.
"handoff", "vou dar /clear", "encerrar sessão", "passar para outro agente", "wrap up", "resumo final antes de limpar".
"prime", "retoma", "continua de onde parou", "lê o handoff", o al entrar en un proyecto con handoffs/latest.md.
"statusline", "checkpoint", "onde estamos", "como está a sessão", "próximos passos", "organiza/otimiza a sessão".
"analise a memória", "analise CLAUDE.md", "o que foi guardado", "memória inchada", "limpa memória".
Cuando el contexto se llena o la sesión ya se compactó, no insistas con la misma conversación. Guarda el estado en un archivo, limpia y empieza de nuevo leyendo ese archivo. Es el proceso que recomendamos para cualquier trabajo largo, en Claude Code y en Codex.
Escribe lo que se hizo, lo que está en curso, la próxima acción exacta y lo que depende del humano, sin secretos. Guarda un archivo nuevo en handoffs/history/<fecha-UTC>.md (nunca sobrescribe) y actualiza handoffs/latest.md.
Empieza de cero: contexto vacío, sin el peso de las compactaciones. No se pierde nada, porque el estado está en el archivo. En Codex, abre una sesión nueva.
Antes de actuar, lee AGENTS.md/CLAUDE.md, context/, tasks/current.md y handoffs/latest.md y devuelve un briefing corto: objetivo, regla principal con fuente, última decisión, próxima acción y conflictos. Solo lee: no retoma publicaciones, deploys ni envíos por su cuenta.
Versión antigua (solo chat), la que este repositorio traía hasta oct/2026 y que circula en otros kits: muestra el resumen en la conversación y no guarda nada. Al dar /clear, el resumen se va junto, a menos que lo copies a mano, y /prime no encuentra qué leer.
Versión actual (guarda en archivo), la que está ahora en skill/pt y skill/en, igual a la del kit agente-claude-codex 1.5.2: muestra en el chat y guarda en handoffs/ mediante el script handoff-grava.py, con latest.md como índice de los trabajos abiertos (el mismo formato que lee el hook de Ejecución Larga); crea la carpeta si el proyecto solo tiene CLAUDE.md.
# 0 = versión solo chat; 1 o más = guarda en handoffs/ grep -c "handoffs/history" ~/.claude/skills/session-handoff/SKILL.md # cambiar por la versión que guarda (e instalar el par prime) cp -r skill/pt/session-handoff skill/pt/prime ~/.claude/skills/
Este ciclo es la base del proyecto Ejecución Larga, el método para agentes que trabajan horas o días (/goal, archivos de estado, límites y criterio de listo). Allí está el hook que mide el contexto y guarda el handoff solo en ~70% y ~85% y justo después de una compactación, mientras el caché aún está caliente; tú solo das /clear y /prime. También están la investigación detrás de las franjas de contexto y el recall para buscar en todo lo que ya se ha dicho.
Si ya usas Claude Code, estás listo. No hay instalación de paquetes, runtime ni servicio en línea.
El CLI de Anthropic, con soporte de skills (la carpeta skills/ se recorre al iniciar).
# verificar que está instalado claude --version
Clónalo (o descárgalo) — las skills son solo archivos de texto.
git clone https://github.com/inematds/skillmanager3x cd skillmanager3x
Global (todas las sesiones) o por proyecto. Créala si no existe.
# global mkdir -p ~/.claude/skills
Cinco pasos. El más largo toma un minuto.
Las skills viven en skill/pt/ y skill/en/ — misma estructura en los dos idiomas.
git clone https://github.com/inematds/skillmanager3x cd skillmanager3x
No hay versión en español de las skills: usa skill/pt o skill/en. Los campos name y description quedan en inglés en las dos versiones (para un triggering consistente del harness), pero la description de pt/ incluye gatillos en portugués. Puedes seguir hablando en español: el agente entiende la intención.
ls skill/pt # session-handoff prime session-statusline memory-audit ls skill/en # misma estructura, textos en inglés
Copia la carpeta completa de cada skill — con el SKILL.md dentro. No aplanes la estructura.
# global — vale en todas las sesiones mkdir -p ~/.claude/skills cp -r skill/pt/session-handoff ~/.claude/skills/ cp -r skill/pt/prime ~/.claude/skills/ cp -r skill/pt/session-statusline ~/.claude/skills/ cp -r skill/pt/memory-audit ~/.claude/skills/ # o por proyecto cp -r skill/pt/session-handoff <proyecto>/.claude/skills/
En Claude Code, lista las skills disponibles. Las cuatro deben aparecer.
/skills # session-handoff · prime · session-statusline · memory-audit
No necesitas memorizar comandos — habla de forma natural y entra la skill correcta.
# fin de sesión: guarda handoffs/latest.md, después /clear voy a hacer /clear, haz el handoff antes # sesión nueva: lee el handoff y resume /prime # en medio del trabajo statusline # revisar la memoria analiza la memoria del proyecto, está desordenada
Tres formatos, tres propósitos. Todo sale en el chat; solo el handoff además guarda en handoffs/, de donde lee prime.
Guardado en handoffs/history/2026-10-13T014500Z.md y copiado a handoffs/latest.md.
# Handoff — 2026-10-13 — refactorización del middleware de auth ## Estado aceptado - [confirmed] auth/jwt_validator.py extraído de middleware.py:45-180 ## Propuesto / intentado, no confirmado - [unverified] caché de claves públicas TTL 5min — sin prueba - [?] migración v1→v2 — el usuario quería revisar antes ## Verificación - Ejecutado: `pytest tests/auth` → 12 passed ## Estado en ejecución - Procesos en segundo plano: shell_a3f → pytest --watch ## Próxima acción exacta Revisar si la migración v1→v2 entra ahora (necesita el ok del usuario).
Termina siempre con una Recomendación: qué skill (o ninguna) tiene sentido a continuación.
# Statusline ## Estado - Foco actual: ajustar paginación del endpoint /users - Contexto: moderado - Riesgo: sin prueba de carga con >10k registros ## Qué quedó guardado en la memoria - Guardado confirmado: none - Candidatos: prefiere keyset sobre offset ## Próximos pasos 1. Ejecutar prueba con 50k registros 2. Actualizar OpenAPI schema ## Recomendación continuar
La salida es recomendación, no ejecución. Si quieres aplicar los cortes, pídelo en una segunda etapa: "ok, aplica eso".
# Memory Audit ## Mantener (hechos duraderos) - user_role.md → el usuario es ing. backend Go, nuevo en React - feedback_testing.md → pruebas de integración en Postgres real (incidente Q3/2025) ## Considerar mover a CLAUDE.md - project_auth_rewrite.md → motivación (compliance) — vale en la doc del proyecto ## Eliminar (corto plazo / ruido) - session_2026-04-15.md → estado de sesión antigua - bug_fix_recipe_xyz.md → fix ya aplicado, el código habla por sí solo ## Puntos de atención - Duplicación: feedback_pr_size.md y feedback_review_style.md - Obsoleto: reference_grafana.md apunta a un dashboard que cambió de URL
Además de las tres skills, el repo trae una statusline para Claude Code: la línea fija bajo el input, con directorio, modelo, esfuerzo, contexto restante y cuánto de tu límite ya se fue. Un comando para instalar.
# lo que aparece en la terminal nei@maquina:~/projetos/wifi Opus 5/low ctx 10% 5h:24%→00:10 w:29%→10/08 21:00 d:109.6M
user@host:cwd más Opus 5/low — el modelo y el nivel de esfuerzo de la sesión, siguiendo lo que elegiste en /model.
ctx 10% — cuánto de la ventana ya se usó. Es el número que dice si se puede continuar o si es hora de un handoff.
5h:24%→00:10 y w:29%→10/08 21:00 — uso y hora de reinicio de las ventanas de 5 horas y semanal. d:109.6M son los tokens del día.
El script copia la statusline a ~/.claude/ y registra el bloque statusLine en tu settings.json — preservando el resto del archivo, con backup .bak.
git clone https://github.com/inematds/skillmanager3x bash skillmanager3x/statusline-cmd/install.sh
El instalador imprime la línea ya armada con tus datos. Aparece en el próximo render de Claude Code — no hace falta reiniciar ninguna sesión.
# dependencias, si falta alguna sudo apt install jq curl python3
El desinstalador elimina solo la clave statusLine del settings.json; el resto de tus configuraciones queda intacto.
bash statusline-cmd/install.sh --uninstall
Los porcentajes de 5h y semana vienen del endpoint de uso de Anthropic usando tus propias credenciales (~/.claude/.credentials.json) — ningún token va en el repositorio. Detalles, campos disponibles y cómo personalizar: statusline-cmd/README.md (en portugués).
Nombres parecidos, cosas distintas: la skill session-statusline escribe un checkpoint en texto cuando lo pides; la carpeta statusline-cmd instala la barra fija de la terminal.
El proyecto es pequeño a propósito: skills disjuntas, sin superposición de gatillos.
SKILL.md completo en los dos idiomas y READMEs detallados en skill/en/ y skill/pt/ que cubren las decisiones de diseño.session-handoff pasó a guardar en handoffs/history/ + handoffs/latest.md (misma versión del kit agente-claude-codex, hoy 1.5.2) y entró prime, que lee ese archivo en la sesión nueva. Ciclo completo: handoff → /clear → /prime./goal para trabajo de horas: guía Ejecución Larga.