spec-kit-template: Skill for Claude Code

SKILL: export-docx (Markdown → DOCX)

Propósito

Exportar documentación Markdown del repo a DOCX usando el script:

python tools/export_docx.py

Permite elegir alcance (scope) y opciones de formato, sin modificar docs/**.

---

Cuándo usarlo

• Compartir documentación con terceros en formato Word.
• Entregables fuera del repositorio (auditorías, stakeholders, etc.).
• Revisiones donde DOCX sea requisito.

---

Alcances soportados (scope)

Scopes soportados por el script (no inventar):

• spec → docs/spec/** (excluye docs/spec/history/** por defecto)
• kit → docs/kit/**
• all → docs/** (excluye docs/spec/history/** por defecto)

Nota: existe --include-history para incluir docs/spec/history/** solo en spec o all.

---

Entrada que debes pedir al usuario

1. scope: spec | kit | all (default recomendado: spec)
2. output: ruta del .docx (default recomendado: exports/spec.docx)
3. title (opcional)
4. toc: sí/no (default recomendado: no)
5. page breaks: sí/no
   • Por defecto el script inserta saltos de página entre secciones.
   • Para desactivarlo: --no-page-break
6. include-history: sí/no (solo útil en spec o all; default: no)

---

Requisitos previos (siempre)

1. Estar en la raíz del repo (debe existir docs/)
2. Pandoc disponible en PATH:
   • comprobar: pandoc --version
3. Si existe mkdocs.yml con nav: (para respetar orden):
   • instalar PyYAML: python -m pip install pyyaml

---

Reglas duras

• NO modificar docs/** (solo lectura).
• Output recomendado en exports/.
• No inventar flags: el script soporta exactamente:
  • --scope {spec,kit,all}
  • --output <ruta.docx>
  • --title "<título>"
  • --toc
  • --no-page-break
  • --include-history

---

Orden de documentos (cómo funciona)

• Si existe mkdocs.yml con nav:, el script usa ese orden (requiere PyYAML).
• Si no existe mkdocs.yml o no hay nav, usa un orden fallback por convención.