doc-organizer

Installation
SKILL.md

Doc Organizer

Skill para organizar y categorizar documentos tecnicos existentes en la estructura correcta del proyecto.

Proceso de Organizacion

Paso 1: Inspeccionar estado actual

Usar Glob para encontrar archivos markdown:

  • docs/*.md para archivos sueltos en raiz de docs
  • docs/**/*.md para todos los archivos incluyendo subcarpetas

Verificar carpetas existentes con ls docs/*/.

Paso 2: Preguntar por categorias

Presentar al usuario las categorias existentes detectadas, mas estas sugeridas si no existen:

Categoria Uso
specs/ Especificaciones de features/sistemas
planning/ Planes de implementacion activos
archive/ Documentos completados o superseded
architecture/ ADRs, decisiones arquitectonicas
reference/ Documentacion tecnica de referencia

Preguntar al usuario cuales quiere usar.

Paso 3: Analizar documentos y sugerir categorizacion

Para cada documento encontrado:

  1. Leer contenido (primeras ~50 lineas)
  2. Detectar tipo por keywords:
Keywords detectados Categoria sugerida
"ADR", "Decision", "Status: Accepted/Proposed", "Context", "Consequences" architecture/
"Specification", "Requirements", "Spec", "Technical Approach" specs/
"Plan", "Implementation", "Steps", "Timeline", "Goal" planning/
"Reference", "Guide", "How to", "Examples", "Usage" reference/
  1. Presentar analisis al usuario: para cada archivo, mostrar keywords detectados, categoria sugerida, y pedir confirmacion antes de mover. El usuario puede aprobar, rechazar, o elegir otra categoria para cada archivo.

Paso 4: Ejecutar reorganizacion

Para cada documento confirmado:

  1. Crear carpeta destino si no existe: mkdir -p docs/<categoria>/
  2. Mover archivo preservando historial git: git mv docs/<archivo>.md docs/<categoria>/<archivo>.md
  3. Opcionalmente renombrar al formato estandar (preguntar al usuario primero):
    • Formato: YYYY-MM-DD-<name>.md
    • Excepcion: ADRs usan NNNN-<name>.md

Paso 5: Resumen final

Mostrar resultado: cuantos archivos por categoria, lista de archivos reorganizados, y archivos que quedaron sin categorizar (si los hay).

Related skills

More from testacode/llm-toolkit

Installs
28
First Seen
Jan 23, 2026