Agent-Skills.md

Agent Skills: Doc Organizer

Este skill se usa cuando el usuario pide "organizar docs", "ordenar documentacion", "mover documentos a carpetas", "categorizar archivos md", "reorganizar documentacion", o cuando hay archivos .md sueltos en docs/ que necesitan ser movidos a subcarpetas tematicas. Organiza y categoriza documentos tecnicos en la estructura correcta del proyecto.

UncategorizedID: testacode/llm-toolkit/doc-organizer

Repository

testacode/llm-toolkit
testacodeLicense: Apache-2.0

Install this agent skill to your local

pnpm dlx add-skill https://github.com/testacode/llm-toolkit/tree/HEAD/skills/doc-organizer

Skill Files

Browse the full folder contents for doc-organizer.

Download Skill

Loading file tree…

skills/doc-organizer/SKILL.md

Skill Metadata

Name
doc-organizer
Description
Este skill se usa cuando el usuario pide "organizar docs", "ordenar documentacion", "mover documentos a carpetas", "categorizar archivos md", "reorganizar documentacion", o cuando hay archivos .md sueltos en docs/ que necesitan ser movidos a subcarpetas tematicas. Organiza y categoriza documentos tecnicos en la estructura correcta del proyecto.

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).