lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

skill intermedio claude-coderepositorioscontexto

Filetree: un índice del repositorio que detecta cambios

Orienta a tu agente con descripciones breves por archivo y detecta cuándo ese mapa ha quedado desactualizado.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: comprueba los requisitos

Comprueba que puedes abrir Claude Code y ejecutar Git y python3 ≥3.9. El plugin invoca python3, no python. Elige si guardarás el índice en Git o usarás el modo personal antes de inicializarlo.

Paso 2: instalación según el README

/plugin marketplace add nekocode/filetree-skill
/plugin install filetree

Comprobación

Ejecuta los comandos anteriores dentro de Claude Code. Después usa /filetree:init y revisa las descripciones propuestas. Ejecuta /filetree:lint, cambia un archivo de prueba y comprueba que detecta el desfase antes de /filetree:update.

Si algo falla

Si faltan archivos, revisa exclusiones y la configuración .filetree.json. El modo self-only rechaza entregables ya seguidos por Git; consulta su sección antes de cambiar el seguimiento.

Procedimiento oficial.

ver en .md ¿Prefieres el recurso entero?

Qué es

Filetree es un plugin de Claude Code que mantiene FILETREE.md. Las descripciones explican la función de cada archivo y un archivo auxiliar de hashes permite detectar cambios sin pedir al modelo otra lectura completa.

Para qué te sirve

  • Cuando cada sesión repite la exploración de carpetas.
  • Cuando necesitas descubrir descripciones que ya no corresponden al código.
  • Cuando quieres compartir un mapa del proyecto revisable en Git.

Cómo funciona

init crea el índice; update incorpora altas, cambios, bajas y renombrados. lint compara el estado sin llamar al modelo. La configuración permite excluir archivos y elegir la ruta del manifiesto. Existe un modo personal que mantiene los entregables fuera del seguimiento.

Antes de empezar

Claude Code, Git y Python 3.9 o posterior. El README indica que usa la biblioteca estándar de Python. Decide si el índice será compartido o personal antes de inicializarlo, y revisa las propuestas de cambios a CLAUDE.md o AGENTS.md.

Límites y alternativas

Los resúmenes pueden omitir contratos relevantes: abre el archivo antes de editar. Un hash detecta cambios, pero no demuestra que la descripción sea correcta. Para un repositorio pequeño, un README con un mapa manual puede resolver la misma orientación.

Recursos